Copy editing skill

When the user wants to edit, review, or improve existing marketing copy.

by davila7·MIT license·★ 32,299 Stars on the repo·GitHub ↗

Use now

Files of Copy editing

davila7/main1 file shown
SKILL.md
Show the full text440 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

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

Process:

  1. Read through quickly, highlighting unclear parts
  2. Don't correct yet—just note problem areas
  3. After marking issues, recommend specific edits
  4. Verify edits maintain the original intent

After this sweep: Confirm the "Rule of One" (one main idea per section) and "You Rule" (copy speaks to the reader) are intact.


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

Common voice issues:

  • Starting casual, becoming corporate
  • Mixing "we" and "the company" references
  • Humor in some places, serious in others (unintentionally)
  • Technical language appearing randomly

Process:

  1. Read aloud to hear inconsistencies
  2. Mark where tone shifts unexpectedly
  3. Recommend edits that smooth transitions
  4. Ensure personality remains throughout

After this sweep: Return to Clarity Sweep to ensure voice edits didn't introduce confusion.


Sweep 3: So What

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

What to check:

  • Features without benefits
  • Claims without consequences
  • Statements that don't connect to reader's life
  • Missing "which means..." bridges

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

❌ "Our platform uses AI-powered analytics" So what? ✅ "Our AI-powered analytics surface insights you'd miss manually—so you can make better decisions in half the time"

Common So What failures:

  • Feature lists without benefit connections
  • Impressive-sounding claims that don't land
  • Technical capabilities without outcomes
  • Company achievements that don't help the reader

Process:

  1. Read each claim and literally ask "so what?"
  2. Highlight claims missing the answer
  3. Add the benefit bridge or deeper meaning
  4. Ensure benefits connect to real reader desires

After this sweep: Return to Voice and Tone, then Clarity.


Sweep 4: Prove It

Focus: Is every claim supported with evidence?

What to check:

  • Unsubstantiated claims
  • Missing social proof
  • Assertions without backup
  • "Best" or "leading" without 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
  • Customer logos
  • Review scores

Common proof gaps:

  • "Trusted by thousands" (which thousands?)
  • "Industry-leading" (according to whom?)
  • "Customers love us" (show them saying it)
  • Results claims without specifics

Process:

  1. Identify every claim that needs proof
  2. Check if proof exists nearby
  3. Flag unsupported assertions
  4. Recommend adding proof or softening claims

After this sweep: Return to So What, Voice and Tone, then Clarity.


Sweep 5: Specificity

Focus: Is the copy concrete enough to be compelling?

What to check:

  • Vague language ("improve," "enhance," "optimize")
  • Generic statements that could apply to anyone
  • Round numbers that feel made up
  • Missing details that would make it real

Specificity upgrades:

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

Common specificity issues:

  • Adjectives doing the work nouns should do
  • Benefits without quantification
  • Outcomes without timeframes
  • Claims without concrete examples

Process:

  1. Highlight vague words and phrases
  2. Ask "Can this be more specific?"
  3. Add numbers, timeframes, or examples
  4. Remove content that can't be made specific (it's probably filler)

After this sweep: Return to Prove It, So What, Voice and Tone, then Clarity.


Sweep 6: Heightened Emotion

Focus: Does the copy make the reader feel something?

What to check:

  • Flat, informational language
  • Missing emotional triggers
  • Pain points mentioned but not felt
  • Aspirations stated but not evoked

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

Techniques for heightening emotion:

  • Paint the "before" state vividly
  • Use sensory language
  • Tell micro-stories
  • Reference shared experiences
  • Ask questions that prompt reflection

Process:

  1. Read for emotional impact—does it move you?
  2. Identify flat sections that should resonate
  3. Add emotional texture while staying authentic
  4. Ensure emotion serves the message (not manipulation)

After this sweep: Return to Specificity, Prove It, So What, Voice and Tone, then Clarity.


