Voice calibration

Skill raulpetruta/voice-calibration-plugin/skills/voice-calibration

AI voice calibration plugin that learns your writing style through guided prompts and generates a reusable voice profile so agents can write more like you across tools and workflows.

Install

npx -y skills add raulpetruta/voice-calibration-plugin --skill voice-calibration

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

11 stars11 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Learns a user's personal writing and speaking style through interactive writing prompts, then generates a reusable voice profile. Use when the user says "learn my writing style," "write like me," "capture my voice," "voice calibration," "mimic my tone," "my writing style," or wants AI to match their personal communication style. Also activates when a .voice-profile.md file exists and the user asks you to write something in their voice.

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

5.2 KB, as published. Nobody here has run it

Voice Calibration

Learn to write and talk like a specific person by collecting writing samples through interactive prompts, analyzing stylistic patterns, and generating a reusable voice profile.

Two Modes

1. Calibration Mode

Run when the user wants to create or update their voice profile. Guide them through writing prompts, analyze the results, and generate a profile.

2. Application Mode

When a voice profile exists (.voice-profile.md in the project root or ~/.claude/voice-profile.md), read it and apply the style to your writing when the user asks you to write in their voice.

Calibration Workflow

Follow these five phases in order. Present one prompt at a time and wait for the user's response before continuing.

Phase 1: Introduction

Explain the process briefly:

I'll give you a series of short writing prompts — tiny stories, opinions, casual messages, descriptions. Write naturally, exactly how you'd normally express yourself. There are no wrong answers.

How many prompts would you like? I recommend 8-10 for a solid profile, but we can do as few as 6 or as many as 12.

Also ask:

What name should the profile use?
Any languages or registers to capture? (e.g., "I code-switch between English and Spanish")

Phase 2: Writing Prompts

Read references/PROMPTS.md for the full prompt bank.

Selection rules:

Pick prompts from at least 4 different categories to capture range
Always include at least one from Casual Conversation and one from Opinions & Arguments — these reveal the most personality
Present prompts one at a time
After the user responds, acknowledge briefly and move to the next prompt — do not analyze or comment on their style mid-flow
If a user's response is very short (under 20 words), gently ask them to expand: "Could you add a bit more? Even a few extra sentences help me pick up on your patterns."

Phase 3: Analysis

Once all samples are collected, read references/ANALYSIS-GUIDE.md and analyze every sample against each dimension listed there.

Work through the analysis silently. Do not show the user a dimension-by-dimension breakdown — just use it internally to inform the profile.

Phase 4: Profile Draft

Read references/PROFILE-TEMPLATE.md and generate a complete voice profile.

For reference on what a finished profile looks like, see examples/example-profile.md.

Present the draft to the user and ask:

Here's your voice profile. Read through it and let me know:

Does anything feel off or not like you?

Is there anything about your style I missed?

Any sections you'd change?

Phase 5: Refinement & Save

Incorporate the user's feedback. Then save the profile:

Default location: .voice-profile.md in the current project root
Global location: ~/.claude/voice-profile.md (if the user wants it available across projects)
Ask the user which they prefer

Confirm the save and explain how to use it:

Your voice profile is saved. From now on, when you ask me to write something in your voice, I'll read this profile and match your style. You can update it anytime by running voice calibration again.

Application Mode

When the user asks you to write in their voice and a voice profile exists:

Read the .voice-profile.md file (check project root first, then ~/.claude/)
Internalize the style dimensions — especially Sample Phrases, Tone & Personality, and What to Avoid
Write the requested content matching the profiled style
Do not mention the profile or call attention to the style matching — just write naturally in their voice

If no profile exists and the user asks you to write in their voice, suggest running calibration first.

Updating a Profile

If the user already has a profile and wants to update it:

Ask if they want to start fresh or add more samples to refine the existing profile
For refinement: present 3-4 new prompts, re-analyze with the new + original samples combined
For fresh start: run the full calibration workflow again

Tips for Quality

The more varied the prompts, the better the profile. A user who only writes micro-stories will get a profile biased toward narrative style.
Pay special attention to what makes this person's writing distinctive — not generic traits like "uses complete sentences."
The What to Avoid section is critical. It prevents the uncanny valley of almost-right style matching.
Capture specific phrases and constructions, not just abstract descriptions. "Tends to start sentences with 'Look,'" is more useful than "somewhat direct."