A Claude Code skill that writes in your voice, not AI's.
AI writing sounds like AI writing. It's generic, hedging, overstructured, and peppered with em dashes. You can spot it a mile away.
The issue isn't capability, it's context. AI doesn't know how you think, what you've lived, or why your perspective matters. So it defaults to the median.
Voice Writer captures your authentic writing voice through three reference files:
| File | What It Captures |
|---|---|
| style-guide.md | How you write: rhythms, patterns, structural preferences, what to avoid |
| worldview.md | Who you are: philosophy, domains, experience, what you care about |
| writing-principles.md | Frameworks you follow: POP method, storytelling, editing |
When you say "write this up" or "turn this into a post," Claude reads these files and writes as you, not as a generic AI assistant.
- Voice Discovery Interview: On first run, Claude walks you through a ~10 minute interview to build your voice profile. No blank-page problem.
- Raw-to-Polished Pipeline: Feed it voice memos, bullet points, rambling notes, or just a topic. Get back a draft that sounds like you wrote it.
- Self-Review Built In: Every draft comes with an honest assessment (what's working, what's weak, what questions would make it better) before you even look at it.
- Format-Aware: Knows the rules for blog posts, LinkedIn, X/Twitter, and email newsletters. Handles hook formulas, link placement, and platform-specific optimization.
- Living Voice: Your reference files live in your filesystem. Update them anytime and the skill adapts immediately.
git clone https://github.com/arcorren/voice-writer.git
cd voice-writer
chmod +x install.sh
./install.sh- Copy
skill/SKILL.mdto~/.claude/skills/writing/SKILL.md - Copy the three files from
templates/to~/.claude/writing/ - Open Claude Code and say "help me write about..." to trigger setup
The skill detects that your reference files still contain template placeholders and launches the Voice Discovery Interview:
- Claude asks about your background, philosophy, writing style, and audience
- You share examples of writing you're proud of
- Claude generates your three reference files from your responses
- You review and adjust until they feel right
This takes about 10 minutes and is the foundation for everything that follows.
- You provide raw material (voice memo, notes, topic, rough draft)
- Claude reads your reference files to load your voice
- Clarifies format and intent if needed
- Writes a first draft aimed at 80% quality
- Self-reviews using the CRIBS framework (Confusing, Repeated, Insightful, Boring, Surprising)
- Presents the draft with an honest assessment and specific questions
- Iterates based on your feedback
Most AI writing tools optimize for output. This one optimizes for voice.
The reference files act as a perspective layer. They give Claude the context to write things only you could write. Not because it's mimicking your words, but because it understands your worldview, your domains, and the patterns that make your writing yours.
Your voice files live at ~/.claude/writing/ by default. Edit them directly anytime:
- style-guide.md: Add new voice characteristics, update structural preferences, note patterns to avoid
- worldview.md: Evolve your philosophy, add new domains, update your background as it changes
- writing-principles.md: Add frameworks that resonate, remove ones that don't
By default, drafts are presented in the conversation. To save drafts to a specific directory, update the output path in ~/.claude/skills/writing/SKILL.md.
| Format | Typical Length | Key Features |
|---|---|---|
| Blog Posts | 800-2000 words | Section headers, problem/solution/vision structure |
| LinkedIn Posts | 200-400 words | Hook optimization, link-in-comments strategy |
| X/Twitter | 70-280 chars / 3-7 tweet threads | Thread formatting, engagement hooks |
| Email Newsletters | 2-4 paragraphs | Teaser format, CTA optimization |
| Essays | 2000+ words | Deep argumentation, philosophical depth |
- Claude Code installed and configured
Found a way to make the skill better? PRs welcome. The goal is a writing skill that helps anyone sound like themselves, not like AI.
MIT