Sweep 7: Zero Risk

Focus: Have we removed every barrier to action?

What to check:

  • Friction near CTAs
  • Unanswered objections
  • Missing trust signals
  • Unclear next steps
  • Hidden costs or surprises

Risk reducers to look for:

  • Money-back guarantees
  • Free trials
  • "No credit card required"
  • "Cancel anytime"
  • Social proof near CTA
  • Clear expectations of what happens next
  • Privacy assurances

Common risk issues:

  • CTA asks for commitment without earning trust
  • Objections raised but not addressed
  • Fine print that creates doubt
  • Vague "Contact us" instead of clear next step

Process:

  1. Focus on sections near CTAs
  2. List every reason someone might hesitate
  3. Check if the copy addresses each concern
  4. Add risk reversals or trust signals as needed

After this sweep: Return through all previous sweeps one final time: Heightened Emotion, Specificity, Prove It, So What, Voice and Tone, Clarity.


Quick-Pass Editing Checks

Use these for faster reviews when a full seven-sweep process isn't needed.

Word-Level Checks

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:

Weak Strong
Utilize Use
Implement Set up
Leverage Use
Facilitate Help
Innovative New
Robust Strong
Seamless Smooth
Cutting-edge New/Modern

Watch for:

  • Adverbs (usually unnecessary)
  • Passive voice (switch to active)
  • Nominalizations (verb → noun: "make a decision" → "decide")
Sentence-Level Checks
  • One idea per sentence
  • Vary sentence length (mix short and long)
  • Front-load important information
  • Max 3 conjunctions per sentence
  • No more than 25 words (usually)
Paragraph-Level Checks
  • One topic per paragraph
  • Short paragraphs (2-4 sentences for web)
  • Strong opening sentences
  • Logical flow between paragraphs
  • White space for scannability

Copy Editing Checklist

Before You Start
  • Understand the goal of this copy
  • Know the target audience
  • Identify the desired action
  • Read through once without editing
Clarity (Sweep 1)
  • Every sentence is immediately understandable
  • No jargon without explanation
  • Pronouns have clear references
  • No sentences trying to do too much
Voice & Tone (Sweep 2)
  • Consistent formality level throughout
  • Brand personality maintained
  • No jarring shifts in mood
  • Reads well aloud
So What (Sweep 3)
  • Every feature connects to a benefit
  • Claims answer "why should I care?"
  • Benefits connect to real desires
  • No impressive-but-empty statements
Prove It (Sweep 4)
  • Claims are substantiated
  • Social proof is specific and attributed
  • Numbers and stats have sources
  • No unearned superlatives
Specificity (Sweep 5)
  • Vague words replaced with concrete ones
  • Numbers and timeframes included
  • Generic statements made specific
  • Filler content removed
Heightened Emotion (Sweep 6)
  • Copy evokes feeling, not just information
  • Pain points feel real
  • Aspirations feel achievable
  • Emotion serves the message authentically
Zero Risk (Sweep 7)
  • Objections addressed near CTA
  • Trust signals present
  • Next steps are crystal clear
  • Risk reversals stated (guarantee, trial, etc.)
Final Checks
  • No typos or grammatical errors
  • Consistent formatting
  • Links work (if applicable)
  • Core message preserved through all edits

Common Copy Problems & Fixes

Problem: Wall of Features

Symptom: List of what the product does without why it matters Fix: Add "which means..." after each feature to bridge to benefits

Problem: Corporate Speak

Symptom: "Leverage synergies to optimize outcomes" Fix: Ask "How would a human say this?" and use those words

Problem: Weak Opening

Symptom: Starting with company history or vague statements Fix: Lead with the reader's problem or desired outcome

Problem: Buried CTA

Symptom: The ask comes after too much buildup, or isn't clear Fix: Make the CTA obvious, early, and repeated

Problem: No Proof

Symptom: "Customers love us" with no evidence Fix: Add specific testimonials, numbers, or case references

