35 brand voice global skill

Use when the user needs to define, document, or enforce how the brand SOUNDS in writing — three personality traits, a five-dimension tone table, vocabulary to use, avoid, and ban, sentence rules, before and after rewrites, platform adaptation, and a copy approval checklist.

by minhnv0807·MIT license·★ 599 Stars on the repo·GitHub ↗

Use now

Files of 35 brand voice global

minhnv0807/master1 file shown
SKILL.md
Show the full text232 lines

Brand Voice (Global)

The foundation skill of the content cluster. Every other content skill — 36-content-brief-global, 37-social-caption-global, 04-script-video-global, 05-ad-copy-global, 14-email-marketing-global, 38-community-seeding-global — reads this document before writing. Without it, output is technically correct and tonally inconsistent.

Information gathering

Read .agents/product-marketing-context-global.md and any existing brand guideline first. If information is missing, ask up to 4 questions:

  1. What does the brand sell, to whom, at what price point — and what should a reader feel after reading its content?
  2. Which 3 adjectives describe the brand's actual character — and how must the brand never be perceived?
  3. Is there a brand or writer whose voice is close to the target? (reference only, never to copy)
  4. What words do customers use when they talk about the brand or category? Paste real reviews, comments, support tickets, or call notes — this is the single most valuable vocabulary source.

Principles

  1. Voice is a living document. Review quarterly or whenever the brand pivots. Do not write it once and file it.
  2. It is a compass, not a statute. Use it to check work, and flex by context.
  3. The core voice is constant across channels. Only format and length change per platform — never the personality.
  4. Vocabulary comes from real customer language. Run 09-customer-insight-global first so word choices are sourced, not invented.
  5. Final test: cover the logo and it still reads as you. If it could be any competitor in the category, it is not done.
  6. Every claim in the voice must be substantiable. A confident voice does not license unsupported superiority or results claims — FTC advertising rules apply to organic posts, not just ads.

Workflow

1. Lock brand personality: 3 adjectives

Pick exactly 3 core adjectives, each with one sentence explaining why it reflects the brand truthfully. More than 3 dilutes the voice.

Illustrative example (a DTC skincare brand):

  • Direct: names the actual problem in the first line, no throat-clearing.
  • Practical: every claim comes with something the reader can do today.
  • Evidence-led: cites the ingredient, the study, or the number — never "clinically proven" without the clinic.

Also record 3 things the brand must never be perceived as (for example: not luxury-aloof, not pressure-selling, not vague-wellness).

2. Define tone of voice across 5 dimensions

For each dimension write both columns. The "is not" column matters as much as the first — it is what stops voice drift.

Dimension The brand is... The brand is not...
Energy [warm / measured / high-energy] [...]
Formality [casual / semi-professional / formal] [...]
Person and address [we-you / I-you / third person] [...]
Use of evidence [always a number / story first, data second] [...]
Handling objections [acknowledge then explain / rebut with proof] [...]
3. Build the vocabulary: use / avoid / banned
  • Use often: words that carry the personality, plus real customer phrasing pulled from reviews and support (source it from 09-customer-insight-global).

  • Avoid: words that contradict the personality or overclaim in the category.

  • Banned words — hard stop, enforced at copy review. Default global marketing-cliche list, plus the brand's own additions:

    "game-changer", "revolutionary", "unlock your potential", "don't miss out", "act now", "hurry — limited time only", "take it to the next level", "elevate your [noun]", "in today's fast-paced world", "we're excited to announce", "best-in-class", "world-class", "seamlessly", "one-stop shop", "must-have", "literally life-changing", "no-brainer", "synergy", "leverage" (as a verb in customer-facing copy).

  • Canonical product names: one agreed spelling and capitalization per product or plan. Not a new variation per post.

4. Set sentence-level rules

Answer all 5:

  1. Average sentence length: short / mixed / long — and why.
  2. Rhetorical questions: when they are allowed, when they are not.
  3. Bullets vs paragraphs: ratio and the contexts each fits.
  4. Standard opening patterns: pain hook / curiosity / data point / story.
  5. Standard closing patterns: specific CTA / question / summary.
5. Write 5 before/after examples

Each example needs: an off-voice version, an on-voice version, and one line naming the difference. All 5 situations are mandatory, written for real — never left as placeholders. Writers use this section more than any other.

Illustrative set, same DTC skincare brand (Direct / Practical / Evidence-led):

