Agent Skills: Writing Voice

Voice, tone, and punctuation rules for prose, UI text, tooltips, error messages, comments, JSDoc, markdown, commit messages, and docs. Use when: "fix the tone", "rewrite this", "sounds like AI", "sounds corporate", or deciding whether punctuation earns its emphasis.

UncategorizedID: EpicenterHQ/epicenter/writing-voice

Repository

EpicenterHQLicense: NOASSERTION
4,678359

Install this agent skill to your local

pnpm dlx add-skill https://github.com/EpicenterHQ/epicenter/tree/HEAD/.agents/skills/writing-voice

Skill Files

Browse the full folder contents for writing-voice.

Download Skill

Loading file tree…

.agents/skills/writing-voice/SKILL.md

Skill Metadata

Name
writing-voice
Description
Shape prose so it sounds like Braden, with conversational precision, rhythm, humor, and earned poetic turns. Use for substantial drafting or revision, an ear pass, and explicit voice or tone work in prose, UI copy, documentation, or messages. Do not use to reopen wording selected for exact use.

Writing Voice

Help the writing carry recognizable judgment and recognizable sound. Write in language Braden could say to an articulate friend: clear, natural, and precise, with room for rhythm, wit, and surprise. Find phrasing that makes the thought felt as well as understood. Use this craft throughout drafting and revision; voice, structure, and meaning develop together.

Find The Expression

Conversational precision with a poetic turn is an ambition, not a formula for every paragraph. A turn earns its place by revealing a connection in the material. Try a sharper verb, an unexpected comparison, a changed rhythm, or a plainer sentence when it better carries the thought. Do not invent a motive, feeling, or event to give the prose depth, or substitute ornament for the particulars. Avoid explanations of what a thought signifies merely to make the paragraph sound complete; a polished summary can add no meaning while erasing its force.

Build from the author's actual phrases, not just a summary of their meaning. Keep the comparisons, ordinary words, asides, and emphatic turns that make the speaker recognizable; arrange and connect them before replacing them with equally accurate paraphrases. Roughness can carry emotion, humor, tension, uncertainty, or rhythm. “And then there's just a lot of Asian food” can earn its own paragraph without becoming an explanation of everyday cultural connection. Repair transcription errors and obstructive phrasing without treating every “actually,” “of course,” or repetition as noise. Neither roughness nor polish is a virtue by itself.

Choose the register from the piece's purpose and Braden's reactions. Preserve substantive qualifications while removing hesitation that belongs only to the act of dictation. Preserve the degree of conviction too: changing “I would argue” into “I wonder whether” can weaken the thought even when its subject stays the same. Do not strengthen real uncertainty into certainty either. A direct argument can present a position for examination without turning it into his personal belief. Personal writing can remain unresolved without narrating every step of the conversation that produced it.

Hear The Whole Passage

Writing for the ear is part of developing the piece. Listen for how the words carry the thought, giving that attention more weight when the work will be spoken aloud. An “ear pass” names this editorial focus, not a separate workflow. The active writing workflow, such as page-writing or journal-writing, continues to own the conversation and edits.

Read connected passages at speaking speed and judge each sentence with what surrounds it. The four ear tests below guide attention, not a report to fill out. Hear what the writing is doing, then judge it by what this piece needs.

When a reaction reveals a mismatch, rehear the passage under that correction and revise at the scope it illuminates. Use the destination's exploration workflow when contrasting expressions would help; an authorized direct edit needs no options menu. Reread the changed passage in context to hear whether its movement and the author's posture still belong together. After a whole-piece pass, check that the opening, strongest concrete detail, and ending still serve the same thought.

For work intended to be heard, read spoken destinations for the extra judgments a listener's experience requires. Ordinary editing does not impose a narration or social-video standard on every piece.

Economy

Identify what each sentence or paragraph contributes: a claim, example, turn, qualification, emphasis, or the experience of discovering the thought. Try the deletion test: would removing it preserve meaning, movement, and human posture? Look for throat-clearing, doubled qualifiers, repeated explanations, generic connections, or abstract nouns a concrete verb could replace. A sentence can earn its time through hesitation, humor, contrast, or rhythm as well as new information. Cut unearned time, not simply words.

Rhythm

Listen for long clauses, stacked abstractions, repeated openings, awkward mouth-feel, false starts, and phrasing whose predictability drains its force. Hear where a breath naturally belongs and where emphasis lands. Split a sentence when it helps the listener follow, not merely to create short lines. A pause or repetition may build pressure, preserve uncertainty, or make a joke land. Judge the words before trying to fix the delivery or timing.

Movement and progressive disclosure

Trace what the reader or listener encounters in order and what each turn needs. An argument may explain a mechanism, a scene may accumulate particulars, and a question may stay open. An early conclusion can orient the reader; a later one can let the example earn its force. Choose the order this expression needs without imposing suspense, a moral, or a changed meaning at the end.

Human recognition

Ask: “Could the author genuinely have brought this to another person?” Hear whether the concrete details, odd phrasing, humor, uncertainty, and degree of judgment still belong to the author. Remove polish that makes the passage more solemn, certain, universal, or professionally scripted than its intended expression. Recognition matters more than grammatical perfection; shaping the writing should keep the person audible, including in newly discovered language.

Respect The Form

A message, essay, button, and technical explanation have different jobs. Let those jobs shape length and register while keeping the person audible. Clarity does not require 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.