Problem: Generic Claims

Symptom: "We help businesses grow" Fix: Specify who, how, and by how much

Problem: Mixed Audiences

Symptom: Copy tries to speak to everyone, resonates with no one Fix: Pick one audience and write directly to them

Problem: Feature Overload

Symptom: Listing every capability, overwhelming the reader Fix: Focus on 3-5 key benefits that matter most to the audience


Working with Copy Sweeps

When editing collaboratively:

  1. Run a sweep and present findings - Show what you found, why it's an issue
  2. Recommend specific edits - Don't just identify problems; propose solutions
  3. Request the updated copy - Let the author make final decisions
  4. Verify previous sweeps - After each round of edits, re-check earlier sweeps
  5. Repeat until clean - Continue until a full sweep finds no new issues

This iterative process ensures each edit doesn't create new problems while respecting the author's ownership of the copy.


Questions to Ask

If you need more context:

  1. What's the goal of this copy? (Awareness, conversion, retention)
  2. Who's the target audience?
  3. What action should readers take?
  4. What's the brand voice? (Casual, professional, playful, authoritative)
  5. Are there specific concerns or known issues?
  6. What proof/evidence do you have available?

  • copywriting: For writing new copy from scratch (use this skill to edit after your first draft is complete)
  • page-cro: For broader page optimization beyond copy
  • marketing-psychology: For understanding why certain edits improve conversion
  • ab-test-setup: For testing copy variations

When to Use Each Skill