1. Product launch caption

  • Before: "Introducing our revolutionary new serum — a total game-changer for your skin. Don't miss out!"
  • After: "New: a 0.3% retinal serum. Same active family as the prescription route, without the four-week peeling phase."
  • Difference: names the formula and the trade-off it solves instead of stacking adjectives.

2. Replying to a negative comment

  • Before: "We're so sorry to hear that! Please DM us so we can make it right."
  • After: "Fair complaint. Purging past six weeks usually means the strength is too high for your barrier, not that the product failed. Reply here and we'll swap you to the 0.15%."
  • Difference: answers the actual problem first; the service gesture comes second, not instead.

3. Promotion announcement

  • Before: "HUGE SALE! 30% OFF EVERYTHING! Act now before it's gone!"
  • After: "30% off through Sunday. It's overstock from the December run — same formula, dented boxes."
  • Difference: gives a real reason for the discount, so the discount does not reset the perceived price.

4. Educational post

  • Before: "Unlock the secret to glowing skin with these amazing tips!"
  • After: "Vitamin C oxidizes. If your serum has turned orange, it has stopped working — which is the whole reason ours ships in an opaque pump."
  • Difference: teaches one checkable fact instead of promising a secret.

5. Testimonial / case study

  • Before: "Our customers absolutely LOVE us. Best product ever!"
  • After: "Priya, 11 weeks in: 'The texture on my cheeks is gone. My jaw still breaks out around my period.' That second part is expected — hormonal acne needs a different lever."
  • Difference: publishing the unresolved part is what makes the resolved part believable.
6. Platform adaptation

Core voice is unchanged. Only format, length, and register shift.

Channel Adjust vs. core Keep constant
Facebook Longer form allowed, conversational, light emoji if on-brand Tone, vocabulary
Instagram Visual leads, first line carries the hook, tighter caption Personality, banned words
LinkedIn One notch more professional, first-person point of view, no hard sell Directness, evidence habit
TikTok 1-2 lines, spoken-word rhythm, keyword-forward for search Core message
X Compressed to a single idea, no wind-up Point of view, precision
Email Greeting and sign-off, slightly warmer, one clear ask Directness, actionability

Output structure

File name: brand-voice-[brand]-[YYYYMMDD].md

# Brand Voice Document — [Brand]

## I. Brand personality
- [Adjective 1]: [one-sentence rationale]
- [Adjective 2]: [one-sentence rationale]
- [Adjective 3]: [one-sentence rationale]
- Never perceived as: [3 things]

## II. Tone of voice
| Dimension | The brand is... | The brand is not... |
|-----------|-----------------|---------------------|
| Energy | | |
| Formality | | |
| Person and address | | |
| Use of evidence | | |
| Handling objections | | |

## III. Vocabulary
**Use often:** [words / phrases, with source where customer-derived]
**Avoid:** [words / phrases]
**Banned words:** [hard-stop list]
**Canonical product names:** [agreed spelling per product/plan]

## IV. Sentence rules
- Average sentence length: [short / mixed / long] — [why]
- Rhetorical questions: [when yes / when no]
- Bullets vs paragraphs: [ratio + context]
- Opening pattern: [pain / curiosity / data / story]
- Closing pattern: [CTA / question / summary]

## V. Before / after — 5 examples
### 1. Product launch caption
- Before: "[off-voice]"
- After: "[on-voice]"
- Difference: [one line]

### 2. Replying to a negative comment
[same format]

### 3. Promotion announcement
[same format]

### 4. Educational post
[same format]

### 5. Testimonial / case study
[same format]

## VI. Platform adaptation
| Channel | Adjust vs. core | Keep constant |
|---------|-----------------|---------------|
| | | |

## VII. Copy approval checklist
- [ ] Read it aloud — does it sound like a person or like a report?
- [ ] Any banned words present?
- [ ] Does the first line earn the second?
- [ ] Any word that can be cut without losing meaning? Cut it.
- [ ] Is the next action obvious to the reader?
- [ ] Is every claim substantiable if challenged?
- [ ] Cover the logo — does it still read as us?

How other skills consume this document

  • Every written asset (caption, script, ad copy, email, community post) checks sections II and III before drafting, and section VII before handoff.
  • Copy reviewers approve against section VII, not against personal taste.
  • When onboarding a freelance writer, agency, or creator, send sections I-V as the briefing pack.
  • 09-customer-insight-global: run first — real customer language from reviews and calls is the raw material for vocabulary.
  • 36-content-brief-global: every brief cites the tone and banned words from here.
  • 37-social-caption-global, 04-script-video-global, 05-ad-copy-global, 14-email-marketing-global: read this document before producing output.
  • product-marketing-context-global: source of positioning, audience, and price point that the voice must fit.

