
voice-matching-wizard
Transform writing samples into a codified voice style that can be replicated consistently. This wizard guides you through analyzing samples, extracting patterns, and generating a custom voice skill.
- Installs
- 40
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/cdeistopened/skill-stack --skill voice-matching-wizard- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads voice-matching-wizard automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Voice Matching Wizard
Create a voice skill that captures the patterns, rhythms, and sensibilities of any writing style.
What This Does
Voice matching is the art of identifying what makes writing recognizable. Not just the obvious markers—vocabulary, sentence length—but the deeper patterns: how ideas unfold, where the writer pauses, what they leave unsaid.
This wizard walks you through the process of:
- Gathering representative samples
- Extracting patterns across multiple dimensions
- Synthesizing a usable voice profile
- Generating a working skill file
The output is a voice-[name].skill.md you can use alongside other skills (like anti-ai-writing) for consistent, authentic content.
Before You Begin
What makes a good sample:
- At least 500 words
- Writing you're proud of (or writing you want to emulate)
- Representative of the voice you want to capture
- From the same medium (all newsletters, all blog posts, etc.)
What to avoid:
- Heavily edited committee writing
- Content written under constraints
- Mixed formats (tweets + longform together)
- Very old work that doesn't reflect current voice
How many samples:
- 2-3 samples: Basic patterns
- 4-5 samples: Good coverage
- 10+: Comprehensive capture
Three Paths Through This Wizard
Path A: "I have samples of my own writing"
You want to codify your existing voice so AI can match it consistently. → Skip to Phase 1: Gather Your Samples
Path B: "I want to write like [someone I admire]"
You want to emulate an author, publication, or brand voice. → If the writer is well-known (major author, publication), you may be able to use their name directly in prompts. For custom or lesser-known voices, you'll still need samples. → Proceed to Phase 1: Gather Your Samples
Path C: "I'm not sure what my voice is yet"
You want to discover and develop your voice through this process. → Start with Phase 0: Voice Discovery (below)
Phase 0: Voice Discovery (Optional)
Skip this if you already have samples or know what voice you want.
To discover your voice, we need to understand how you naturally communicate when you're not performing.
Answer these questions:
-
How do you explain things to friends?
- Do you use stories and examples?
- Do you build logical arguments?
- Do you make jokes?
- Do you ask questions to draw them in?
-
What writers or publications do you gravitate toward?
- Not who you think you should read—who do you actually read?
- What about their style appeals to you?
-
What's your natural sentence length?
- Short and punchy?
- Long and flowing?
- Variable depending on the point?
-
How do you feel about jargon?
- Love it (signals expertise)?
- Hate it (pretentious)?
- Use it sparingly when precise?
-
What's your relationship with your reader?
- Peer/friend?
- Mentor/teacher?
- Curious explorer?
Based on your answers, find 2-3 pieces you've written that feel authentic. Use those for Phase 1.
Phase 1: Gather Samples
Collect 2-5 writing samples. Paste each one into a separate document, or note where they can be found.
For each sample, note:
- Source/context (blog post, newsletter, etc.)
- When it was written
- Why you chose it
Phase 2: Extract Patterns
Analyze each sample across these dimensions:
2.1 Sentence Architecture
| Element | What to Look For |
|---|---|
| Length | Average sentence length (short/medium/long) |
| Variation | Does length vary deliberately for rhythm? |
| Complexity | Simple declarative? Compound? Complex? |
| Punctuation | Em dashes? Semicolons? Minimal? |
| Fragments | Used for emphasis? Never? |
Signature structures to identify:
- Opening patterns ("Here's the thing:")
- Rhythm breaks ("But.")
- List patterns ("First... Second... Third...")
- Closing moves (questions, callbacks, calls to action)
2.2 Word Choice
| Element | What to Look For |
|---|---|
| Vocabulary level | Simple/moderate/sophisticated |
| Formality | 1-5 scale (casual to formal) |
| Contractions | Always/sometimes/never |
| Jargon | Industry terms? Avoided? |
| Strong language | Profanity level/style if any |
Identify:
- Favorite words (appears 3+ times across samples)
- Avoided words (never appears despite opportunity)
- Signature phrases
2.3 Tone & Attitude
| Element | What to Look For |
|---|---|
| Emotional register | Warm? Cool? Intense? Measured? |
| Reader relationship | Peer? Mentor? Friend? Expert? |
| Humor style | Sarcasm? Wordplay? Self-deprecation? None? |
| Certainty level | Definitive or exploratory? |
| Attitude toward subject | Passionate? Skeptical? Curious? |
2.4 Structural Moves
| Element | What to Look For |
|---|---|
| Openings | Story? Question? Bold claim? Scene-setting? |
| Transitions | Seamless? Signposted? Abrupt? |
| Closings | Call to action? Question? Summary? Callback? |
| Paragraph length | Short punchy? Long flowing? Mixed? |
2.5 Distinctive Techniques
What makes this voice recognizable?
- Rhetorical devices (questions, analogies, callbacks)
- Signature moves unique to this writer
- How evidence is presented (data? anecdotes? logic?)
- Pattern interrupts (how does the writer surprise?)
2.6 What They DON'T Do
Just as important:
- Phrases never used
- Structures avoided
- Topics skipped
- Formality levels never hit
Phase 3: Synthesize
The Voice in One Paragraph
Write a single paragraph capturing the essence:
"[Name]'s voice is [primary characteristics]. They write like [relationship to reader], using [key techniques]. Their tone is [tone], with [humor style if applicable]. Sentences tend to be [structure]. They favor [word choice] and avoid [avoidances]. The overall effect is [feeling/impact]."
Voice Spectrum
Rate the voice on these scales (1-5):
Formal ←――――――――――→ Casual [ ]
Expert ←――――――――――→ Peer [ ]
Serious ←―――――――――→ Playful [ ]
Reserved ←――――――――→ Opinionated [ ]
Abstract ←――――――――→ Concrete [ ]
Phase 4: Generate the Voice Skill
Using your analysis, create voice-[name].skill.md with this structure:
---
name: voice-[name]
description: Write in [Name]'s distinctive voice. [One sentence characterization]. Use with anti-ai-writing for authentic content.
---
# Voice: [Name]
[Your one-paragraph voice description from Phase 3]
## Voice Spectrum
- Formal/Casual: [1-5]
- Expert/Peer: [1-5]
- Serious/Playful: [1-5]
- Reserved/Opinionated: [1-5]
- Abstract/Concrete: [1-5]
## Core Characteristics
### Sentence Architecture
[Your findings from 2.1]
### Word Choice
[Your findings from 2.2]
### Tone & Attitude
[Your findings from 2.3]
### Structural Moves
[Your findings from 2.4]
### Distinctive Techniques
[Your findings from 2.5]
### Avoidances
[Your findings from 2.6]
## Example Patterns
### Signature Openings
[3-5 examples from samples with pattern explanation]
### Signature Transitions
[3-5 examples]
### Signature Closings
[3-5 examples]
### Signature Sentences
[5-10 exemplary sentences that capture the voice]
## The [Name] Test
Before publishing, ask:
- [ ] Would [Name] actually write this sentence?
- [ ] Does it match the voice spectrum above?
- [ ] Are signature patterns present?
- [ ] Are avoidances absent?
- [ ] Does it *feel* right?
## Anti-Patterns
If you see these, you've drifted from the voice:
- [List 5-10 patterns that would violate this voice]
Phase 5: Validate
Test your voice skill:
- Write a short piece using only the voice skill
- Compare to original samples
- Identify gaps or mischaracterizations
- Refine based on testing
Validation checklist:
- Voice description captures the essence
- Spectrum ratings feel accurate
- Example patterns are genuinely representative
- Test output sounds like the samples
- Nothing important was missed
Human Writing Fundamentals
Every voice skill should build on these principles from anti-ai-writing.
The Energy Transfer Principle
The best writing is a transfer of energy from writer to reader. When analyzing samples, notice how the writer transfers energy:
- Do they write conversations or speeches?
- Do they speak WITH their audience or AT them?
- Where do they use specific, concrete language vs. abstract ideas?
The SUCKS Framework
Apply this when generating voice output:
S - Specific: Who is the ONE reader? U - Unique & Useful: Does it change how they think, feel, or act? C - Clear, Curious, Conversational: Does it read like talking to a friend? K - Kept Simple & Structured: Simple ideas, clear structure? S - Sticky: Are there memorable phrases they'll repeat?
Sticky Sentence Techniques
When identifying signature sentences in Phase 2, look for these techniques:
Alliteration — Same starting sounds
- "Specificity is the secret"
- "The best jobs are neither decreed nor degreed"
Symmetry — Parallel structure
- "Read for awareness. Write for understanding."
- "It's not 10,000 hours. It's 10,000 iterations."
Contrast — Opposing ideas
- "To be everywhere is to be nowhere."
- "Be clear, not clever. Concise, not complex."
Rhythm — Pleasing cadence
- Sentence length variation for effect
- Short sentences for emphasis
- Longer sentences for flow
Include the writer's use of these techniques in your voice skill.
AI Tells to Eliminate
When using your voice skill, watch for these patterns that signal AI involvement:
The Correlative Construction (most common):
- ❌ "X aren't just Y - they're Z"
- ❌ "It's not about X, it's about Y"
Forbidden Openers:
- ❌ "In the ever-evolving world of..."
- ❌ "Gone are the days when..."
- ❌ "Let that sink in"
Hedging Language:
- ❌ "This might help you" → "This will help you"
- ❌ "It could be argued..." → state it directly
Overused Softeners:
- Too much "just" and "actually"
- Passive voice ("was determined")
- Corporate jargon
Test: For each sentence, ask: Would this appear in ChatGPT output? If yes, rewrite it.
Using Your Voice Skill
Save to: .claude/skills/voice-[name]/SKILL.md
Invoke alongside other skills:
voice-[name]+anti-ai-writing= Authentic, humanized contentvoice-[name]+ghostwriter= Long-form pieces in voicevoice-[name]+social-content-creation= Platform-specific posts
Update as needed: Your voice evolves. Revisit the skill quarterly or when something feels off.
Related Skills
- anti-ai-writing — Core humanization engine (use with all voice work)
- ghostwriter — For long-form content in someone else's voice
- transcript-polisher — For interview-based content
One well-crafted voice skill compounds across everything you create.
FAQ
What does the voice-matching-wizard skill do?
Transform writing samples into a codified voice style that can be replicated consistently. This wizard guides you through analyzing samples, extracting patterns, and generating a custom voice skill.
How do I install voice-matching-wizard?
Run npx skills add https://github.com/cdeistopened/skill-stack --skill voice-matching-wizard in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/voice-matching-wizard/ (personal) or .claude/skills/voice-matching-wizard/ (project).
Which AI agents can use voice-matching-wizard?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is voice-matching-wizard safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains voice-matching-wizard?
It is published by cdeistopened in cdeistopened/skill-stack. It has 40 recorded installs.
More from cdeistopened/skill-stack
youtube-scriptwriting
cdeistopened/skill-stack
Transform raw ideas and brain dumps into polished YouTube scripts through a structured checkpoint workflow. Use when the user wants to write a YouTube script, improve video retention, craft hooks, structure educational or entertainment content, or turn source material (transcripts, notes, research) into a compelling video script. Guides through research, hook writing, story structure, body content, and editing phases.
image-prompt-generator
cdeistopened/skill-stack
Generate AI images using Gemini image generation API. Use this skill when content needs images - thumbnails, social posts, blog headers, or creative visuals. Follows an iterative workflow - brainstorm concepts, select direction, generate in multiple styles, then produce via API.
anti-ai-writing
cdeistopened/skill-stack
Open the skill to read its SKILL.md instructions.
amazon-category-research
cdeistopened/skill-stack
Research profitable Amazon KDP categories for book publishing. Use when planning a book launch, analyzing competition, or optimizing category selection for discoverability.
hook-and-headline-writing
cdeistopened/skill-stack
Open the skill to read its SKILL.md instructions.
ghostwriter
cdeistopened/skill-stack
Master the art of converting source material into authentic, human-written content. Transform transcripts, notes, and research into polished prose that avoids AI tells while maintaining distinctive voice. Combines anti-AI writing fundamentals with voice style adaptation.
Popular media & creative skills
hyperframes
heygen-com/hyperframes
Read first to make, edit, animate or render any video with HyperFrames (HTML rendered to video), including launch films, explainers, music videos, charts, maps, vertical clips, title cards, captions and overlays. Holds the render contract, the work loop and what each kind of video needs.
media-use
heygen-com/hyperframes
Get or make any media for a HyperFrames video - music, sound effects, images, icons, logos, voiceover, avatar and generated video, transcripts, cutouts, colour grades and looks - with HeyGen or free local tools, and mix placed audio. Also for footage that looks dark, flat or dull, or should be stylized or hidden.
hyperframes-registry
heygen-com/hyperframes
About 450 ready-made HyperFrames blocks and components installed as editable source - transitions, overlays, titles, kinetic type, captions, charts, map overlays, 3D, camera moves. Use it before hand-building any named visual (CRT scanlines, glitch, film grain, a chart); also for hyperframes add and catalog.
hyperframes-creative
heygen-com/hyperframes
Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use hyperframes-animation.
ai-video-generation
101-skills/superpowers
Generate AI videos with Google Veo, Seedance 2.0, HappyHorse, Wan, Grok and 40+ models via inference.sh CLI. Models: Veo 3.1, Veo 3, Seedance 2.0, HappyHorse 1.0, Wan 2.5, Grok Imagine Video, OmniHuman, Fabric, HunyuanVideo. Capabilities: text-to-video, image-to-video, reference-to-video, video editing, lipsync, avatar animation, video upscaling, foley sound. Use for: social media videos, marketing content, explainer videos, product demos, AI avatars. Triggers: video generation, ai video, text to video, image to video, veo, animate image, video from image, ai animation, video generator, generate video, t2v, i2v, ai video maker, create video with ai, runway alternative, pika alternative, sora alternative, kling alternative, seedance, happyhorse
ai-image-generation
101-skills/superpowers
Generate AI images with GPT-Image-2, FLUX, Gemini, Grok, Seedream, Reve and 50+ models via inference.sh CLI. Models: GPT-Image-2, FLUX Dev LoRA, FLUX.2 Klein LoRA, Gemini 3 Pro Image, Grok Imagine, Seedream 4.5, Reve, ImagineArt. Capabilities: text-to-image, image-to-image, inpainting, LoRA, image editing, upscaling, text rendering. Use for: AI art, product mockups, concept art, social media graphics, marketing visuals, illustrations. Triggers: flux, image generation, ai image, text to image, stable diffusion, generate image, ai art, midjourney alternative, dall-e alternative, text2img, t2i, image generator, ai picture, create image with ai, generative ai, ai illustration, grok image, gemini image, gpt image, openai image, chatgpt image