Task Skill to Use
Writing new page copy from scratch copywriting
Reviewing and improving existing copy copy-editing (this skill)
Editing copy you just wrote copy-editing (this skill)
Structural or strategic page changes page-cro
1---
2name: copy-editing
3description: "When the user wants to edit, review, or improve existing marketing copy. Also use when the user mentions 'edit this copy,' 'review my copy,' 'copy feedback,' 'proofread,' 'polish this,' 'make this better,' or 'copy sweep.' This skill provides a systematic approach to editing marketing copy through multiple focused passes."
4---
5 
6# Copy Editing
7 
8You 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.
9 
10## Core Philosophy
11 
12Good 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.
13 
14**Key principles:**
15- Don't change the core message; focus on enhancing it
16- Multiple focused passes beat one unfocused review
17- Each edit should have a clear reason
18- Preserve the author's voice while improving clarity
19 
20---
21 
22## The Seven Sweeps Framework
23 
24Edit copy through seven sequential passes, each focusing on one dimension. After each sweep, loop back to check previous sweeps aren't compromised.
25 
26### Sweep 1: Clarity
27 
28**Focus:** Can the reader understand what you're saying?
29 
30**What to check:**
31- Confusing sentence structures
32- Unclear pronoun references
33- Jargon or insider language
34- Ambiguous statements
35- Missing context
36 
37**Common clarity killers:**
38- Sentences trying to say too much
39- Abstract language instead of concrete
40- Assuming reader knowledge they don't have
41- Burying the point in qualifications
42 
43**Process:**
441. Read through quickly, highlighting unclear parts
452. Don't correct yet—just note problem areas
463. After marking issues, recommend specific edits
474. Verify edits maintain the original intent
48 
49**After this sweep:** Confirm the "Rule of One" (one main idea per section) and "You Rule" (copy speaks to the reader) are intact.
50 
51---
52 
53### Sweep 2: Voice and Tone
54 
55**Focus:** Is the copy consistent in how it sounds?
56 
57**What to check:**
58- Shifts between formal and casual
59- Inconsistent brand personality
60- Mood changes that feel jarring
61- Word choices that don't match the brand
62 
63**Common voice issues:**
64- Starting casual, becoming corporate
65- Mixing "we" and "the company" references
66- Humor in some places, serious in others (unintentionally)
67- Technical language appearing randomly
68 
69**Process:**
701. Read aloud to hear inconsistencies
712. Mark where tone shifts unexpectedly
723. Recommend edits that smooth transitions
734. Ensure personality remains throughout
74 
75**After this sweep:** Return to Clarity Sweep to ensure voice edits didn't introduce confusion.
76 
77---
78 
79### Sweep 3: So What
80 
81**Focus:** Does every claim answer "why should I care?"
82 
83**What to check:**
84- Features without benefits
85- Claims without consequences
86- Statements that don't connect to reader's life
87- Missing "which means..." bridges
88 
89**The So What test:**
90For every statement, ask "Okay, so what?" If the copy doesn't answer that question with a deeper benefit, it needs work.
91 
92❌ "Our platform uses AI-powered analytics"
93*So what?*
94✅ "Our AI-powered analytics surface insights you'd miss manually—so you can make better decisions in half the time"
95 
96**Common So What failures:**
97- Feature lists without benefit connections
98- Impressive-sounding claims that don't land
99- Technical capabilities without outcomes
100- Company achievements that don't help the reader
101 
102**Process:**
1031. Read each claim and literally ask "so what?"
1042. Highlight claims missing the answer
1053. Add the benefit bridge or deeper meaning
1064. Ensure benefits connect to real reader desires
107 
108**After this sweep:** Return to Voice and Tone, then Clarity.
109 
110---
111 
112### Sweep 4: Prove It
113 
114**Focus:** Is every claim supported with evidence?
115 
116**What to check:**
117- Unsubstantiated claims
118- Missing social proof
119- Assertions without backup
120- "Best" or "leading" without evidence
121 
122**Types of proof to look for:**
123- Testimonials with names and specifics
124- Case study references
125- Statistics and data
126- Third-party validation
127- Guarantees and risk reversals
128- Customer logos
129- Review scores
130 
131**Common proof gaps:**
132- "Trusted by thousands" (which thousands?)
133- "Industry-leading" (according to whom?)
134- "Customers love us" (show them saying it)
135- Results claims without specifics
136 
137**Process:**
1381. Identify every claim that needs proof
1392. Check if proof exists nearby
1403. Flag unsupported assertions
1414. Recommend adding proof or softening claims
142 
143**After this sweep:** Return to So What, Voice and Tone, then Clarity.
144 
145---
146 
147### Sweep 5: Specificity
148 
149**Focus:** Is the copy concrete enough to be compelling?
150 
151**What to check:**
152- Vague language ("improve," "enhance," "optimize")
153- Generic statements that could apply to anyone
154- Round numbers that feel made up
155- Missing details that would make it real
156 
157**Specificity upgrades:**
158 
159| Vague | Specific |
160|-------|----------|
161| Save time | Save 4 hours every week |
162| Many customers | 2,847 teams |
163| Fast results | Results in 14 days |
164| Improve your workflow | Cut your reporting time in half |
165| Great support | Response within 2 hours |
166 
167**Common specificity issues:**
168- Adjectives doing the work nouns should do
169- Benefits without quantification
170- Outcomes without timeframes
171- Claims without concrete examples
172 
173**Process:**
1741. Highlight vague words and phrases
1752. Ask "Can this be more specific?"
1763. Add numbers, timeframes, or examples
1774. Remove content that can't be made specific (it's probably filler)
178 
179**After this sweep:** Return to Prove It, So What, Voice and Tone, then Clarity.
180 
181---
182 
183### Sweep 6: Heightened Emotion
184 
185**Focus:** Does the copy make the reader feel something?
186 
187**What to check:**
188- Flat, informational language
189- Missing emotional triggers
190- Pain points mentioned but not felt
191- Aspirations stated but not evoked
192 
193**Emotional dimensions to consider:**
194- Pain of the current state
195- Frustration with alternatives
196- Fear of missing out
197- Desire for transformation
198- Pride in making smart choices
199- Relief from solving the problem
200 
201**Techniques for heightening emotion:**
202- Paint the "before" state vividly
203- Use sensory language
204- Tell micro-stories
205- Reference shared experiences
206- Ask questions that prompt reflection
207 
208**Process:**
2091. Read for emotional impact—does it move you?
2102. Identify flat sections that should resonate
2113. Add emotional texture while staying authentic
2124. Ensure emotion serves the message (not manipulation)
213 
214**After this sweep:** Return to Specificity, Prove It, So What, Voice and Tone, then Clarity.
215 
216---
217 
218### Sweep 7: Zero Risk
219 
220**Focus:** Have we removed every barrier to action?
221 
222**What to check:**
223- Friction near CTAs
224- Unanswered objections
225- Missing trust signals
226- Unclear next steps
227- Hidden costs or surprises
228 
229**Risk reducers to look for:**
230- Money-back guarantees
231- Free trials
232- "No credit card required"
233- "Cancel anytime"
234- Social proof near CTA
235- Clear expectations of what happens next
236- Privacy assurances
237 
238**Common risk issues:**
239- CTA asks for commitment without earning trust
240- Objections raised but not addressed
241- Fine print that creates doubt
242- Vague "Contact us" instead of clear next step
243 
244**Process:**
2451. Focus on sections near CTAs
2462. List every reason someone might hesitate
2473. Check if the copy addresses each concern
2484. Add risk reversals or trust signals as needed
249 
250**After this sweep:** Return through all previous sweeps one final time: Heightened Emotion, Specificity, Prove It, So What, Voice and Tone, Clarity.
251 
252---
253 
254## Quick-Pass Editing Checks
255 
256Use these for faster reviews when a full seven-sweep process isn't needed.
257 
258### Word-Level Checks
259 
260**Cut these words:**
261- Very, really, extremely, incredibly (weak intensifiers)
262- Just, actually, basically (filler)
263- In order to (use "to")
264- That (often unnecessary)
265- Things, stuff (vague)
266 
267**Replace these:**
268 
269| Weak | Strong |
270|------|--------|
271| Utilize | Use |
272| Implement | Set up |
273| Leverage | Use |
274| Facilitate | Help |
275| Innovative | New |
276| Robust | Strong |
277| Seamless | Smooth |
278| Cutting-edge | New/Modern |
279 
280**Watch for:**
281- Adverbs (usually unnecessary)
282- Passive voice (switch to active)
283- Nominalizations (verb → noun: "make a decision" → "decide")
284 
285### Sentence-Level Checks
286 
287- One idea per sentence
288- Vary sentence length (mix short and long)
289- Front-load important information
290- Max 3 conjunctions per sentence
291- No more than 25 words (usually)
292 
293### Paragraph-Level Checks
294 
295- One topic per paragraph
296- Short paragraphs (2-4 sentences for web)
297- Strong opening sentences
298- Logical flow between paragraphs
299- White space for scannability
300 
301---
302 
303## Copy Editing Checklist
304 
305### Before You Start
306- [ ] Understand the goal of this copy
307- [ ] Know the target audience
308- [ ] Identify the desired action
309- [ ] Read through once without editing
310 
311### Clarity (Sweep 1)
312- [ ] Every sentence is immediately understandable
313- [ ] No jargon without explanation
314- [ ] Pronouns have clear references
315- [ ] No sentences trying to do too much
316 
317### Voice & Tone (Sweep 2)
318- [ ] Consistent formality level throughout
319- [ ] Brand personality maintained
320- [ ] No jarring shifts in mood
321- [ ] Reads well aloud
322 
323### So What (Sweep 3)
324- [ ] Every feature connects to a benefit
325- [ ] Claims answer "why should I care?"
326- [ ] Benefits connect to real desires
327- [ ] No impressive-but-empty statements
328 
329### Prove It (Sweep 4)
330- [ ] Claims are substantiated
331- [ ] Social proof is specific and attributed
332- [ ] Numbers and stats have sources
333- [ ] No unearned superlatives
334 
335### Specificity (Sweep 5)
336- [ ] Vague words replaced with concrete ones
337- [ ] Numbers and timeframes included
338- [ ] Generic statements made specific
339- [ ] Filler content removed
340 
341### Heightened Emotion (Sweep 6)
342- [ ] Copy evokes feeling, not just information
343- [ ] Pain points feel real
344- [ ] Aspirations feel achievable
345- [ ] Emotion serves the message authentically
346 
347### Zero Risk (Sweep 7)
348- [ ] Objections addressed near CTA
349- [ ] Trust signals present
350- [ ] Next steps are crystal clear
351- [ ] Risk reversals stated (guarantee, trial, etc.)
352 
353### Final Checks
354- [ ] No typos or grammatical errors
355- [ ] Consistent formatting
356- [ ] Links work (if applicable)
357- [ ] Core message preserved through all edits
358 
359---
360 
361## Common Copy Problems & Fixes
362 
363### Problem: Wall of Features
364**Symptom:** List of what the product does without why it matters
365**Fix:** Add "which means..." after each feature to bridge to benefits
366 
367### Problem: Corporate Speak
368**Symptom:** "Leverage synergies to optimize outcomes"
369**Fix:** Ask "How would a human say this?" and use those words
370 
371### Problem: Weak Opening
372**Symptom:** Starting with company history or vague statements
373**Fix:** Lead with the reader's problem or desired outcome
374 
375### Problem: Buried CTA
376**Symptom:** The ask comes after too much buildup, or isn't clear
377**Fix:** Make the CTA obvious, early, and repeated
378 
379### Problem: No Proof
380**Symptom:** "Customers love us" with no evidence
381**Fix:** Add specific testimonials, numbers, or case references
382 
383### Problem: Generic Claims
384**Symptom:** "We help businesses grow"
385**Fix:** Specify who, how, and by how much
386 
387### Problem: Mixed Audiences
388**Symptom:** Copy tries to speak to everyone, resonates with no one
389**Fix:** Pick one audience and write directly to them
390 
391### Problem: Feature Overload
392**Symptom:** Listing every capability, overwhelming the reader
393**Fix:** Focus on 3-5 key benefits that matter most to the audience
394 
395---
396 
397## Working with Copy Sweeps
398 
399When editing collaboratively:
400 
4011. **Run a sweep and present findings** - Show what you found, why it's an issue
4022. **Recommend specific edits** - Don't just identify problems; propose solutions
4033. **Request the updated copy** - Let the author make final decisions
4044. **Verify previous sweeps** - After each round of edits, re-check earlier sweeps
4055. **Repeat until clean** - Continue until a full sweep finds no new issues
406 
407This iterative process ensures each edit doesn't create new problems while respecting the author's ownership of the copy.
408 
409---
410 
411## Questions to Ask
412 
413If you need more context:
4141. What's the goal of this copy? (Awareness, conversion, retention)
4152. Who's the target audience?
4163. What action should readers take?
4174. What's the brand voice? (Casual, professional, playful, authoritative)
4185. Are there specific concerns or known issues?
4196. What proof/evidence do you have available?
420 
421---
422 
423## Related Skills
424 
425- **copywriting**: For writing new copy from scratch (use this skill to edit after your first draft is complete)
426- **page-cro**: For broader page optimization beyond copy
427- **marketing-psychology**: For understanding why certain edits improve conversion
428- **ab-test-setup**: For testing copy variations
429 
430---
431 
432## When to Use Each Skill
433 
434| Task | Skill to Use |
435|------|--------------|
436| Writing new page copy from scratch | copywriting |
437| Reviewing and improving existing copy | copy-editing (this skill) |
438| Editing copy you just wrote | copy-editing (this skill) |
439| Structural or strategic page changes | page-cro |
440 

Discussion