Quality checklist

  • All 7 sections present, from personality through copy approval checklist.
  • Exactly 3 adjectives, each with a specific rationale — no generic descriptors.
  • Tone table covers all 5 dimensions and includes the "is not" column.
  • Vocabulary has all three groups plus canonical product names.
  • All 5 before/after examples are written for real in the brand's voice — no placeholders.
  • Platform adaptation covers every channel the brand actually runs.
  • At least some vocabulary is sourced from real customer language, with the source noted.
  • No unsupported superiority or results claims anywhere in the examples.
  • File name follows brand-voice-[brand]-[YYYYMMDD].md.
1---
2name: 35-brand-voice-global
3description: "Use when the user needs to define, document, or enforce how the brand SOUNDS in writing — three personality traits, a five-dimension tone table, vocabulary to use, avoid, and ban, sentence rules, before and after rewrites, platform adaptation, and a copy approval checklist. Every content skill reads it before writing. Trigger on 'brand voice', 'tone of voice', 'voice guidelines', 'banned words list', 'this copy does not sound like us', 'every writer sounds different'. Also use when the user cannot say why a draft feels wrong. Not for — the visual side of brand, see `46-brand-guideline-global`; positioning and the message, see `58-positioning-global`; approving one specific piece, see `62-marketing-review-global`."
4metadata:
5 version: 1.0.1
6 category: content
7license: MIT
8triggers:
9 - "brand voice"
10 - "tone of voice"
11 - "brand personality"
12 - "voice guidelines"
13 - "banned words"
14 - "how the brand writes"
15 - "style guide for copy"
16 - "copy does not sound like us"
17output: "File .md — Brand Voice Document: 3 personality traits, 5-dimension tone table, vocabulary (use/avoid/banned), sentence rules, 5 before/after examples, platform adaptation, copy approval checklist"
18related:
19 - product-marketing-context-global
20 - 09-customer-insight-global
21 - 36-content-brief-global
22 - 37-social-caption-global
23 - 04-script-video-global
24 - 05-ad-copy-global
25 - 14-email-marketing-global
26---
27 
28# Brand Voice (Global)
29 
30The foundation skill of the content cluster. Every other content skill — `36-content-brief-global`, `37-social-caption-global`, `04-script-video-global`, `05-ad-copy-global`, `14-email-marketing-global`, `38-community-seeding-global` — reads this document before writing. Without it, output is technically correct and tonally inconsistent.
31 
32## Information gathering
33 
34Read `.agents/product-marketing-context-global.md` and any existing brand guideline first. If information is missing, ask up to 4 questions:
35 
361. **What does the brand sell, to whom, at what price point — and what should a reader feel after reading its content?**
372. **Which 3 adjectives describe the brand's actual character — and how must the brand never be perceived?**
383. **Is there a brand or writer whose voice is close to the target?** (reference only, never to copy)
394. **What words do customers use when they talk about the brand or category?** Paste real reviews, comments, support tickets, or call notes — this is the single most valuable vocabulary source.
40 
41## Principles
42 
431. **Voice is a living document.** Review quarterly or whenever the brand pivots. Do not write it once and file it.
442. **It is a compass, not a statute.** Use it to check work, and flex by context.
453. **The core voice is constant across channels.** Only format and length change per platform — never the personality.
464. **Vocabulary comes from real customer language.** Run `09-customer-insight-global` first so word choices are sourced, not invented.
475. **Final test: cover the logo and it still reads as you.** If it could be any competitor in the category, it is not done.
486. **Every claim in the voice must be substantiable.** A confident voice does not license unsupported superiority or results claims — FTC advertising rules apply to organic posts, not just ads.
49 
50## Workflow
51 
52### 1. Lock brand personality: 3 adjectives
53 
54Pick exactly 3 core adjectives, each with one sentence explaining why it reflects the brand truthfully. More than 3 dilutes the voice.
55 
56Illustrative example (a DTC skincare brand):
57 
58- **Direct**: names the actual problem in the first line, no throat-clearing.
59- **Practical**: every claim comes with something the reader can do today.
60- **Evidence-led**: cites the ingredient, the study, or the number — never "clinically proven" without the clinic.
61 
62Also record 3 things the brand must never be perceived as (for example: not luxury-aloof, not pressure-selling, not vague-wellness).
63 
64### 2. Define tone of voice across 5 dimensions
65 
66For each dimension write both columns. The "is not" column matters as much as the first — it is what stops voice drift.
67 
68| Dimension | The brand is... | The brand is not... |
69|-----------|-----------------|---------------------|
70| Energy | [warm / measured / high-energy] | [...] |
71| Formality | [casual / semi-professional / formal] | [...] |
72| Person and address | [we-you / I-you / third person] | [...] |
73| Use of evidence | [always a number / story first, data second] | [...] |
74| Handling objections | [acknowledge then explain / rebut with proof] | [...] |
75 
76### 3. Build the vocabulary: use / avoid / banned
77 
78- **Use often**: words that carry the personality, plus real customer phrasing pulled from reviews and support (source it from `09-customer-insight-global`).
79- **Avoid**: words that contradict the personality or overclaim in the category.
80- **Banned words** — hard stop, enforced at copy review. Default global marketing-cliche list, plus the brand's own additions:
81 
82 "game-changer", "revolutionary", "unlock your potential", "don't miss out", "act now", "hurry — limited time only", "take it to the next level", "elevate your [noun]", "in today's fast-paced world", "we're excited to announce", "best-in-class", "world-class", "seamlessly", "one-stop shop", "must-have", "literally life-changing", "no-brainer", "synergy", "leverage" (as a verb in customer-facing copy).
83 
84- **Canonical product names**: one agreed spelling and capitalization per product or plan. Not a new variation per post.
85 
86### 4. Set sentence-level rules
87 
88Answer all 5:
89 
901. Average sentence length: short / mixed / long — and why.
912. Rhetorical questions: when they are allowed, when they are not.
923. Bullets vs paragraphs: ratio and the contexts each fits.
934. Standard opening patterns: pain hook / curiosity / data point / story.
945. Standard closing patterns: specific CTA / question / summary.
95 
96### 5. Write 5 before/after examples
97 
98Each example needs: an off-voice version, an on-voice version, and one line naming the difference. All 5 situations are mandatory, written for real — never left as placeholders. Writers use this section more than any other.
99 
100Illustrative set, same DTC skincare brand (Direct / Practical / Evidence-led):
101 
102**1. Product launch caption**
103- Before: "Introducing our revolutionary new serum — a total game-changer for your skin. Don't miss out!"
104- After: "New: a 0.3% retinal serum. Same active family as the prescription route, without the four-week peeling phase."
105- Difference: names the formula and the trade-off it solves instead of stacking adjectives.
106 
107**2. Replying to a negative comment**
108- Before: "We're so sorry to hear that! Please DM us so we can make it right."
109- After: "Fair complaint. Purging past six weeks usually means the strength is too high for your barrier, not that the product failed. Reply here and we'll swap you to the 0.15%."
110- Difference: answers the actual problem first; the service gesture comes second, not instead.
111 
112**3. Promotion announcement**
113- Before: "HUGE SALE! 30% OFF EVERYTHING! Act now before it's gone!"
114- After: "30% off through Sunday. It's overstock from the December run — same formula, dented boxes."
115- Difference: gives a real reason for the discount, so the discount does not reset the perceived price.
116 
117**4. Educational post**
118- Before: "Unlock the secret to glowing skin with these amazing tips!"
119- After: "Vitamin C oxidizes. If your serum has turned orange, it has stopped working — which is the whole reason ours ships in an opaque pump."
120- Difference: teaches one checkable fact instead of promising a secret.
121 
122**5. Testimonial / case study**
123- Before: "Our customers absolutely LOVE us. Best product ever!"
124- After: "Priya, 11 weeks in: 'The texture on my cheeks is gone. My jaw still breaks out around my period.' That second part is expected — hormonal acne needs a different lever."
125- Difference: publishing the unresolved part is what makes the resolved part believable.
126 
127### 6. Platform adaptation
128 
129Core voice is unchanged. Only format, length, and register shift.
130 
131| Channel | Adjust vs. core | Keep constant |
132|---------|-----------------|---------------|
133| Facebook | Longer form allowed, conversational, light emoji if on-brand | Tone, vocabulary |
134| Instagram | Visual leads, first line carries the hook, tighter caption | Personality, banned words |
135| LinkedIn | One notch more professional, first-person point of view, no hard sell | Directness, evidence habit |
136| TikTok | 1-2 lines, spoken-word rhythm, keyword-forward for search | Core message |
137| X | Compressed to a single idea, no wind-up | Point of view, precision |
138| Email | Greeting and sign-off, slightly warmer, one clear ask | Directness, actionability |
139 
140## Output structure
141 
142File name: `brand-voice-[brand]-[YYYYMMDD].md`
143 
144```markdown
145# Brand Voice Document — [Brand]
146 
147## I. Brand personality
148- [Adjective 1]: [one-sentence rationale]
149- [Adjective 2]: [one-sentence rationale]
150- [Adjective 3]: [one-sentence rationale]
151- Never perceived as: [3 things]
152 
153## II. Tone of voice
154| Dimension | The brand is... | The brand is not... |
155|-----------|-----------------|---------------------|
156| Energy | | |
157| Formality | | |
158| Person and address | | |
159| Use of evidence | | |
160| Handling objections | | |
161 
162## III. Vocabulary
163**Use often:** [words / phrases, with source where customer-derived]
164**Avoid:** [words / phrases]
165**Banned words:** [hard-stop list]
166**Canonical product names:** [agreed spelling per product/plan]
167 
168## IV. Sentence rules
169- Average sentence length: [short / mixed / long] — [why]
170- Rhetorical questions: [when yes / when no]
171- Bullets vs paragraphs: [ratio + context]
172- Opening pattern: [pain / curiosity / data / story]
173- Closing pattern: [CTA / question / summary]
174 
175## V. Before / after — 5 examples
176### 1. Product launch caption
177- Before: "[off-voice]"
178- After: "[on-voice]"
179- Difference: [one line]
180 
181### 2. Replying to a negative comment
182[same format]
183 
184### 3. Promotion announcement
185[same format]
186 
187### 4. Educational post
188[same format]
189 
190### 5. Testimonial / case study
191[same format]
192 
193## VI. Platform adaptation
194| Channel | Adjust vs. core | Keep constant |
195|---------|-----------------|---------------|
196| | | |
197 
198## VII. Copy approval checklist
199- [ ] Read it aloud — does it sound like a person or like a report?
200- [ ] Any banned words present?
201- [ ] Does the first line earn the second?
202- [ ] Any word that can be cut without losing meaning? Cut it.
203- [ ] Is the next action obvious to the reader?
204- [ ] Is every claim substantiable if challenged?
205- [ ] Cover the logo — does it still read as us?
206```
207 
208## How other skills consume this document
209 
210- Every written asset (caption, script, ad copy, email, community post) checks sections II and III before drafting, and section VII before handoff.
211- Copy reviewers approve against section VII, not against personal taste.
212- When onboarding a freelance writer, agency, or creator, send sections I-V as the briefing pack.
213 
214## Related skills
215 
216- `09-customer-insight-global`: run first — real customer language from reviews and calls is the raw material for vocabulary.
217- `36-content-brief-global`: every brief cites the tone and banned words from here.
218- `37-social-caption-global`, `04-script-video-global`, `05-ad-copy-global`, `14-email-marketing-global`: read this document before producing output.
219- `product-marketing-context-global`: source of positioning, audience, and price point that the voice must fit.
220 
221## Quality checklist
222 
223- All 7 sections present, from personality through copy approval checklist.
224- Exactly 3 adjectives, each with a specific rationale — no generic descriptors.
225- Tone table covers all 5 dimensions and includes the "is not" column.
226- Vocabulary has all three groups plus canonical product names.
227- All 5 before/after examples are written for real in the brand's voice — no placeholders.
228- Platform adaptation covers every channel the brand actually runs.
229- At least some vocabulary is sourced from real customer language, with the source noted.
230- No unsupported superiority or results claims anywhere in the examples.
231- File name follows `brand-voice-[brand]-[YYYYMMDD].md`.
232 

Discussion

Alternatives

Audience belief mapperUse when the user asks to "map what our buyers believe", "capture the objections we keep hearing", or "find the switching forces that move the beachhead"; produces a belief map of the beachhead — held beliefs and mental models, the recurring objections and their reframes, and the JTBD four forces (push of the problem, pull of the new, anxiety of switching, habit of the present) — each item sourced from interviews or win-loss notes (User-provided) and labeled Measured / User-provided / Estimated, with any unverified quote or comparative claim marked "[needs source]" and routed to the claims candidates, never adjudicated here. Not for demographic or persona profiling — use audience-mapper; not for the positioning canvas — use positioning-truth-tracer. 受众信念/异议地图/切换四力/流失语言Marketing · Apache-2.0Brand 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 · MITBrand voice enforcerAnalyze and rewrite content to strict brand voice guidelines, scoring adherence across tone, vocabulary, syntax patterns, and persona alignment for CPG and retail brands.Marketing · Apache-2.0Product 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