# Writing Voice

> Revise substantial prose so it sounds like Braden while preserving his vocabulary, humor, certainty, and emphasis. Use when prose no longer sounds like me or needs a voice, tone, or ear pass in UI copy, documentation, or messages.

- Skill: `epicenterhq/writing-voice` (Agent Skill)
- Install (CLI): `npx skillmds@latest add epicenterhq/writing-voice`
- Raw SKILL.md: https://api.skillmd.com/api/skills/epicenterhq/writing-voice/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: epicenterhq (https://skillmd.com/u/epicenterhq)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/epicenterhq/writing-voice

---


# Writing Voice

## Product Promise

Make the writer easier to hear, not easier to mistake for a good generic writer.
Voice is not polish applied after meaning and structure. It is evidence of what
the writer means: their relation to the reader, their certainty, their humor,
and what they linger on. The destination skill owns what belongs and in what
order. This skill owns how that chosen material is expressed.

## Preserve The Grain

Do not add, remove, reorder, promote, or demote material as a voice choice.
Return those decisions to the destination. Different destinations have
different native movements, so do not impose one house style on all of them.

Keep the writer's concrete vocabulary, unusual phrasing, proportion of caveat
to claim, jokes, fragments, repetitions, and detours when they do expressive
work. A phrase may be grammatical but wrong if it changes the writer from
curious to authoritative, conversational to formal, or amused to earnest.
Preserving a few distinctive words is not enough when the draft has changed its
posture.

Repair roughness when it is merely in the way: a transcription error, a false
start with no remaining work to do, or spoken order that makes the thought
unintelligible. Do not repair something merely because smoother prose is
available. Every substantial edit needs a positive account of the expressive job
it performs, such as making a turn legible without removing its uncertainty.
“This sounds better” is not an account.

## Draft, Then Rehear

During editorial development, a destination skill may propose an earned reveal,
contrast, metaphor, or closing turn when it makes the supplied material easier
to hear. Voice work may shape that expression, but must not invent an event,
fact, memory, reaction, certainty, or intention. Do not turn a sparse source
into a polished generality.

`authored-capture` identifies the source-authorized material and governs the
first body's faithful amplification. Within that path, voice work may make only
the mechanical repairs that `authored-capture` permits. During editorial
development, this skill helps shape the proposed passage so it sounds like the
writer before Braden evaluates it; after adoption, the ear pass verifies that
the integrated passage still sounds like him rather than generic polish.

After a whole draft exists, read it at speaking speed. Mark generic connective
tissue, flattened rhythm, and places where the attention moves away from what
the writer cared about. Remove unsupported polish rather than merely improving
it. Keep a vivid turn when the source earns it.

When a reaction reveals a deeper mismatch, reread the complete source and the
whole draft under that correction. Do not reduce “too solemn,” “too sanitized,”
or “that is not why I said it” to a line edit. When a selected local revision is
truly consequential but does not change the work's model, show the current and
proposed wording, state the job it performs, and wait for the writer's decision.

## Match The Destination

In UI copy, documentation, and messages, preserve the person while respecting
the form; clarity never requires corporate scaffolding or false authority.

Use punctuation to make movement legible. Prefer periods. Use colons for a real
explanation, semicolons for closely related independent clauses, and parentheses
for genuine asides. Avoid en dashes; default away from em dashes except for a
real interruption or high-emphasis aside.

For authored prose, the final test is whether the writer recognizes the person
who said it. Did this expression make the writer easier to hear without
normalizing the particular thing they were doing?

