Voice Profiler

What to ask for:

• "Paste 3-5 pieces of writing you're proud of. Emails, LinkedIn posts, proposals, website copy, tweets — anything that sounds like YOU at your best."
• If they have a file with samples: "Point me to a file with your writing and I'll analyze it."
• If $ARGUMENTS contains a file path, read that file for samples.

What to look for in samples:

1. Sentence rhythm — What's their natural cadence? Short-long-short? All punchy? Long and flowing?
2. Opening patterns — How do they start pieces? Cold open? Story? Question? Direct statement?
3. Closing patterns — How do they end? Call to action? Reflection? Punchline? Just stop?
4. Vocabulary fingerprint — Words they reach for repeatedly. Phrases that are distinctly theirs.
5. Grammar personality — Fragments? Run-ons? Perfect grammar? Contractions? Formal/informal mix?
6. Emotional range — Do they show humor? Frustration? Vulnerability? Confidence? What's the baseline?
7. Persuasion model — How do they convince? Data? Story? Authority? Diagnosis? Challenge?
8. Register shifts — Do they stay in one gear or shift between casual and formal?

Phase 2: Guided Questions

After analyzing samples, fill gaps with targeted questions. Only ask what you can't already see in the samples.

Identity & Context:

• "What do you do? How would you describe your role in one sentence?"
• "Who do you write for most often? (clients, colleagues, public audience, specific industry)"

Voice Preferences:

• "Are there words or phrases you HATE seeing in writing? Things that make you cringe?"
• "Any words or phrases that are distinctly yours — things people associate with how you communicate?"
• "When you read your own writing back, what makes you think 'yeah, that sounds like me'?"

Style Preferences:

• "Do you prefer short and punchy or detailed and thorough?"
• "How do you feel about humor in professional writing?"
• "Do you sign off a specific way? (signature, sign-off phrase, etc.)"

Anti-Patterns:

• "What kind of writing makes you physically uncomfortable? Corporate jargon? Fake enthusiasm? Over-qualification?"

Phase 3: Synthesis & Validation

Before generating the profile, play back what you've found:

"Here's what I see in your voice: [2-3 sentence summary]. Does that sound right, or am I missing something?"

Let them correct you. The profile should feel like looking in a mirror, not a caricature.

Output: The Voice Profile File

Generate the profile and write it to ~/.claude/voice-profile.md. Tell the user where it's saved and that /humanize will automatically load it.

Voice Profile Format

---