Brand voice

Develop or document a complete brand voice and tone system covering voice attributes, tone shifts by context, vocabulary preferences, grammar rules, and copy examples.

Brand voice — Creative Direction skill highlight diagram. Navy header card reads 'Impactful Creative Direction' with the subtitle… (from the rampstackco/claude-skills README)

From the rampstackco/claude-skills README — shows the whole collection, not only this skill. · view on GitHub

How to use it

Claude Code
  1. Run the line below. It pulls the whole folder into ~/.claude/skills/brand-voice, including the files SKILL.md points to.
  2. Describe your job in plain words. Claude Code follows the skill from there.
Claude Code — installs the whole folder, not just SKILL.md
npx degit rampstackco/claude-skills/skills/brand-voice#main ~/.claude/skills/brand-voice

For one project only, change the path to .claude/skills/brand-voice. This skill also uses voice.md — copying SKILL.md alone won't be enough. See the folder on GitHub.

Claude (web or desktop app)
  1. On this page open ⋯ → Download .md.
  2. Save it as SKILL.md in a folder, zip the folder, then Customize → Skills → + → Create skill → Upload a skill.
  3. Pick the file and Save. Claude shows the name and description and runs a security scan.
  4. Check the skill is switched on.
  5. Start a new chat and describe your job in plain words. The AI follows the skill from there.
ChatGPT or another app
  1. ChatGPT: make a Project and paste it into Instructions.
  2. Neither? Paste it at the top of a new chat — it works for that chat.
Not working?
  • Check which app you pasted it into — the steps above name the right one.
  • Some skills need the paid tier of Claude or ChatGPT.
Step-by-step guide with screenshots · Ask in the forum

Paste into Claude, ChatGPT or Cursor.

Source of Brand voice

Show the full text181 lines
namedescriptioncategorycatalog_summarydisplay_order
brand-voiceDevelop or document a complete brand voice and tone system covering voice attributes, tone shifts by context, vocabulary preferences, grammar rules, and copy examples. Use this skill whenever the user wants to define how a brand sounds, write a voice and tone document, audit existing copy for voice consistency, train a team or AI assistant on brand voice, or refine the personality of brand writing. Triggers on brand voice, voice and tone, tone of voice, writing voice, brand personality, copy voice, voice document, voice guidelines, how should we write, voice training, voice audit. Also triggers when the user has copy that 'feels off' and the underlying issue is voice, even if not stated explicitly. On a voice consistency check, this skill owns defining and documenting the voice system; use `editorial-qa` when a specific draft needs checking against an existing system before it publishes.brandVoice attributes, tone shifts, vocabulary, paired-example library4

Brand Voice

Define how a brand sounds in writing. Document it in a way that anyone (writer, designer, founder, AI assistant) can apply it consistently.

This skill produces a standalone voice document that can either live in the brand style guide or feed into it.


When to use

  • Defining brand voice for the first time
  • Auditing existing copy for voice consistency
  • Training a team, freelancer, or AI assistant on the brand voice
  • Refining a voice that exists but is inconsistent across applications
  • Adapting voice when a brand evolves (new audience, new positioning)

When NOT to use

  • Writing specific copy (use content-and-copy)
  • Brand visual identity work (use brand-identity)
  • Documenting a complete brand system (use brand-style-guide, which incorporates voice)
  • Initial brand exploration (use brand-ideation)

Required inputs

  • The brand and its positioning
  • The audience and what they need to hear
  • 5 to 10 examples of existing brand writing (if any)
  • 3 to 5 reference brands whose voice resonates with where this brand should go
  • Any voice attributes already specified in the brief

The framework: 4 layers

Voice has four layers, stacked. Each layer constrains the one below it.

Layer 1: Voice attributes

The constants. The personality traits that define how the brand sounds across every context.

Pick 3 to 5 attributes. Pair each with what it is NOT (the failure mode if overdone).

