voice-and-tone-design
When to use
- A team is producing copy across multiple surfaces and the same segment hears three different brands per quarter — name the voice so the surfaces converge.
- An audience-by-message matrix exists but each audience cell currently reads in a different tone, breaking the recognition signal across the segment.
- A new senior persona (CMO, founder, head-of-content) is asking for a voice-and-tone artefact that downstream writers can defend against.
Do NOT use to copy-edit individual assets (out of scope — that is a
writer's job), draft the message stack (route to
messaging-architecture), or pick channel-specific tactics like
subject lines or ad creative formats (channel-agnostic skill).
Cognition cluster
- Mental model 13 — Occam's Razor. The simplest voice the
segment can recognise across surfaces is the voice that survives
contact with three writers under deadline. A five-attribute voice
that no one remembers is brand-theatre. See
docs/contracts/mental-models.md § 13.
- Mental model 15 — Signal vs. noise. Voice is the
identification signal embedded in copy — without distinctiveness
it is noise that competes with every peer's noise. Cut to the
three attributes that only the segment hears as us. See
mental-models.md § 15.
- Context-spine — product + customer-segment. Read product
for the proofs the voice must carry (a voice that promises what
the product cannot back is fiction); read customer-segment
for the listening-register the audience already lives in. See
context-spine.
Procedure
Step 0: Inherit the positioning frame and audience matrix
Identify the locked positioning anchors from
positioning-strategy and the audience matrix
from messaging-architecture.
Voice without positioning is style; voice without an audience matrix
is broadcast.
Step 1: Analyze the inherited voice
Read 6–10 recent assets across the largest surface set the team
ships on. For each, note the register (formal · conversational ·
technical · playful) and one line that sounds like us (or like
anyone). The output is an honest audit: what voice is currently
shipping, not what the team intends to ship.
Step 2: Pick three voice attributes — and three only
Three attributes, each phrased as "<we are> X, not Y." The
not Y is non-trivial: it names the credible adjacent voice the
team is choosing against, not a strawman. Examples of the shape
(not vocabulary):
- "Precise, not pedantic."
- "Confident, not boastful."
- "Concrete, not buzzword."
A four-attribute voice will collapse to three under deadline; pick
the three now.
Step 3: Build the tone-by-context matrix
Tone modulates voice; voice is constant. For each context — error
copy, marketing surface, sales follow-up, onboarding, executive
summary, support reply — fill: what the audience is feeling · what
the surface must do · which voice attribute leads · what tone
amplifier or muter applies. The matrix is the tool writers
actually reach for; the three attributes are the spine they hang
the tone on.
Step 4: Validate against the recognition signal
Validate the voice on three checks:
- Distinctiveness. Write the same sentence in three credible
peer voices. Verify the team's voice is recognisable as distinct
on first read — not on the second read after explaining the
attributes.
- Proof-coverage. Confirm the voice does not promise what the
product (from the spine) cannot back. "Calm" without an
uptime story is fiction. Verify each attribute against a proof.
- Survives-deadline. Hand the artefacts to a writer who was
not in the room. If the writer cannot reproduce the voice on a
30-minute draft, the voice is documented for the room, not the
surface.
Step 5: Run the consistency review
Re-audit the assets from Step 1 against the locked attributes and
tone matrix. Mark each line consistent · slipping · contradiction.
Slipping is a writer-coaching problem; contradiction is a re-write.
The review surfaces the load-bearing surfaces that need a re-pass,
not a punitive list.
Step 6: Hand back
Hand the artefacts to writers across the surfaces, to
editorial-calendar for cadence
mapping, and to release-comms for
launch-surface voice review.
Related Skills
WHEN to use this
- The unit of work is the voice (three attributes + tone-by-context matrix), not a single line of copy.
- Surfaces are diverging in tone and the segment cannot recognise the brand across them.
- A team needs an artefact that a writer on deadline can actually use.
WHEN NOT to use this
- Drafting the message stack (primary message + proofs) — route to
messaging-architecture.
- Cadence and content-debt management — route to
editorial-calendar.
- Copy-editing individual assets — out of scope; that is a writer's craft.
- Launch-wave announcement copy — route to
release-comms.
When the agent should load this
- "Define our voice — three attributes, no more."
- "Mach uns einen Tone-by-Context matrix, der Schreibern auf Deadline hilft."
- "Why does our copy sound different on every surface?"
- "Run a voice consistency audit on last quarter's assets."
- "Pick the not-Y for each voice attribute."
Output
voice-attributes.md — three attributes in the "X, not Y" shape, with the proof-from-spine that backs each.
tone-by-context.md — one row per surface context, with audience feeling, surface job, lead attribute, and tone amplifier / muter.
consistency-review.md — audit of 6–10 recent assets, each line marked consistent · slipping · contradiction, with re-pass list ranked by surface load.
Gotcha
- A voice that pleases the room is usually below the noise floor — agreement is consensus, not distinctiveness.
- The not-Y is the work. "Confident, not boastful" is meaningful; "confident, not weak" is filler.
- Tone-by-context matrices over-amplify when the surface is high-stakes — a calm voice in error copy is the discipline, not the failure.
Do NOT
- Do NOT exceed three attributes — the fourth collapses on the first deadline.
- Do NOT prescribe channel-specific tactics or copywriting rules; tactics live with the channel owner.
- Do NOT promise voice attributes the product cannot back — "effortless" without an integration story is fiction the support queue will pay for.
Runnable example
Mid-market HR analytics tool, positioning locked (retention beats acquisition), audience matrix has HR director · CFO · IT-security:
- Voice attributes — "Precise, not pedantic." · "Confident, not boastful." · "Concrete, not buzzword."
- Tone-by-context — Error copy: audience scared, lead with precise, mute confident. Marketing surface: audience curious, lead with concrete, amplify confident. Onboarding: audience uncertain, lead with precise, amplify warmth modifier.
- Consistency review — 8 of 10 surveyed assets consistent; 1 slipping (CEO blog leans pedantic); 1 contradiction (homepage hero contradicts not buzzword with "synergistic"). Re-pass list: homepage hero (load-bearing surface, prioritised).
- Hand-off → writers across surfaces;
release-comms voice-reviews the GA-wave announcement.
1---2name: voice-and-tone-design3description: Use when shaping brand voice — voice attributes, tone-by-context matrix, consistency review. Triggers on 'define our voice', 'why does our copy sound different on every surface'.4---56# voice-and-tone-design78## When to use910- A team is producing copy across multiple surfaces and the same segment hears three different brands per quarter — name the voice so the surfaces converge.11- An audience-by-message matrix exists but each audience cell currently reads in a different tone, breaking the recognition signal across the segment.12- A new senior persona (CMO, founder, head-of-content) is asking for a voice-and-tone artefact that downstream writers can defend against.1314Do NOT use to copy-edit individual assets (out of scope — that is a15writer's job), draft the message stack (route to16`messaging-architecture`), or pick channel-specific tactics like17subject lines or ad creative formats (channel-agnostic skill).1819## Cognition cluster2021- **Mental model 13 — Occam's Razor.** The simplest voice the22 segment can recognise across surfaces is the voice that survives23 contact with three writers under deadline. A five-attribute voice24 that no one remembers is brand-theatre. See25 [`docs/contracts/mental-models.md`](../../../docs/contracts/mental-models.md) § 13.26- **Mental model 15 — Signal vs. noise.** Voice is the27 identification signal embedded in copy — without distinctiveness28 it is noise that competes with every peer's noise. Cut to the29 three attributes that *only* the segment hears as us. See30 `mental-models.md` § 15.31- **Context-spine — product + customer-segment.** Read **product**32 for the proofs the voice must carry (a voice that promises what33 the product cannot back is fiction); read **customer-segment**34 for the listening-register the audience already lives in. See35 [`context-spine`](../../../docs/contracts/context-spine.md).3637## Procedure3839### Step 0: Inherit the positioning frame and audience matrix4041Identify the locked positioning anchors from42[`positioning-strategy`](../positioning-strategy/SKILL.md) and the audience matrix43from [`messaging-architecture`](../messaging-architecture/SKILL.md).44Voice without positioning is style; voice without an audience matrix45is broadcast.4647### Step 1: Analyze the inherited voice4849Read 6–10 recent assets across the largest surface set the team50ships on. For each, note the *register* (formal · conversational ·51technical · playful) and one *line that sounds like us* (or *like52anyone*). The output is an honest audit: what voice is currently53shipping, not what the team intends to ship.5455### Step 2: Pick three voice attributes — and three only5657Three attributes, each phrased as *"\<we are\> X, not Y."* The58*not Y* is non-trivial: it names the credible adjacent voice the59team is choosing against, not a strawman. Examples of the shape60(not vocabulary):6162- *"Precise, not pedantic."*63- *"Confident, not boastful."*64- *"Concrete, not buzzword."*6566A four-attribute voice will collapse to three under deadline; pick67the three now.6869### Step 3: Build the tone-by-context matrix7071Tone modulates voice; voice is constant. For each context — error72copy, marketing surface, sales follow-up, onboarding, executive73summary, support reply — fill: *what the audience is feeling · what74the surface must do · which voice attribute leads · what tone75amplifier or muter applies.* The matrix is the tool writers76actually reach for; the three attributes are the spine they hang77the tone on.7879### Step 4: Validate against the recognition signal8081Validate the voice on three checks:82831. **Distinctiveness.** Write the same sentence in three credible84 peer voices. Verify the team's voice is recognisable as distinct85 on first read — not on the second read after explaining the86 attributes.872. **Proof-coverage.** Confirm the voice does not promise what the88 product (from the spine) cannot back. *"Calm"* without an89 uptime story is fiction. Verify each attribute against a proof.903. **Survives-deadline.** Hand the artefacts to a writer who was91 not in the room. If the writer cannot reproduce the voice on a92 30-minute draft, the voice is documented for the room, not the93 surface.9495### Step 5: Run the consistency review9697Re-audit the assets from Step 1 against the locked attributes and98tone matrix. Mark each line *consistent · slipping · contradiction.*99Slipping is a writer-coaching problem; contradiction is a re-write.100The review surfaces the load-bearing surfaces that need a re-pass,101not a punitive list.102103### Step 6: Hand back104105Hand the artefacts to writers across the surfaces, to106[`editorial-calendar`](../editorial-calendar/SKILL.md) for cadence107mapping, and to [`release-comms`](../release-comms/SKILL.md) for108launch-surface voice review.109110## Related Skills111112**WHEN to use this**113114- The unit of work is the *voice* (three attributes + tone-by-context matrix), not a single line of copy.115- Surfaces are diverging in tone and the segment cannot recognise the brand across them.116- A team needs an artefact that a writer on deadline can actually use.117118**WHEN NOT to use this**119120- Drafting the message stack (primary message + proofs) — route to [`messaging-architecture`](../messaging-architecture/SKILL.md).121- Cadence and content-debt management — route to [`editorial-calendar`](../editorial-calendar/SKILL.md).122- Copy-editing individual assets — out of scope; that is a writer's craft.123- Launch-wave announcement copy — route to [`release-comms`](../release-comms/SKILL.md).124125## When the agent should load this126127- "Define our voice — three attributes, no more."128- "Mach uns einen Tone-by-Context matrix, der Schreibern auf Deadline hilft."129- "Why does our copy sound different on every surface?"130- "Run a voice consistency audit on last quarter's assets."131- "Pick the *not-Y* for each voice attribute."132133## Output1341351. **`voice-attributes.md`** — three attributes in the *"X, not Y"* shape, with the proof-from-spine that backs each.1362. **`tone-by-context.md`** — one row per surface context, with audience feeling, surface job, lead attribute, and tone amplifier / muter.1373. **`consistency-review.md`** — audit of 6–10 recent assets, each line marked consistent · slipping · contradiction, with re-pass list ranked by surface load.138139## Gotcha140141- A voice that pleases the room is usually below the noise floor — agreement is consensus, not distinctiveness.142- The *not-Y* is the work. *"Confident, not boastful"* is meaningful; *"confident, not weak"* is filler.143- Tone-by-context matrices over-amplify when the surface is high-stakes — a calm voice in error copy is the discipline, not the failure.144145## Do NOT146147- Do NOT exceed three attributes — the fourth collapses on the first deadline.148- Do NOT prescribe channel-specific tactics or copywriting rules; tactics live with the channel owner.149- Do NOT promise voice attributes the product cannot back — *"effortless"* without an integration story is fiction the support queue will pay for.150151## Runnable example152153Mid-market HR analytics tool, positioning locked (retention beats acquisition), audience matrix has HR director · CFO · IT-security:154155- Voice attributes — *"Precise, not pedantic."* · *"Confident, not boastful."* · *"Concrete, not buzzword."*156- Tone-by-context — *Error copy:* audience scared, lead with *precise*, mute *confident*. *Marketing surface:* audience curious, lead with *concrete*, amplify *confident*. *Onboarding:* audience uncertain, lead with *precise*, amplify warmth modifier.157- Consistency review — 8 of 10 surveyed assets *consistent*; 1 *slipping* (CEO blog leans pedantic); 1 *contradiction* (homepage hero contradicts *not buzzword* with "synergistic"). Re-pass list: homepage hero (load-bearing surface, prioritised).158- Hand-off → writers across surfaces; `release-comms` voice-reviews the GA-wave announcement.