/brand-voice-manager

name: brand-voice-manager
description: |
  Maintains brand voice consistency across all content. Defines, documents, and enforces
  brand guidelines including tone, vocabulary, style, and messaging. Use this skill to
  create brand voice guides, check content alignment, or ensure consistency across
  content pieces.
allowed-tools:
  - Bash
  - Read
  - Write
  - Glob
  - Grep
  - AskUserQuestion

Brand Voice Manager Skill

> **QUICK REFERENCE** > - **Output folder**: `output/analysis/` (for voice analysis reports) > - **Brand voice files**: `references/brand-voice/` (store brand guides here) > - **Analysis script**: `.venv\Scripts\python.exe scripts/content/analyze_brand_voice.py` > - **File naming**: `YYYY-MM-DD_brand_voice_guide.md` > - **Key deliverables**: Voice guide, tone matrix, vocabulary lists, do/don't examples > - **Python**: ALWAYS use `.venv\Scripts\python.exe` (never bare `python`)

Ensures consistent, authentic brand voice across all content types and platforms.

Scope of This Skill

**This skill handles:**

• Brand voice definition and documentation
• Voice consistency checking
• Tone and style guidelines
• Messaging framework creation
• Vocabulary and language rules
• Brand personality articulation
• Voice training for content teams
• Content alignment audits

**NOT handled by this skill:**

• Visual branding → This is voice/copy only
• Creating content → Use appropriate writer skills
• Logo/design guidelines → Text/voice only

Brand Voice Components

1. Brand Personality

Define your brand as a person:

## Brand Personality

**If our brand were a person, they would be:**
- [Age range, appearance, lifestyle]
- [Profession or expertise area]
- [Personality traits - 3-5 words]
- [How they speak and communicate]
- [What they value most]

**Personality Traits:**
1. [Trait 1] - [How it shows up in content]
2. [Trait 2] - [How it shows up in content]
3. [Trait 3] - [How it shows up in content]

2. Tone Spectrum

Define tone across different contexts:

| Context | Tone | Example | |---------|------|---------| | Educational | [Helpful, expert, approachable] | "Here's what most people miss..." | | Promotional | [Confident, exciting, direct] | "This is your moment to..." | | Support | [Empathetic, patient, clear] | "We understand how frustrating..." | | Social | [Friendly, engaging, authentic] | "Real talk: This changed everything..." | | Formal | [Professional, authoritative, precise] | "Our analysis indicates..." |

3. Voice Attributes

Define 3-5 core voice attributes:

## Voice Attributes

### 1. [Attribute Name] (e.g., "Confident")
**What it means:** [Definition]
**How it sounds:**
- DO: [Example phrase]
- DON'T: [Counter-example]

### 2. [Attribute Name] (e.g., "Approachable")
**What it means:** [Definition]
**How it sounds:**
- DO: [Example phrase]
- DON'T: [Counter-example]

### 3. [Attribute Name] (e.g., "Expert")
**What it means:** [Definition]
**How it sounds:**
- DO: [Example phrase]
- DON'T: [Counter-example]

4. Language Guidelines

Vocabulary

## Vocabulary Guidelines

### Power Words (Use Frequently)
[List of brand-aligned power words]

### Words to Avoid
[List of off-brand words/phrases]

### Industry Jargon Policy
[When to use, when to explain, when to avoid]

### Competitor Words to Avoid
[Terms associated with competitors]

Grammar & Style

## Grammar & Style

### Contractions
[Use: yes/no, when]

### Sentence Length
[Guidelines for sentence structure]

### Paragraph Length
[Max lines/sentences per paragraph]

### Point of View
[First person (we/I), second person (you), third person]

### Active vs Passive
[Preference and when to use each]

### Oxford Comma
[Yes/No]

### Capitalization
[Title case rules, brand name rules]

5. Messaging Framework

## Core Messaging

### Tagline
[Primary brand tagline]

### Value Proposition
[One-sentence value statement]

### Elevator Pitch
[30-second version]

### Key Messages (3-5)
1. [Message 1]
2. [Message 2]
3. [Message 3]

### Proof Points
- [Proof point 1]
- [Proof point 2]
- [Proof point 3]

### Differentiation Statement
[How we're different from competitors]

3-Mode Workflow

MODE 1: PLAN

1. **Understand Brand Context**

   - Existing brand guidelines?
   - Target audience(s)?
   - Competitive positioning?
   - Content examples to analyze?

2. **Audit Existing Content**

   # Analyze existing content for voice patterns
   python scripts/content/analyze_brand_voice.py \
     --folder references/examples/ \
     --output output/analysis/voice_audit.json

3. **Document Plan**

   ## Brand Voice Plan

   ### Current State
   - Existing guidelines: [Yes/No]
   - Content consistency: [Low/Medium/High]
   - Key gaps: [List]

   ### Deliverables
   1. Brand personality definition
   2. Voice attributes (3-5)
   3. Tone spectrum
   4. Language guidelines
   5. Messaging framework

MODE 2: CLARIFY

**Discovery Questions:**

• "Describe your brand as if it were a person - who are they?"
• "What 3 words should people use to describe your brand?"
• "What tone do competitors use that you want to avoid?"
• "Who is your target audience?"
• "What values does your brand stand for?"

**Style Questions:**

• "Formal or casual? How casual?"
• "Use humor? What kind?"
• "Use emojis in content?"
• "First person (we/I) or third person?"

**Differentiation Questions:**

• "What makes your brand voice unique?"
• "Any words/phrases competitors overuse?"
• "What's your 'anti-voice' - what you never want to sound like?"

MODE 3: IMPLEMENT

1. **Create Voice Guide**

   python scripts/content/generate_voice_guide.py \
     --brand "Brand Name" \
     --output references/brand-voice/

2. **Document All Components**

• Brand personality
• Voice attributes
• Tone guidelines
• Language rules
• Messaging framework

3. **Save Files**