Common attribute pairings (NOT a menu - generate your own):

  • Confident, not arrogant
  • Direct, not blunt
  • Warm, not saccharine
  • Witty, not sarcastic
  • Smart, not academic
  • Honest, not harsh
  • Playful, not silly
  • Practical, not boring
  • Bold, not loud
  • Curious, not unfocused

The "not" half is what saves writers from overshooting. "Confident" alone produces swagger. "Confident, not arrogant" tells writers where the line is.

Layer 2: Tone shifts

Voice is constant. Tone adapts to context.

Map the major contexts the brand writes in. For each, document how voice expresses differently.

Common contexts:

Context Tone shift
Onboarding Warmer, more enthusiastic, slightly slower pace
Hero / marketing Confident, signature voice fully on
Product copy / UX Direct, helpful, brief
Error messages Calm, matter-of-fact, no apology theater
Success states Brief celebration, redirect to next action
Empty states Helpful, slightly playful, suggest action
404 / not found Self-aware, light, points the way home
Account deletion / cancellation Quiet, respectful, no jokes
Pricing Direct, transparent, confidence-inspiring
Legal / TOS Plain language version sits next to the legal version
Support / help center Patient, thorough, no condescension
Crisis communication Calm, factual, accountable
Product announcements Excited but not breathless
Email subject lines Specific, never click-bait

Voice stays consistent across all of these. Tone is what shifts.

Layer 3: Vocabulary and grammar

The granular dial settings.

Vocabulary preferences:

  • Words and phrases the brand uses
  • Words and phrases the brand avoids
  • Words the brand has redefined (if any) - e.g., a SaaS product calling its features "huddles" instead of "meetings"
  • Industry jargon: keep it (signals expertise) or strip it (signals approachability)
  • Sentence-opening preferences (some brands lean on imperatives, some on questions, some on statements)

Grammar and style:

  • Contractions (use them = casual, avoid them = formal)
  • Sentence length default (short = punchy, medium = considered, long = literary)
  • Punctuation marks favored or avoided (em dash is famously polarizing)
  • Pronouns ("we" / "you" / "I")
  • Capitalization style (title case, sentence case, all-lowercase deliberate)
  • Number formatting (spell out under ten, or always digits)
  • Oxford comma (use or skip)
  • Active vs passive voice (most brands prefer active)
Layer 4: Examples and patterns

Voice is taught through examples, not rules. Build a library.

For each major content type, show:

  • Bad example (off-voice)
  • Good example (on-voice)
  • Brief note on what changed

Cover the content types listed in the paired examples library of references/voice-document-template.md. The template owns that list, so there is one list to maintain rather than two that drift apart.

The floor is 15 paired examples. One pair per type in the template clears it. Past 25 the library gets harder to scan than to use, so treat 25 as the practical ceiling, not a hard cap. This is the most-used part of the voice doc in practice.


Workflow

  1. Pick the entry point. references/voice-frameworks.md has a "Choosing a framework" section that decides this. A brand starting from zero begins with archetypes there, then dimensions, then attributes, and rejoins this workflow at step 2. Everything below assumes copy exists to audit.
  2. Audit existing copy if it exists. Identify what is on-brand, what is off, what patterns recur.
  3. Layer 1: Voice attributes. Generate 5 to 8 candidates with "we are X, not Y" framing. Pick 3 to 5.
  4. Layer 2: Tone shifts. List 8 to 15 contexts the brand writes in. Note the tone shift for each.
  5. Layer 3: Vocabulary and grammar. Define preferences. Skip default rules unless they actually distinguish the brand.
  6. Layer 4: Examples. Build the paired-example library against the template's content-type list, to the floor stated in the Layer 4 section above.
  7. Stress-test. Pick a fresh writing brief and apply the voice doc. Score the result with the stress test in references/voice-frameworks.md: 1 to 5 against each attribute, and anything scoring below 3 on any attribute is off-voice. Below 3 means the doc is incomplete, not that the copy needs another pass.
  8. Document. Use the template in references/voice-document-template.md.
  9. Distribute. Voice docs only work if they get used. Make the doc easy to reference inline (link to it from CMS templates, brief templates, AI assistant prompts).

