advanced research

Brand Voice Linter

Analyze all copy in your codebase against your brand voice guidelines and flag inconsistencies — like ESLint for your marketing tone.

Works with: claude-code
View source

Scan every piece of customer-facing copy in your project — page titles, descriptions, button text, error messages, blog posts — and check it against your brand voice guidelines. Claude Code reads your style guide, then audits your entire codebase for tone drift.

What Makes This a Claude Code Skill

This skill reads a brand voice reference file from your project, uses Glob and Grep to find all customer-facing strings, and writes a detailed report with specific file paths, line numbers, and rewrite suggestions. It works like a linter for prose.

Inspired by the copywriting skill from coreyhaines31/marketingskills and the brand-voice context files from TheCraigHewitt/seomachine.

Prerequisites

Create a brand voice file at .claude/brand-voice.md in your project:

# Brand Voice Guidelines

## Tone
- Confident but not arrogant
- Conversational, like talking to a smart friend

## Language Rules
- Use "you" and "your" (second person)
- Active voice always
- Short sentences (under 20 words preferred)
- Never say: "leverage", "synergy", "cutting-edge", "world-class"

## Examples
- Good: "Build your site in minutes"
- Bad: "Leverage our cutting-edge platform"

Setup

Create .claude/commands/voice-lint.md:

Analyze all customer-facing copy in this project for brand voice consistency.

## Steps

1. Read brand voice guidelines from `.claude/brand-voice.md` — stop if missing
2. Glob for all content and UI files: `src/**/*.md`, `src/**/*.astro`, `src/**/*.tsx`
3. For each file, extract customer-facing text: headings, paragraphs, buttons, meta descriptions
4. Check against guidelines: banned words, passive voice, sentence length, tone drift
5. Write report to `./voice-lint-report.md` with:
   - Summary score (percentage passing)
   - Issues grouped by severity
   - For each: file path, line number, offending text, suggested rewrite
6. Print summary stats to terminal

Usage

/project:voice-lint

Claude scans your codebase and produces voice-lint-report.md with every brand voice violation flagged.

Tips

  • Run before launches or major content pushes
  • The quality depends on how detailed your .claude/brand-voice.md is
  • Pair with the SEO Content Audit for a comprehensive pre-launch review