seo-brand-voice

Brand Voice Manager

Create, store, and enforce brand voice and editorial guidelines across all content.

Invocation

/seo-brand-voice create
/seo-brand-voice check <file.md>
/seo-brand-voice update

Three Modes

1. CREATE -- Interactive Brand Voice Wizard

Launches a guided questionnaire to build a complete brand voice profile:

1. Brand Identity -- Name, tagline, mission statement
2. Tone Selection -- Choose primary + secondary tones
3. Audience Definition -- Who they are, what they know, what they need
4. Vocabulary Rules -- Preferred terms, banned words, jargon policy
5. Style Rules -- Sentence length, paragraph style, formatting
6. Content Rules -- Citations, CTAs, humor, examples
7. SEO Voice -- How to integrate keywords naturally

Output: Saves brand-voice.md in the project root.

2. CHECK -- Audit a Draft Against Brand Voice

Reads the brand voice profile and analyzes a draft article for compliance:

/seo-brand-voice check draft-article.md

Output format:

• Compliance score: X/100
• Tone analysis: Does the tone match the profile?
• Violations list: Specific lines that break rules
• Vocabulary flags: Banned words found, missing preferred terms
• Style metrics: Average sentence length, paragraph length, person used
• Suggestions: Concrete rewrites for flagged sections

3. UPDATE -- Modify Existing Profile

Edit specific sections of an existing brand-voice.md without rebuilding from scratch:

/seo-brand-voice update

Presents current profile sections and asks which to modify.

Brand Voice Profile Structure

The profile is saved as brand-voice.md in the project root with this structure:

# Brand Voice Profile

## Brand Identity
- **Name**: [Brand name]
- **Tagline**: [One-line tagline]
- **Mission**: [What the brand helps people do]

## Tone
- **Primary tone**: [expert | friendly | formal | conversational | authoritative]
- **Secondary tone**: [warm | precise | witty | empathetic | bold]
- **Tone spectrum**: [Where on formal <-> casual scale, 1-10]
- **Emotional register**: [inspire | educate | reassure | challenge | entertain]

## Audience Persona
- **Who**: [Target reader description]
- **Experience level**: [beginner | intermediate | advanced | mixed]
- **Pain points**: [Top 3 problems they face]
- **Goals**: [What they want to achieve]
- **Reading context**: [Mobile commute | Desktop work | Research mode]

## Vocabulary Rules
- **Preferred terms**: [Words that reinforce brand identity]
- **Avoided terms**: [Words that contradict brand voice]
- **Jargon policy**: [Define on first use | Avoid entirely | Use freely]
- **Power words**: [Action words that drive engagement]
- **Transition phrases**: [Preferred connectors between ideas]

## Style Rules
- **Sentence length**: [Target average, e.g., 15-20 words]
- **Paragraph length**: [Target, e.g., 2-4 sentences]
- **Contractions**: [Yes | No | Sparingly]
- **Person**: [1st (we/I) | 2nd (you) | 3rd (they/one)]
- **Active voice**: [Required | Preferred | Flexible]
- **Lists and formatting**: [Bullet points encouraged | Minimal formatting]
- **Heading style**: [Question-based | Action-based | Descriptive]

## Content Rules
- **Citation style**: [Link inline | Footnotes | "According to X" pattern]
- **CTA style**: [Soft suggestion | Direct command | Question-based]
- **Humor policy**: [None | Light and relevant | Frequent]
- **Example usage**: [Real examples | Hypothetical | Data-driven]
- **Emoji usage**: [None | Sparingly in headings | Freely]
- **Opening style**: [Hook with stat | Question | Story | Direct statement]
- **Closing style**: [Summary + CTA | Question | Forward-looking statement]

## SEO Voice Integration
- **Keyword placement**: [Natural flow | First paragraph required | H2 required]
- **Keyword density**: [Target range, e.g., 1-2%]
- **Internal link style**: [Contextual anchor text | "Read more" pattern]
- **Meta description voice**: [Matches article tone | More formal | More direct]