Failure patterns

  • Generic attributes ("friendly, professional, approachable"). Every brand says this. Means nothing. Pick attributes that genuinely distinguish.
  • No "we are NOT" pairings. Without the rejection, attributes drift toward extremes.
  • Voice doc with no examples. Rules without examples cannot be applied.
  • Examples that are obviously bad and obviously good. Real voice work shows nuanced shifts, not cartoonish before/after.
  • Skipping tone shifts. Treating voice as one-size-fits-all leads to a brand that sounds wrong in error states or legal contexts.
  • Documenting aspirational voice. If the brand does not actually sound this way today and has no plan to shift, the doc is fiction.
  • Voice without distribution. A perfect doc that no one references is worth nothing.

Output format

Default output is a markdown document at voice.md in the brand folder. Sections:

  1. Voice attributes (with we-are-not pairings)
  2. Tone shifts by context
  3. Vocabulary preferences
  4. Grammar and style rules
  5. Paired examples library (the most-used section)
  6. Anti-patterns (specific phrases or constructions to avoid)
  7. References (the brands and writers we are inspired by)

This doc can stand alone or feed into brand-style-guide.


Reference files

1---
2name: brand-voice
3description: "Develop or document a complete brand voice and tone system covering voice attributes, tone shifts by context, vocabulary preferences, grammar rules, and copy examples. Use this skill whenever the user wants to define how a brand sounds, write a voice and tone document, audit existing copy for voice consistency, train a team or AI assistant on brand voice, or refine the personality of brand writing. Triggers on brand voice, voice and tone, tone of voice, writing voice, brand personality, copy voice, voice document, voice guidelines, how should we write, voice training, voice audit. Also triggers when the user has copy that 'feels off' and the underlying issue is voice, even if not stated explicitly. On a voice consistency check, this skill owns defining and documenting the voice system; use `editorial-qa` when a specific draft needs checking against an existing system before it publishes."
4category: brand
5catalog_summary: "Voice attributes, tone shifts, vocabulary, paired-example library"
6display_order: 4
7---
8 
9# Brand Voice
10 
11Define how a brand sounds in writing. Document it in a way that anyone (writer, designer, founder, AI assistant) can apply it consistently.
12 
13This skill produces a standalone voice document that can either live in the brand style guide or feed into it.
14 
15---
16 
17## When to use
18 
19- Defining brand voice for the first time
20- Auditing existing copy for voice consistency
21- Training a team, freelancer, or AI assistant on the brand voice
22- Refining a voice that exists but is inconsistent across applications
23- Adapting voice when a brand evolves (new audience, new positioning)
24 
25## When NOT to use
26 
27- Writing specific copy (use `content-and-copy`)
28- Brand visual identity work (use `brand-identity`)
29- Documenting a complete brand system (use `brand-style-guide`, which incorporates voice)
30- Initial brand exploration (use `brand-ideation`)
31 
32---
33 
34## Required inputs
35 
36- The brand and its positioning
37- The audience and what they need to hear
38- 5 to 10 examples of existing brand writing (if any)
39- 3 to 5 reference brands whose voice resonates with where this brand should go
40- Any voice attributes already specified in the brief
41 
42---
43 
44## The framework: 4 layers
45 
46Voice has four layers, stacked. Each layer constrains the one below it.
47 
48### Layer 1: Voice attributes
49 
50The constants. The personality traits that define how the brand sounds across every context.
51 
52Pick 3 to 5 attributes. Pair each with what it is NOT (the failure mode if overdone).
53 
54Common attribute pairings (NOT a menu - generate your own):
55 
56- Confident, not arrogant
57- Direct, not blunt
58- Warm, not saccharine
59- Witty, not sarcastic
60- Smart, not academic
61- Honest, not harsh
62- Playful, not silly
63- Practical, not boring
64- Bold, not loud
65- Curious, not unfocused
66 
67The "not" half is what saves writers from overshooting. "Confident" alone produces swagger. "Confident, not arrogant" tells writers where the line is.
68 
69### Layer 2: Tone shifts
70 
71Voice is constant. Tone adapts to context.
72 
73Map the major contexts the brand writes in. For each, document how voice expresses differently.
74 
75Common contexts:
76 
77| Context | Tone shift |
78|---|---|
79| Onboarding | Warmer, more enthusiastic, slightly slower pace |
80| Hero / marketing | Confident, signature voice fully on |
81| Product copy / UX | Direct, helpful, brief |
82| Error messages | Calm, matter-of-fact, no apology theater |
83| Success states | Brief celebration, redirect to next action |
84| Empty states | Helpful, slightly playful, suggest action |
85| 404 / not found | Self-aware, light, points the way home |
86| Account deletion / cancellation | Quiet, respectful, no jokes |
87| Pricing | Direct, transparent, confidence-inspiring |
88| Legal / TOS | Plain language version sits next to the legal version |
89| Support / help center | Patient, thorough, no condescension |
90| Crisis communication | Calm, factual, accountable |
91| Product announcements | Excited but not breathless |
92| Email subject lines | Specific, never click-bait |
93 
94Voice stays consistent across all of these. Tone is what shifts.
95 
96### Layer 3: Vocabulary and grammar
97 
98The granular dial settings.
99 
100**Vocabulary preferences:**
101 
102- Words and phrases the brand uses
103- Words and phrases the brand avoids
104- Words the brand has redefined (if any) - e.g., a SaaS product calling its features "huddles" instead of "meetings"
105- Industry jargon: keep it (signals expertise) or strip it (signals approachability)
106- Sentence-opening preferences (some brands lean on imperatives, some on questions, some on statements)
107 
108**Grammar and style:**
109 
110- Contractions (use them = casual, avoid them = formal)
111- Sentence length default (short = punchy, medium = considered, long = literary)
112- Punctuation marks favored or avoided (em dash is famously polarizing)
113- Pronouns ("we" / "you" / "I")
114- Capitalization style (title case, sentence case, all-lowercase deliberate)
115- Number formatting (spell out under ten, or always digits)
116- Oxford comma (use or skip)
117- Active vs passive voice (most brands prefer active)
118 
119### Layer 4: Examples and patterns
120 
121Voice is taught through examples, not rules. Build a library.
122 
123For each major content type, show:
124 
125- Bad example (off-voice)
126- Good example (on-voice)
127- Brief note on what changed
128 
129Cover the content types listed in the paired examples library of [`references/voice-document-template.md`](references/voice-document-template.md). The template owns that list, so there is one list to maintain rather than two that drift apart.
130 
131The floor is 15 paired examples. One pair per type in the template clears it. Past 25 the library gets harder to scan than to use, so treat 25 as the practical ceiling, not a hard cap. This is the most-used part of the voice doc in practice.
132 
133---
134 
135## Workflow
136 
1371. **Pick the entry point.** [`references/voice-frameworks.md`](references/voice-frameworks.md) has a "Choosing a framework" section that decides this. A brand starting from zero begins with archetypes there, then dimensions, then attributes, and rejoins this workflow at step 2. Everything below assumes copy exists to audit.
1382. **Audit existing copy** if it exists. Identify what is on-brand, what is off, what patterns recur.
1393. **Layer 1: Voice attributes.** Generate 5 to 8 candidates with "we are X, not Y" framing. Pick 3 to 5.
1404. **Layer 2: Tone shifts.** List 8 to 15 contexts the brand writes in. Note the tone shift for each.
1415. **Layer 3: Vocabulary and grammar.** Define preferences. Skip default rules unless they actually distinguish the brand.
1426. **Layer 4: Examples.** Build the paired-example library against the template's content-type list, to the floor stated in the Layer 4 section above.
1437. **Stress-test.** Pick a fresh writing brief and apply the voice doc. Score the result with the stress test in [`references/voice-frameworks.md`](references/voice-frameworks.md): 1 to 5 against each attribute, and anything scoring below 3 on any attribute is off-voice. Below 3 means the doc is incomplete, not that the copy needs another pass.
1448. **Document.** Use the template in [`references/voice-document-template.md`](references/voice-document-template.md).
1459. **Distribute.** Voice docs only work if they get used. Make the doc easy to reference inline (link to it from CMS templates, brief templates, AI assistant prompts).
146 
147---
148 
149## Failure patterns
150 
151- **Generic attributes ("friendly, professional, approachable").** Every brand says this. Means nothing. Pick attributes that genuinely distinguish.
152- **No "we are NOT" pairings.** Without the rejection, attributes drift toward extremes.
153- **Voice doc with no examples.** Rules without examples cannot be applied.
154- **Examples that are obviously bad and obviously good.** Real voice work shows nuanced shifts, not cartoonish before/after.
155- **Skipping tone shifts.** Treating voice as one-size-fits-all leads to a brand that sounds wrong in error states or legal contexts.
156- **Documenting aspirational voice.** If the brand does not actually sound this way today and has no plan to shift, the doc is fiction.
157- **Voice without distribution.** A perfect doc that no one references is worth nothing.
158 
159---
160 
161## Output format
162 
163Default output is a markdown document at `voice.md` in the brand folder. Sections:
164 
1651. Voice attributes (with we-are-not pairings)
1662. Tone shifts by context
1673. Vocabulary preferences
1684. Grammar and style rules
1695. Paired examples library (the most-used section)
1706. Anti-patterns (specific phrases or constructions to avoid)
1717. References (the brands and writers we are inspired by)
172 
173This doc can stand alone or feed into `brand-style-guide`.
174 
175---
176 
177## Reference files
178 
179- [`references/voice-document-template.md`](references/voice-document-template.md) - Fillable template.
180- [`references/voice-frameworks.md`](references/voice-frameworks.md) - Detailed walkthrough of the Nielsen Norman 4 dimensions, Jung archetypes, and the "we are X not Y" approach.
181 

