Write a brand voice and tone guide
Writes a voice and tone guide with voice attributes, tone shifts by situation, vocabulary, mechanics, dos and don'ts, and before-and-after rewrites. Use when defining how a brand writes.
Most voice guides list adjectives every brand claims ("friendly, innovative, human") and give writers nothing to act on. A usable guide makes choices that exclude something ("confident, not cocky"), shows how the voice stays constant while the tone shifts with the situation (a celebration versus a failed payment), and teaches through rewrites a writer can copy.
Write a voice and tone guide for this brand.
Only if [SAMPLES] is given:
- If samples were given, analyse them first: what the strongest samples do (sentence length, person, formality, humour, jargon) and where samples are inconsistent. Base the guide on the samples marked good, and cite them.
- Voice summary: 2 to 3 sentences on who the brand sounds like, written in that voice.
- Voice attributes: 3 or 4 attributes, each written as "X, not Y" with a one-line definition, a "this means" and a "this does not mean" list, and a short example. Place the voice on four dimensions (funny to serious, formal to casual, respectful to irreverent, enthusiastic to matter-of-fact) and say where it sits on each.
- Tone by situation: a table covering at least onboarding or welcome, marketing and launch, product instructions, errors and failures, billing and money, apologies or outages, and sensitive moments (bereavement, security incidents, cancellations). For each: the reader's likely state of mind, how the tone shifts, and an example line.
- Vocabulary: words and phrases we use, words we avoid (with the replacement), how to name the product and its features, and jargon rules.
- Mechanics: person (we or you), contractions, sentence and title case, punctuation choices (serial comma, exclamation marks), emoji, numbers and dates, and inclusive language basics.
- Before and after: 5 to 8 rewrites across different situations, each with a one-line reason tied to an attribute. Use real samples where given.
- Checklist: 6 to 8 yes-or-no questions a writer can run before publishing.
- Every attribute must rule something out. Drop any attribute that could describe any brand.
- Do not make up brand facts, products or claims. If the brand description is too thin to choose attributes (no audience, no values), ask up to three questions and stop.
- Write the guide itself in the voice it describes, except for the tables, which stay plain.
- Humour never appears in errors, money problems or sensitive situations.
Markdown with the contract's sections as ## headings, in order. Tables for tone by situation and vocabulary. Before-and-after pairs as "Before:" and "After:" lines with the reason below.
1 required value still a placeholder; the assistant will ask for it.
details
- kind
- Prompt: a task you run by name to get one finished thing back
- domain
- Design
- category
- Branding
- level
- Intermediate
- made for
- Marketer, Copywriter, Product / UX / UI designer, Founder / business owner
- risk
- read-only
- version
- v1.0.0 · incubating
- reviewed
- 2026-10-02
- works in
- Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Antigravity, OpenCode, Windsurf, Zed, Continue, AGENTS.md, ChatGPT, claude.ai
use in
npx @hermes-hq/hodios install write-brand-voice-guide --target claude-codenpx skills add hermes-hq/hodios-dist --skill write-brand-voice-guide -a claude-codeclaude plugin marketplace add hermes-hq/hodios-distclaude plugin install hodios-design@hodiosThe plugin brings every entry in this domain at once.
pairs well with
All of BrandingWrite UX microcopy
Writes interface microcopy (buttons, labels, empty states, errors, confirmations, success messages) that is clear, consistent and in the product's voice. Use when designing or reviewing screens.
write-ux-microcopyGenerate brand and product name candidates
Generates brand or product name candidates across naming territories with rationale and risk flags, and lists the trademark, domain and language checks still to do. Use when naming a product.
name-brandBrand identity track
Takes a brand from discovery and positioning to a brand platform, verbal identity, visual direction and guidelines, pausing for approval between steps. Use for a new business or a rebrand.
brand-identity-trackBrand strategist
Brand strategist who starts from audience, positioning and the business model, builds one distinctive brand idea and keeps every expression consistent with it. Use as a branding partner.
brand-strategistWrite brand guidelines
Writes brand guidelines covering logo use, colour, typography, imagery, voice, applications and do and don't examples as a structured document. Use when a team formalises its brand.
build-brand-guidelinesBuild a brand platform
Defines a brand platform with purpose, mission, vision, values with behaviours, positioning, personality and promise, each tested for distinctiveness. Use when setting brand foundations.
build-brand-platform