hermes

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.

context

"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.

task

Build a voice profile from these samples.

writing samples

Only if [TEST_TOPIC] is given: Test topic:

  1. 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.
  1. 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).
  1. 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").
  2. 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.
  3. 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.
  4. Annotate the test paragraph briefly: which traits it demonstrates.
constraints
  • 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.
output format

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

Edit on GitHubReport a problem

use in

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

The plugin brings every entry in this domain at once.

pairs well with

All of Editing
PromptEmail

Build 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-templates
PromptEditing

Line-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-prose
PromptEditing

Remove 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-tics
PromptEditing

Proofread 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-text
PromptEditing

Rewrite 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-tone
PromptEditing

Simplify 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