Discussion

Alternatives

Also in Brand voiceSee all 364 in Marketing →
Brand Voice Analysis and Guidelines GenerationPaste in your website and marketing copy, and get back a clear guide anyone on your team can follow to sound like your brand every time.Content & docs · MITProduct Marketing ContextWhen the user wants to create or update their product marketing context document. Also use when the user mentions 'product context,' 'marketing context,' 'set up context,' 'positioning,' 'who is my target audience,' 'describe my product,' 'ICP,' 'ideal customer profile,' or wants to avoid repeating foundational information across marketing tasks. Use this at the start of any new project before using other marketing skills — it creates `.agents/product-marketing.md` that all other skills reference for product, audience, and positioning context.Marketing · MIT/cs:cmo-review — CMO Forcing Questions/cs:cmo-review <plan> — Narrative-first interrogation of positioning, ICP, message house, and channel mix. Use when launching a campaign or repositioning, or when CAC is rising and the one-sentence positioning test fails.Marketing · MITBrand guidelinesWhen the user wants to apply, document, or enforce brand guidelines for any product or company. Also use when the user mentions 'brand guidelines,' 'brand colors,' 'typography,' 'logo usage,' 'brand voice,' 'visual identity,' 'tone of voice,' 'brand standards,' 'style guide,' 'brand consistency,' or 'company design standards.' Covers color systems, typography, logo rules, imagery guidelines, and tone matrix for any brand — including Anthropic's official identity.Marketing · MIT