write-like-me

Analyze your writing style and teach Claude to write like you.

write-like-me reads your writing samples (text files, Word documents, PDFs), extracts a detailed style profile covering voice, cadence, diction, framing, and more, then installs Claude Code skills so Claude can write in your style.

Install

# Recommended: pipx (isolated venv, binary on PATH)
pipx install write-like-me

# Alternative: uv
uv tool install write-like-me

# Alternative: manual venv
python3 -m venv ~/.local/share/write-like-me/.venv
~/.local/share/write-like-me/.venv/bin/pip install write-like-me

# Development
git clone https://github.com/your-user/write-like-me.git
cd write-like-me
pip install -e ".[dev]"

Quick start

# 1. Install the Claude Code skills
write-like-me install-skill

# 2. In Claude Code, analyze your writing
#    /analyze-my-writing ~/my-writing/

# 3. Then use your style
#    /write-like-me Write a blog post about why remote work is overrated

# 4. (Optional) Use named profiles for different voices
#    /analyze-my-writing ~/academic-papers/ --profile academic
#    /write-like-me --profile academic Write an abstract for my paper

Try it out

A sample essay is included at tests/fixtures/sample.txt so you can test the full flow without using your own writing:

/analyze-my-writing tests/fixtures/sample.txt
/write-like-me Write a short essay about why nobody talks about tea honestly

How it works

Two Claude Code skills work together:

1. /analyze-my-writing <path> — parses your writing samples (txt, md, docx, pdf), then Claude analyzes your style directly and produces a profile. No API key needed — uses your existing Claude Code subscription.

2. /write-like-me <prompt> — loads your style profile and writes in your voice.

The tool handles document parsing (extracting text from Word docs, PDFs, etc.) while Claude Code handles the actual style analysis. This means you don't need a separate Anthropic API key.

Commands

write-like-me install-skill

Install both /analyze-my-writing and /write-like-me skills into Claude Code.

write-like-me install-skill

The installer auto-detects whether write-like-me is on PATH (pipx/uv) or in a manual venv, and writes the correct binary path into the skills.

write-like-me show

Display the current style profile.

write-like-me show                     # pretty-printed
write-like-me show --json              # raw JSON
write-like-me show --profile academic  # named profile

write-like-me profiles

List all named profiles.

write-like-me profiles

write-like-me analyze <path>

Direct CLI analysis without Claude Code. Requires an Anthropic API key or falls back to basic NLP heuristics.

write-like-me analyze ~/my-writing/ --api-key sk-...
write-like-me analyze ~/my-writing/ --no-api       # NLP fallback
write-like-me analyze ~/more/ --append             # incremental update
write-like-me analyze ~/papers/ --profile academic # named profile

Most users should prefer /analyze-my-writing in Claude Code instead — it produces better results and doesn't require an API key.

write-like-me parse <path>

Extract text from writing samples as JSON. Used internally by the /analyze-my-writing skill.

Supported formats: .txt, .md, .docx, .pdf

write-like-me save-profile <json-file>

Save a profile JSON file. Used internally by the /analyze-my-writing skill.

Style profile

The default profile lives at ~/.local/share/write-like-me/style-profile.json. Named profiles live at ~/.local/share/write-like-me/profiles/<name>/style-profile.json.

The profile contains:

• Voice: perspective, tone, formality, emotional register
• Syntax: sentence structure, paragraph patterns, active/passive ratio
• Cadence: rhythm, transitions, pacing
• Diction: vocabulary level, word preferences, distinctive words, avoidances
• Framing: argument structure, openings, closings, use of examples
• Stylistic signatures: punctuation habits, rhetorical devices, quirks

All fields are natural-language descriptions — not numeric scores — because Claude acts better on qualitative instructions.

Named profiles

Use --profile <name> to maintain separate style profiles for different types of writing:

write-like-me analyze ~/papers/ --profile academic
write-like-me analyze ~/blog/ --profile casual
write-like-me show --profile academic
write-like-me profiles   # list all

In Claude Code:

/analyze-my-writing ~/papers/ --profile academic
/write-like-me --profile academic Write an abstract for my paper

Without --profile, all commands use the default profile. The two modes are independent.

Incremental updates

Run /analyze-my-writing ~/more-writing/ and tell Claude to update the existing profile. The skill reads the current profile and merges new evidence with existing patterns.

From the CLI, use --append to skip already-analyzed files (tracked by file hash in the profile's manifest).

License

MIT