| name | 35-brand-voice-global |
| description | 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`. |
| metadata | {"version":"1.0.1","category":"content"} |
| license | MIT |
| triggers | ["brand voice","tone of voice","brand personality","voice guidelines","banned words","how the brand writes","style guide for copy","copy does not sound like us"] |
| output | 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 |
| related | ["product-marketing-context-global","09-customer-insight-global","36-content-brief-global","37-social-caption-global","04-script-video-global","05-ad-copy-global","14-email-marketing-global"] |
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-global first 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.
