Capture a writing voice profile
Analyses samples of a person's writing into a reusable voice profile of sentence habits, vocabulary, tone, structure and dos and don'ts, then drafts a test paragraph in that voice.
"Write in my voice" fails when the voice is described with adjectives ("friendly, professional, witty") that fit everyone. A usable voice profile describes observable habits with evidence: how long the sentences are and how they vary, how paragraphs open, which words recur and which never appear, how the person handles certainty, humour, numbers and disagreement, and what formatting they use. It distinguishes stable traits (present across samples) from situation-specific ones (only in their tweets). A profile like this can be pasted into any assistant, given to a ghostwriter or editor, and checked: a test paragraph either sounds like the person or it does not.
Build a voice profile from these samples.
Only if [TEST_TOPIC] is given: Test topic:
- Check the samples before analysing them:
- Under about 100 words in total, or no samples at all: say a profile cannot be built from so little, ask for three to five pieces of at least 150 words each from different situations, and stop.
- About 100 to 400 words, or only one kind of writing: build the profile, mark it provisional at the top of Voice profile and under Confidence, and say which samples would sharpen it.
- Signs of several authors (different sign-offs, clashing spelling or register): ask whether they are all by one person before treating differences as range, and profile only the samples that clearly share a writer.
- Analyse and quote evidence for each dimension:
- Sentence habits: typical length and range, variety, favourite openings, use of fragments, questions, lists, parentheses, dashes.
- Vocabulary: register, signature words and phrases, jargon level, words or phrases they avoid (for example no corporate buzzwords), contractions, spelling variety.
- Tone and stance: directness, warmth, humour (type and frequency), how they hedge or assert, how they handle disagreement or bad news, use of "I" and "you".
- Structure: how pieces open and close, paragraph length, use of headings, examples, stories and numbers.
- Mechanics and formatting: punctuation quirks, emoji, capitalisation, bold, line breaks. Mark each trait as stable (in most samples) or situational (name the situation).
- Write a do and don't list of eight to twelve concrete rules ("Do open with the point, often a one-line sentence"; "Don't use exclamation marks except in thanks").
- Write compact voice instructions (under about 200 words) that can be pasted into any assistant or handed to a writer: second person, concrete rules, two short quoted examples from the samples.
- Draft a test paragraph of about 120 words on the test topic (or a topic close to the samples) in the voice. Do not reuse distinctive sentences from the samples verbatim; the test is whether the habits transfer.
- Annotate the test paragraph briefly: which traits it demonstrates.
- Every trait must be backed by a quote or a count from the samples; no trait from general impressions.
- Describe the voice, do not judge it. Do not "improve" it in the profile.
- If the samples contain personal details about the writer or others, do not repeat them in the instructions or the test paragraph.
- Do not imitate a specific public figure's voice from your own knowledge; work only from the samples.
Voice profile
Subsections for each dimension in step 2, with quoted evidence and stable or situational marks, then the do and don't list.
Voice instructions
The pasteable block, in a quote or code block.
Test paragraph
The paragraph, then two or three bullets on the traits it shows.
Confidence
A rating (low under about 400 words or one genre; moderate for 400 to 1,500 words across two or more genres; high above that across three or more), the word count and genres covered, the traits that are uncertain, and what extra samples would sharpen the profile.
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
- Writing and communication
- category
- Editing
- level
- Intermediate
- made for
- Writer / author, Content creator, Copywriter, Founder / business owner
- risk
- read-only
- version
- v1.1.0 · incubating
- reviewed
- 2026-10-03
- 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 capture-writing-voice --target claude-codenpx skills add hermes-hq/hodios-dist --skill capture-writing-voice -a claude-codeclaude plugin marketplace add hermes-hq/hodios-distclaude plugin install hodios-writing-communication@hodiosThe plugin brings every entry in this domain at once.
pairs well with
All of EditingBuild a personal email template library
Builds a personal library of reusable email templates for the user's recurring situations, in their own voice from sent examples, with placeholders, subject lines and when-to-use notes.
build-email-templatesLine-edit prose
Line-edits fiction or non-fiction prose for rhythm, precision, word choice and sentence variety while preserving the author's voice, showing each edit with a brief reason and the habits behind them.
line-edit-proseRemove machine-sounding writing tics
Edits machine-sounding text by removing stock phrases, empty intensifiers, formulaic structures and over-hedging, keeping the author's meaning and facts, and matching a voice sample if given.
remove-ai-writing-ticsProofread a text
Corrects grammar, spelling, punctuation and consistency errors in the chosen English variety, preserving the author's voice, and lists each change with the rule behind it.
proofread-textRewrite a text for tone
Rewrites a text in a target tone or register, such as warmer, firmer or more formal, without changing its facts, asks or commitments, and shows which tone dials moved.
rewrite-for-toneSimplify a text to plain language
Rewrites a text in plain language at a target reading level while keeping every fact, obligation, right, deadline and condition intact, and shows a meaning check against the original.
simplify-to-plain-language