Skip to content

Latest commit

 

History

10 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Voice Editor

A Claude Code skill for editing AI-generated content to match your voice profile.

License: MIT Claude Code Plugin

Voice Editor

This skill provides a systematic 6-pass editing workflow to transform generic AI output into voice-matched writing.

Why

AI output often sounds generic even with good prompts. The result:

  • Content that reads like it was written by a committee
  • Loss of your distinctive voice and personality
  • Readers noticing "this doesn't sound like you"
  • Heavy editing required to make it authentic

Install

# In Claude Code:
/plugin marketplace add aplaceforallmystuff/marketplace
/plugin install claude-voice-editor@aplaceforallmystuff
Manual install (without the marketplace)
git clone https://github.com/aplaceforallmystuff/claude-voice-editor.git
cp -r claude-voice-editor/skills/voice-editor ~/.claude/skills/

Use cases

  • Use it when AI-generated content sounds generic and you want it to read as yours.
  • Use it when a draft needs to sound more like you.
  • Use it when applying a VOICE.md profile to a draft.
  • Use it when content is close to your voice and needs a light polish (light mode).
  • Use it when rescuing generic AI output written without a style guide (heavy or rescue mode).

How it works

The skill applies six editing passes to any content:

Pass Focus What It Does
1. Structure Organization Fix openings, flow, conclusions
2. Voice Profile matching Align with VOICE.md characteristics
3. Slop AI tells Remove generic phrases and patterns
4. Specificity Depth Replace generic with specific
5. Rhythm Flow Read-aloud test, sentence variation
6. Authenticity Final check "Would readers recognize this as mine?"

The 30-40% Rule

Even with a perfect style guide, expect to edit 30-40% of AI output. This isn't a bug - it's the feature.

  • If editing >50%: Your style guide or prompts need work
  • If editing <20%: You might be accepting too much generic content
  • 30-40% is the sweet spot: Significant time savings while maintaining voice

Editing Modes

Mode When to Use Expected Edit %
Light Content close to voice, needs polish 10-20%
Standard Typical AI output with style guide 30-40%
Heavy Generic AI, no style guide used 50-70%
Rescue Fundamentally off but has good bones Rewrite

Common Problems Fixed

Problem Symptom Fix Applied
Too formal Reads like a memo Add contractions, conversational asides
Too uniform Same sentence lengths Vary rhythm deliberately
Too hedged Everything qualified Delete vague hedging, commit to claims
Too balanced All sections equal weight Let structure reflect priorities
Voice drift Starts strong, gets generic Re-inject voice markers throughout

Example

Ask Claude to run the skill on a draft:

Edit this to match my voice: drafts/launch-post.md

Illustrative output:

## Edited Content

[Your edited content here]

---

## Edit Summary

**Passes completed:** 6/6
**Estimated edit percentage:** 35%
**Voice match confidence:** High

### Major Changes
1. Cut throat-clearing intro, started with the core insight
2. Added characteristic phrase "Here's the thing"
3. Broke uniform sentence lengths into varied rhythm

### Slop Removed
- "It's worth noting that" (3 instances)
- "In today's landscape" (1 instance)
- Staccato fragment spam (paragraphs 2, 5)

### Voice Elements Added
- Conversational asides
- Specific examples replacing generic claims
- Characteristic humor in closing

Configuration

You need a VOICE.md profile. Create one with the companion skill:

Related Skills

This skill works best as part of a workflow:

[Draft] → slop-detector → voice-editor → slop-detector → [Final]

Part of the aplaceforallmystuff skills collection:

License

MIT — see LICENSE.

About

A Claude Code skill for editing AI-generated content to match your voice profile

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages