35-brand-voice-global
Skill644 starsChanged 6 months agoMITView on GitHub
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`.
1 other project uses a version of this.
Adopted by
Most recently taken up by
- minhnv0807/ai-business-skillsword for word, first seen Nov 1, 2026
Other versions1 project uses a version of this.
Word for word · 1
- minhnv0807/ai-business-skills★ 644100% same
Edited · 0
None found.
Wrote their own version · 0
None found.
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository134 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- llms.txtllms.txt
- 00-marketing-plan-globalSkill
- 01-content-calendar-globalSkill
- 02-campaign-brief-globalSkill
- 03-performance-eval-globalSkill
- 04-script-video-globalSkill
- 05-ad-copy-globalSkill
- 06-ugc-egc-brief-globalSkill
- 07-marketing-report-globalSkill
- 08-competitor-research-globalSkill
- 09-customer-insight-globalSkill
- 10-reverse-kpi-globalSkill
- 11-channel-setup-globalSkill
- 12-landing-page-brief-globalSkill
- 13-data-analysis-globalSkill
- 14-email-marketing-globalSkill
- 15-social-listening-globalSkill
- 16-marketing-psychology-globalSkill
- 17-pricing-strategy-globalSkill
- 18-referral-program-globalSkill
- 19-ab-test-setup-globalSkill
- 20-client-intake-brief-globalSkill
- 21-ads-audit-globalSkill
- 30-design-master-globalSkill
- 31-offer-design-globalSkill
- 32-seo-growth-globalSkill
- 33-b2b-lead-gen-globalSkill
- 34-ai-marketing-os-globalSkill
- 36-content-brief-globalSkill
- 37-social-caption-globalSkill
- 38-community-seeding-globalSkill
- 39-content-audit-globalSkill
- 40-next-content-plan-globalSkill
- 41-campaign-asset-list-globalSkill
- 42-image-brief-globalSkill
- 43-carousel-brief-globalSkill
- 44-video-editor-brief-globalSkill
- 45-design-tool-brief-globalSkill
- 46-brand-guideline-globalSkill
- 47-design-review-globalSkill
- 48-quick-visual-brief-globalSkill
- 49-html-email-template-globalSkill
- 50-asset-resize-globalSkill
- 51-audience-research-globalSkill
- 52-account-structure-globalSkill
- 53-tracking-setup-globalSkill
- 54-media-plan-globalSkill
- 55-scaling-ads-globalSkill
- 56-retargeting-plan-globalSkill
- 57-next-ads-plan-globalSkill
- 58-positioning-globalSkill
- 59-go-to-market-globalSkill
- 60-launch-playbook-globalSkill
- 61-budget-planning-globalSkill
- 62-marketing-review-globalSkill
- 63-campaign-retrospective-globalSkill
- 64-team-brief-globalSkill
- 65-team-performance-review-globalSkill
- The first 60 shown.
The file
Show its rules and text
We split this skill into the rules it gives an agent
21 rules. About 0 are common, 19 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈19
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 34
Read .agents/product-marketing-context-global.md and any existing brand guideline first.
- Distinctive: line 44
It is a compass, not a statute: Use it to check work, and flex by context.
- Distinctive: line 45
The core voice is constant across channels: Only format and length change per platform — never the personality.
- Very specific: line 46
Vocabulary comes from real customer language: Run 09-customer-insight-global first so word choices are sourced, not invented.
- Distinctive: line 47
Final test: cover the logo and it still reads as you: If it could be any competitor in the category, it is not done.
- Distinctive: line 59
Practical: every claim comes with something the reader can do today.
- Distinctive: line 103
Before: "Introducing our revolutionary new serum — a total game-changer for your skin.
- Distinctive: line 104
After: "New: a 0.3% retinal serum.
- Distinctive: line 108
Before: "We're so sorry to hear that!
- Distinctive: line 109
After: "Fair complaint. Purging past six weeks usually means the strength is too high for your barrier, not that the product failed.
- Distinctive: line 113
Before: "HUGE SALE! 30% OFF EVERYTHING!
- Distinctive: line 114
After: "30% off through Sunday.
- Distinctive: line 118
Before: "Unlock the secret to glowing skin with these amazing tips!"
- Distinctive: line 119
After: "Vitamin C oxidizes.
- Distinctive: line 123
Before: "Our customers absolutely LOVE us.
- Distinctive: line 124
After: "Priya, 11 weeks in: 'The texture on my cheeks is gone.
- Distinctive: line 210
Every written asset (caption, script, ad copy, email, community post) checks sections II and III before drafting, and section VII before …
- Distinctive: line 212
When onboarding a freelance writer, agency, or creator, send sections I-V as the briefing pack.
- Distinctive: line 223
All 7 sections present, from personality through copy approval checklist.
- Distinctive: line 227
All 5 before/after examples are written for real in the brand's voice — no placeholders.
- Distinctive: line 230
No unsupported superiority or results claims anywhere in the examples.
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
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:
- What does the brand sell, to whom, at what price point — and what should a reader feel after reading its content?
- Which 3 adjectives describe the brand's actual character — and how must the brand never be perceived?
- Is there a brand or writer whose voice is close to the target? (reference only, never to copy)
- 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
- Voice is a living document. Review quarterly or whenever the brand pivots. Do not write it once and file it.
- It is a compass, not a statute. Use it to check work, and flex by context.
- The core voice is constant across channels. Only format and length change per platform — never the personality.
- Vocabulary comes from real customer language. Run
09-customer-insight-globalfirst so word choices are sourced, not invented. - Final test: cover the logo and it still reads as you. If it could be any competitor in the category, it is not done.
- 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:
- Average sentence length: short / mixed / long — and why.
- Rhetorical questions: when they are allowed, when they are not.
- Bullets vs paragraphs: ratio and the contexts each fits.
- Standard opening patterns: pain hook / curiosity / data point / story.
- 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 |
| Longer form allowed, conversational, light emoji if on-brand | Tone, vocabulary | |
| Visual leads, first line carries the hook, tighter caption | Personality, banned words | |
| 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 |
| 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.
Related skills
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.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

