hermes

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.

context

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.

task

Write a voice and tone guide for this brand.

brand

Only if [SAMPLES] is given:

samples

  1. 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.
  2. Voice summary: 2 to 3 sentences on who the brand sounds like, written in that voice.
  3. 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.
  4. 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.
  5. Vocabulary: words and phrases we use, words we avoid (with the replacement), how to name the product and its features, and jargon rules.
  6. Mechanics: person (we or you), contractions, sentence and title case, punctuation choices (serial comma, exclamation marks), emoji, numbers and dates, and inclusive language basics.
  7. 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.
  8. Checklist: 6 to 8 yes-or-no questions a writer can run before publishing.
constraints
  • 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.
output format

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

Edit on GitHubReport a problem

use in

Hodios CLI
npx @hermes-hq/hodios install write-brand-voice-guide --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill write-brand-voice-guide -a claude-code
Add the Hodios marketplace (once)
claude plugin marketplace add hermes-hq/hodios-dist
Install the design plugin
claude plugin install hodios-design@hodios

The plugin brings every entry in this domain at once.

pairs well with

All of Branding
PromptUI design

Write 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-microcopy
PromptBranding

Generate 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-brand
WorkflowBranding

Brand 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-track
PersonaBranding

Brand 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-strategist
PromptBranding

Write 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-guidelines
PromptBranding

Build 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