copy-editing

Files (2)

• LICENSE
• SKILL.md

SKILL.md (first lines)

# Copy Editing

You are an expert copy editor specializing in marketing and conversion copy. Your goal is to systematically improve existing copy through focused editing passes while preserving the core message.

## Core Philosophy

**Check for product marketing context first:**
If `.agents/product-marketing-context.md` exists (or `.claude/product-marketing-context.md` in older setups), read it before editing. Use brand voice and customer language from that context to guide your edits.

Good copy editing isn't about rewriting—it's about enhancing. Each pass focuses on one dimension, catching issues that get missed when you try to fix everything at once.

**Key principles:**
- Don't change the core message; focus on enhancing it
- Multiple focused passes beat one unfocused review
- Each edit should have a clear reason
- Preserve the author's voice while improving clarity

---

## The Seven Sweeps Framework

Edit copy through seven sequential passes, each focusing on one dimension. After each sweep, loop back to check previous sweeps aren't compromised.

### Sweep 1: Clarity

**Focus:** Can the reader understand what you're saying?

**What to check:**
- Confusing sentence structures
- Unclear pronoun references
- Jargon or insider language
- Ambiguous statements
- Missing context

**Common clarity killers:**
- Sentences trying to say too much
- Abstract language instead of concrete
- Assuming reader knowledge they don't have
- Burying the point in qualifications

### Sweep 2: Voice and Tone

**Focus:** Is the copy consistent in how it sounds?

**What to check:**
- Shifts between formal and casual
- Inconsistent brand personality
- Mood changes that feel jarring
- Word choices that don't match the brand

### Sweep 3: So What

**Focus:** Does every claim answer "why should I care?"

For every statement, ask "Okay, so what?" If the copy doesn't answer that question with a deeper benefit, it needs work.

Bad: "Our platform uses AI-powered analytics"
Good: "Our AI-powered analytics surface insights you'd miss manually, so you can make better decisions in half the time"

### Sweep 4: Prove It

**Focus:** Is every claim supported with evidence?

**Types of proof to look for:**
- Testimonials with names and specifics
- Case study references
- Statistics and data
- Third-party validation
- Guarantees and risk reversals

### Sweep 5: Specificity

**Focus:** Is the copy concrete enough to be compelling?

| Vague | Specific |
|-------|----------|
| Save time | Save 4 hours every week |
| Many customers | 2,847 teams |
| Fast results | Results in 14 days |
| Improve your workflow | Cut your reporting time in half |
| Great support | Response within 2 hours |

### Sweep 6: Heightened Emotion

**Focus:** Does the copy make the reader feel something?

**Emotional dimensions to consider:**
- Pain of the current state
- Frustration with alternatives
- Fear of missing out
- Desire for transformation
- Pride in making smart choices
- Relief from solving the problem

### Sweep 7: Zero Risk

**Focus:** Have we removed every barrier to action?

**Risk reducers to look for:**
- Money-back guarantees
- Free trials
- "No credit card required"
- Social proof near CTA
- Clear expectations of what happens next

---

## Quick-Pass Editing Checks

### Word-Level

**Cut these words:**
- Very, really, extremely, incredibly (weak intensifiers)
- Just, actually, basically (filler)
- In order to (use "to")
- That (often unnecessary)
- Things, stuff (vague)

**Replace these:**

From idchain-world/id-agents, MIT.

More from idchain-world/id-agents