Brand Voice & Style Guide Generator
Overview
This skill produces structured brand voice documentation that gives any writer or communicator clear, actionable guidance on how the brand should sound. It moves beyond vague adjectives ("professional, friendly") to provide concrete examples, do/don't comparisons, and context-specific tone adjustments.
When This Skill Triggers
- User says "help me define my brand voice" or "create a style guide"
- User asks "how should our organization sound?"
- User needs messaging guidelines for a team, publication, or department
- User mentions brand consistency, tone documentation, or editorial standards
- User is onboarding writers or communicators and needs reference documentation
Process
Phase 1: Brand Voice Discovery
Gather inputs through interview or analysis:
1. Mission and Values
- What does the organization exist to do?
- What 3-5 values guide decision-making?
- What does the organization believe that others in the space might not?
2. Audience Analysis
- Who are the primary audiences? (Be specific about demographics, expertise level, needs)
- What emotional state are they in when they encounter your communication?
- What do they need from you? (Information, reassurance, inspiration, tools)
3. Voice Attributes
Identify 3-4 core voice attributes. Each should be defined on a spectrum with a "but not" qualifier:
[Attribute] but not [extreme]
Examples:
- Authoritative but not condescending
- Warm but not saccharine
- Direct but not blunt
- Conversational but not sloppy
- Confident but not arrogant
- Accessible but not dumbed-down
4. Competitive Differentiation
- How do similar organizations sound?
- What makes this brand's voice distinctive?
- What tonal territory is unoccupied in the space?
Phase 2: Style Guide Construction
Section 1: Voice Overview (1 page)
A concise summary anyone can reference quickly:
- Brand mission (1 sentence)
- Voice in 3-4 attributes with "but not" qualifiers
- The brand's "personality" described as if it were a person at a dinner party
Section 2: Tone Spectrum
Voice stays constant; tone shifts by context. Document tone adjustments for:
| Context |
Tone Shift |
Example |
| Celebrating a win |
Enthusiastic, proud |
"We're thrilled to announce..." |
| Delivering difficult news |
Empathetic, direct |
"We need to share something important..." |
| Teaching/educating |
Patient, clear |
"Here's what you need to know..." |
| Responding to criticism |
Measured, accountable |
"We hear your concern, and here's what we're doing..." |
| Social media (casual) |
Warm, conversational |
"Real talk: this changed how we think about..." |
| Formal announcement |
Confident, precise |
"[Organization] announces the launch of..." |
Section 3: Writing Dos and Don'ts
Provide concrete examples for each guideline:
DO: "Our research found that solutions-focused news coverage
increased readers' willingness to act by 40%."
DON'T: "Our groundbreaking, paradigm-shifting research has
conclusively proven beyond any shadow of a doubt..."
DO: "We made a mistake. Here's what happened and what we're
doing about it."
DON'T: "Regrettably, circumstances beyond our control led to
an unavoidable situation..."
Section 4: Vocabulary and Terminology
- Preferred terms: Words and phrases the brand uses (with definitions if needed)
- Avoided terms: Words and phrases that don't fit the brand
- Industry jargon policy: When technical terms are acceptable vs. when to use plain language
- Inclusive language guidelines: Preferred terminology for referring to people, communities, identities
Section 5: Grammar and Mechanics
- Style base: AP Style, Chicago, or custom (specify which and document exceptions)
- Oxford comma: Yes or no
- Numbers: When to spell out vs. use numerals
- Capitalization: Title case vs. sentence case for headings
- Abbreviations: When to spell out on first reference
- Special formatting: How to handle links, CTAs, hashtags
Section 6: Platform-Specific Guidelines
For each active platform, document:
- Character/length targets
- Hashtag strategy
- Emoji policy
- Image/visual tone
- Engagement style (how to respond to comments, DMs)
Section 7: Templates
Include ready-to-use templates for the most common communication types:
- Social media post (by platform)
- Newsletter introduction
- Press release lead paragraph
- Email announcement
- Event promotion
Phase 3: Output Formats
Comprehensive guide (.docx or .md): Full multi-section document for teams
One-pager (.pdf): Quick reference card with voice attributes, dos/don'ts, and key terms
Slide deck (.pptx): Presentation format for team training
Interactive artifact (.jsx): Searchable, tabbed reference tool
Before You Begin
Ask these questions before building any voice guide. Do not begin Phase 1 until you have answers to questions 1, 4, and 5.
- Existing guidelines: Does the organization have any existing brand guidelines or documentation? (If yes, request them before proceeding — the goal is to extend or clarify, not replace.)
- Tone examples (on-brand): Can you share 3-5 examples of communications you think nail the right tone?
- Tone examples (off-brand): Can you share 2-3 examples of communications that felt wrong?
- Guide users: Who will use this guide? (Writers, social media managers, all staff, external partners)
- Scope: Full style guide (all 7 sections) or voice-only documentation (sections 1-4)?
Output Checklist
Before presenting any voice guide, verify:
- Every voice attribute has a "but not" qualifier — no bare adjectives.
- At least one DO/DON'T pair per voice attribute — with full quoted example sentences, not descriptions.
- Tone table includes a crisis-adjacent context — at minimum "responding to criticism" or "delivering difficult news."
- No em dashes anywhere in the output — this includes voice overview prose, tone table examples, DO/DON'T examples, platform guidelines, and templates. Replace every em dash with a comma, semicolon, colon, or rewritten sentence before presenting. Writers using your DO examples as models will reproduce whatever punctuation you use — make sure it is correct.
Hard Rules
- Ground every guideline in examples. Abstract adjectives without examples are useless.
- Include "but not" qualifiers. "Friendly" means nothing without boundaries.
- Make it scannable. Writers will reference this mid-draft. Walls of text defeat the purpose.
- Test with real content. Before finalizing, apply the guide to an actual piece of communication to verify it works.
Reference Files
assets/one-pager-template.md - Template for the quick-reference card
assets/audit-worksheet.md - Content audit worksheet for voice discovery
Note: Voice architecture frameworks and AP vs. Chicago style comparisons are covered by Claude's training and do not require separate reference files. The references/ folder is reserved for user-provided brand materials (existing guidelines, sample communications, terminology lists).
Test Cases
- University research center: Voice guide for a new Solutions Journalism Research Hub
- Nonprofit: Brand voice for an organization focused on health and environmental advocacy
- Personal brand: Voice documentation for an academic building a public-facing presence
- Student publication: Editorial style guide for a university newspaper
1---2name: brand-voice3description: Create brand voice guidelines, style guides, and tone documentation for organizations, departments, publications, and personal brands. Use this skill when the user asks to define a brand voice, create style guidelines, document tone and messaging standards, build a writing style guide, or establish communication standards for a team. Also trigger when the user mentions brand identity, messaging framework, voice and tone documentation, editorial standards, or asks how their brand should "sound." Handles everything from one-page voice summaries to comprehensive multi-section style guides. Works for corporate brands, academic departments, nonprofits, media outlets, and personal brands.4license: MIT5---67# Brand Voice & Style Guide Generator89## Overview1011This skill produces structured brand voice documentation that gives any writer or communicator clear, actionable guidance on how the brand should sound. It moves beyond vague adjectives ("professional, friendly") to provide concrete examples, do/don't comparisons, and context-specific tone adjustments.1213## When This Skill Triggers1415- User says "help me define my brand voice" or "create a style guide"16- User asks "how should our organization sound?"17- User needs messaging guidelines for a team, publication, or department18- User mentions brand consistency, tone documentation, or editorial standards19- User is onboarding writers or communicators and needs reference documentation2021## Process2223### Phase 1: Brand Voice Discovery2425Gather inputs through interview or analysis:2627**1. Mission and Values**28- What does the organization exist to do?29- What 3-5 values guide decision-making?30- What does the organization believe that others in the space might not?3132**2. Audience Analysis**33- Who are the primary audiences? (Be specific about demographics, expertise level, needs)34- What emotional state are they in when they encounter your communication?35- What do they need from you? (Information, reassurance, inspiration, tools)3637**3. Voice Attributes**38Identify 3-4 core voice attributes. Each should be defined on a spectrum with a "but not" qualifier:3940```41[Attribute] but not [extreme]4243Examples:44- Authoritative but not condescending45- Warm but not saccharine46- Direct but not blunt47- Conversational but not sloppy48- Confident but not arrogant49- Accessible but not dumbed-down50```5152**4. Competitive Differentiation**53- How do similar organizations sound?54- What makes this brand's voice distinctive?55- What tonal territory is unoccupied in the space?5657### Phase 2: Style Guide Construction5859#### Section 1: Voice Overview (1 page)6061A concise summary anyone can reference quickly:62- Brand mission (1 sentence)63- Voice in 3-4 attributes with "but not" qualifiers64- The brand's "personality" described as if it were a person at a dinner party6566#### Section 2: Tone Spectrum6768Voice stays constant; tone shifts by context. Document tone adjustments for:6970| Context | Tone Shift | Example |71|---------|------------|---------|72| Celebrating a win | Enthusiastic, proud | "We're thrilled to announce..." |73| Delivering difficult news | Empathetic, direct | "We need to share something important..." |74| Teaching/educating | Patient, clear | "Here's what you need to know..." |75| Responding to criticism | Measured, accountable | "We hear your concern, and here's what we're doing..." |76| Social media (casual) | Warm, conversational | "Real talk: this changed how we think about..." |77| Formal announcement | Confident, precise | "[Organization] announces the launch of..." |7879#### Section 3: Writing Dos and Don'ts8081Provide concrete examples for each guideline:8283```84DO: "Our research found that solutions-focused news coverage 85 increased readers' willingness to act by 40%."86DON'T: "Our groundbreaking, paradigm-shifting research has 87 conclusively proven beyond any shadow of a doubt..."8889DO: "We made a mistake. Here's what happened and what we're 90 doing about it."91DON'T: "Regrettably, circumstances beyond our control led to 92 an unavoidable situation..."93```9495#### Section 4: Vocabulary and Terminology9697- **Preferred terms**: Words and phrases the brand uses (with definitions if needed)98- **Avoided terms**: Words and phrases that don't fit the brand99- **Industry jargon policy**: When technical terms are acceptable vs. when to use plain language100- **Inclusive language guidelines**: Preferred terminology for referring to people, communities, identities101102#### Section 5: Grammar and Mechanics103104- **Style base**: AP Style, Chicago, or custom (specify which and document exceptions)105- **Oxford comma**: Yes or no106- **Numbers**: When to spell out vs. use numerals107- **Capitalization**: Title case vs. sentence case for headings108- **Abbreviations**: When to spell out on first reference109- **Special formatting**: How to handle links, CTAs, hashtags110111#### Section 6: Platform-Specific Guidelines112113For each active platform, document:114- Character/length targets115- Hashtag strategy116- Emoji policy117- Image/visual tone118- Engagement style (how to respond to comments, DMs)119120#### Section 7: Templates121122Include ready-to-use templates for the most common communication types:123- Social media post (by platform)124- Newsletter introduction125- Press release lead paragraph126- Email announcement127- Event promotion128129### Phase 3: Output Formats130131**Comprehensive guide (.docx or .md)**: Full multi-section document for teams132**One-pager (.pdf)**: Quick reference card with voice attributes, dos/don'ts, and key terms133**Slide deck (.pptx)**: Presentation format for team training134**Interactive artifact (.jsx)**: Searchable, tabbed reference tool135136## Before You Begin137138Ask these questions before building any voice guide. Do not begin Phase 1 until you have answers to questions 1, 4, and 5.1391401. **Existing guidelines**: Does the organization have any existing brand guidelines or documentation? (If yes, request them before proceeding — the goal is to extend or clarify, not replace.)1412. **Tone examples (on-brand)**: Can you share 3-5 examples of communications you think nail the right tone?1423. **Tone examples (off-brand)**: Can you share 2-3 examples of communications that felt wrong?1434. **Guide users**: Who will use this guide? (Writers, social media managers, all staff, external partners)1445. **Scope**: Full style guide (all 7 sections) or voice-only documentation (sections 1-4)?145146## Output Checklist147148Before presenting any voice guide, verify:1491501. **Every voice attribute has a "but not" qualifier** — no bare adjectives.1512. **At least one DO/DON'T pair per voice attribute** — with full quoted example sentences, not descriptions.1523. **Tone table includes a crisis-adjacent context** — at minimum "responding to criticism" or "delivering difficult news."1534. **No em dashes anywhere in the output** — this includes voice overview prose, tone table examples, DO/DON'T examples, platform guidelines, and templates. Replace every em dash with a comma, semicolon, colon, or rewritten sentence before presenting. Writers using your DO examples as models will reproduce whatever punctuation you use — make sure it is correct.154155## Hard Rules156157- **Ground every guideline in examples.** Abstract adjectives without examples are useless.158- **Include "but not" qualifiers.** "Friendly" means nothing without boundaries.159- **Make it scannable.** Writers will reference this mid-draft. Walls of text defeat the purpose.160- **Test with real content.** Before finalizing, apply the guide to an actual piece of communication to verify it works.161162## Reference Files163164- `assets/one-pager-template.md` - Template for the quick-reference card165- `assets/audit-worksheet.md` - Content audit worksheet for voice discovery166167> Note: Voice architecture frameworks and AP vs. Chicago style comparisons are covered by Claude's training and do not require separate reference files. The `references/` folder is reserved for user-provided brand materials (existing guidelines, sample communications, terminology lists).168169## Test Cases1701711. **University research center**: Voice guide for a new Solutions Journalism Research Hub1722. **Nonprofit**: Brand voice for an organization focused on health and environmental advocacy1733. **Personal brand**: Voice documentation for an academic building a public-facing presence1744. **Student publication**: Editorial style guide for a university newspaper