/iblai-marketing-copy-editing
Improve existing marketing copy through focused, sequential edit passes.
Preserve the core message; sharpen the execution.
Step 0: Context Check
Read .agents/product-marketing-context.md (or .claude/product-marketing-context.md
on older setups) before editing. Use brand voice and customer language from
that context to guide every change.
Good editing isn't rewriting — it's enhancing. Each pass tackles one dimension; trying to fix everything at once misses things.
Principles:
- Don't change the core message; sharpen it
- Multiple focused passes beat one unfocused review
- Every edit has a clear reason
- Preserve the author's voice while improving clarity
The Seven Sweeps Framework
Edit through seven sequential passes — Clarity, Voice and Tone, So What, Prove It, Specificity, Heightened Emotion, Zero Risk. After each sweep, loop back to confirm earlier sweeps weren't compromised.
| # |
Sweep |
Question it answers |
| 1 |
Clarity |
Can the reader understand it? |
| 2 |
Voice and Tone |
Does it sound like the brand? |
| 3 |
So What |
Why should the reader care? |
| 4 |
Prove It |
Where's the evidence? |
| 5 |
Specificity |
Is it concrete, not vague? |
| 6 |
Heightened Emotion |
Does it move the reader? |
| 7 |
Zero Risk |
What hesitations remain? |
Full sweep-by-sweep guidance, examples, and per-sweep checklists: references/seven-sweeps.md.
Expert Panel Scoring
Use this after the Seven Sweeps as an extra quality gate. For high-stakes copy (landing pages, launch emails, sales pages), multi-persona review catches what a single perspective misses.
How It Works
- Assemble 3-5 expert personas relevant to the copy type
- Each persona scores the copy 1-10 on their area of expertise
- Collect specific critiques — not just scores, but fixes
- Revise based on feedback — address lowest-scoring areas first
- Re-score after revisions — iterate until every persona scores 7+, panel average 8+
Recommended Panels
Landing page copy:
- Conversion copywriter (clarity, CTA strength, benefit hierarchy)
- UX writer (scannability, cognitive load, user flow)
- Target customer persona (does this speak to me? Do I trust it?)
- Brand strategist (voice consistency, positioning accuracy)
Email sequence:
- Email marketing specialist (subject lines, open/click optimization)
- Copywriter (hooks, storytelling, persuasion)
- Spam filter analyst (deliverability red flags, trigger words)
- Target customer persona (relevance, value, unsubscribe risk)
Sales page / long-form:
- Direct response copywriter (offer structure, objection handling, urgency)
- Skeptical buyer persona (proof gaps, trust issues, red flags)
- Editor (flow, readability, conciseness)
- SEO specialist (keyword coverage, search intent alignment)
Scoring Rubric
| Score |
Meaning |
| 9-10 |
Publish-ready. No meaningful improvements. |
| 7-8 |
Strong. Minor tweaks only. |
| 5-6 |
Functional but has clear gaps. Needs another pass. |
| 3-4 |
Significant issues. Major revision needed. |
| 1-2 |
Fundamentally broken. Rethink approach. |
When to Use
- Always for launch copy, pricing pages, high-traffic landing pages
- Recommended for email sequences, sales pages, ad copy
- Optional for blog posts, social content, internal docs
- Skip for quick updates, minor edits, low-stakes content
Quick-Pass Checks
Use for faster reviews when a full seven-sweep process isn't warranted.
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:
| 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
- One idea per sentence
- Vary sentence length (mix short and long)
- Front-load important information
- Max 3 conjunctions per sentence
- Usually under 25 words
Paragraph-Level
- 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
Clarity (Sweep 1)
Voice & Tone (Sweep 2)
So What (Sweep 3)
Prove It (Sweep 4)
Specificity (Sweep 5)
Heightened Emotion (Sweep 6)
Zero Risk (Sweep 7)
Final Checks
Common 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: 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: Every capability listed, reader overwhelmed
Fix: Focus on 3-5 key benefits that matter most
Working with Copy Sweeps
When editing collaboratively:
- Run a sweep and present findings — show what you found, why it matters
- Recommend specific edits — propose solutions, not just problems
- Request the updated copy — let the author make final calls
- Verify previous sweeps — re-check earlier sweeps after each round
- Repeat until clean — until a full sweep surfaces no new issues
This iteration respects the author's ownership while compounding improvements.
References
- Plain English Alternatives: Replace complex words with simpler alternatives
- Content Refresh: Full checklist, refresh vs. rewrite matrix, and cadence guide
Content Refresh Editing
Existing pages decay — outdated stats, stale examples, drifted brand voice. Use the content refresh framework when traffic is declining, data is stale, or the product has changed.
Full refresh checklist, refresh-vs-rewrite matrix, cadence guide: references/content-refresh.md.
Task-Specific Questions
- Goal of this copy? (Awareness, conversion, retention.)
- What action should readers take?
- Specific concerns or known issues?
- What proof/evidence is available?
- New copy or refresh of existing content?
Related Skills
- iblai-marketing-copywriting: Writing new copy from scratch (use this skill to edit afterward)
- iblai-marketing-page-cro: Broader page optimization beyond copy
- iblai-marketing-psychology: Why certain edits improve conversion
- iblai-marketing-ab-test-setup: Testing copy variations
When to Use Each Skill
| Task |
Skill to Use |
| Writing new page copy from scratch |
iblai-marketing-copywriting |
| Reviewing and improving existing copy |
iblai-marketing-copy-editing (this skill) |
| Editing copy you just wrote |
iblai-marketing-copy-editing (this skill) |
| Structural or strategic page changes |
iblai-marketing-page-cro |
1---2name: iblai-marketing-copy-editing3description: When the user wants to edit, review, or improve existing marketing copy, or refresh outdated content. Also use when the user mentions 'edit this copy,' 'review my copy,' 'copy feedback,' 'proofread,' 'polish this,' 'make this better,' 'copy sweep,' 'tighten this up,' 'this reads awkwardly,' 'clean up this text,' 'too wordy,' 'sharpen the messaging,' 'refresh this content,' 'update this page,' 'this content is outdated,' or 'content audit.' Use this when the user already has copy and wants it improved or refreshed rather than rewritten from scratch. For writing new copy, see iblai-marketing-copywriting.4---56# /iblai-marketing-copy-editing78Improve existing marketing copy through focused, sequential edit passes.9Preserve the core message; sharpen the execution.1011## Step 0: Context Check1213Read `.agents/product-marketing-context.md` (or `.claude/product-marketing-context.md`14on older setups) before editing. Use brand voice and customer language from15that context to guide every change.1617Good editing isn't rewriting — it's enhancing. Each pass tackles one dimension; trying to fix everything at once misses things.1819**Principles:**20- Don't change the core message; sharpen it21- Multiple focused passes beat one unfocused review22- Every edit has a clear reason23- Preserve the author's voice while improving clarity2425---2627## The Seven Sweeps Framework2829Edit through seven sequential passes — Clarity, Voice and Tone, So What, Prove It, Specificity, Heightened Emotion, Zero Risk. After each sweep, loop back to confirm earlier sweeps weren't compromised.3031| # | Sweep | Question it answers |32|---|-------|---------------------|33| 1 | Clarity | Can the reader understand it? |34| 2 | Voice and Tone | Does it sound like the brand? |35| 3 | So What | Why should the reader care? |36| 4 | Prove It | Where's the evidence? |37| 5 | Specificity | Is it concrete, not vague? |38| 6 | Heightened Emotion | Does it move the reader? |39| 7 | Zero Risk | What hesitations remain? |4041Full sweep-by-sweep guidance, examples, and per-sweep checklists: [references/seven-sweeps.md](references/seven-sweeps.md).4243---4445## Expert Panel Scoring4647Use this after the Seven Sweeps as an extra quality gate. For high-stakes copy (landing pages, launch emails, sales pages), multi-persona review catches what a single perspective misses.4849### How It Works50511. **Assemble 3-5 expert personas** relevant to the copy type522. **Each persona scores the copy 1-10** on their area of expertise533. **Collect specific critiques** — not just scores, but fixes544. **Revise based on feedback** — address lowest-scoring areas first555. **Re-score after revisions** — iterate until every persona scores 7+, panel average 8+5657### Recommended Panels5859**Landing page copy:**60- Conversion copywriter (clarity, CTA strength, benefit hierarchy)61- UX writer (scannability, cognitive load, user flow)62- Target customer persona (does this speak to me? Do I trust it?)63- Brand strategist (voice consistency, positioning accuracy)6465**Email sequence:**66- Email marketing specialist (subject lines, open/click optimization)67- Copywriter (hooks, storytelling, persuasion)68- Spam filter analyst (deliverability red flags, trigger words)69- Target customer persona (relevance, value, unsubscribe risk)7071**Sales page / long-form:**72- Direct response copywriter (offer structure, objection handling, urgency)73- Skeptical buyer persona (proof gaps, trust issues, red flags)74- Editor (flow, readability, conciseness)75- SEO specialist (keyword coverage, search intent alignment)7677### Scoring Rubric7879| Score | Meaning |80|-------|---------|81| 9-10 | Publish-ready. No meaningful improvements. |82| 7-8 | Strong. Minor tweaks only. |83| 5-6 | Functional but has clear gaps. Needs another pass. |84| 3-4 | Significant issues. Major revision needed. |85| 1-2 | Fundamentally broken. Rethink approach. |8687### When to Use8889- **Always** for launch copy, pricing pages, high-traffic landing pages90- **Recommended** for email sequences, sales pages, ad copy91- **Optional** for blog posts, social content, internal docs92- **Skip** for quick updates, minor edits, low-stakes content9394---9596## Quick-Pass Checks9798Use for faster reviews when a full seven-sweep process isn't warranted.99100### Word-Level101102**Cut these words:**103- Very, really, extremely, incredibly (weak intensifiers)104- Just, actually, basically (filler)105- In order to (use "to")106- That (often unnecessary)107- Things, stuff (vague)108109**Replace these:**110111| Weak | Strong |112|------|--------|113| Utilize | Use |114| Implement | Set up |115| Leverage | Use |116| Facilitate | Help |117| Innovative | New |118| Robust | Strong |119| Seamless | Smooth |120| Cutting-edge | New/Modern |121122**Watch for:**123- Adverbs (usually unnecessary)124- Passive voice (switch to active)125- Nominalizations (verb → noun: "make a decision" → "decide")126127### Sentence-Level128129- One idea per sentence130- Vary sentence length (mix short and long)131- Front-load important information132- Max 3 conjunctions per sentence133- Usually under 25 words134135### Paragraph-Level136137- One topic per paragraph138- Short paragraphs (2-4 sentences for web)139- Strong opening sentences140- Logical flow between paragraphs141- White space for scannability142143---144145## Copy Editing Checklist146147### Before You Start148- [ ] Understand the goal of this copy149- [ ] Know the target audience150- [ ] Identify the desired action151- [ ] Read through once without editing152153### Clarity (Sweep 1)154- [ ] Every sentence is immediately understandable155- [ ] No jargon without explanation156- [ ] Pronouns have clear references157- [ ] No sentences trying to do too much158159### Voice & Tone (Sweep 2)160- [ ] Consistent formality level throughout161- [ ] Brand personality maintained162- [ ] No jarring mood shifts163- [ ] Reads well aloud164165### So What (Sweep 3)166- [ ] Every feature connects to a benefit167- [ ] Claims answer "why should I care?"168- [ ] Benefits connect to real desires169- [ ] No impressive-but-empty statements170171### Prove It (Sweep 4)172- [ ] Claims are substantiated173- [ ] Social proof is specific and attributed174- [ ] Numbers and stats have sources175- [ ] No unearned superlatives176177### Specificity (Sweep 5)178- [ ] Vague words replaced with concrete ones179- [ ] Numbers and timeframes included180- [ ] Generic statements made specific181- [ ] Filler content removed182183### Heightened Emotion (Sweep 6)184- [ ] Copy evokes feeling, not just information185- [ ] Pain points feel real186- [ ] Aspirations feel achievable187- [ ] Emotion serves the message authentically188189### Zero Risk (Sweep 7)190- [ ] Objections addressed near CTA191- [ ] Trust signals present192- [ ] Next steps are crystal clear193- [ ] Risk reversals stated (guarantee, trial, etc.)194195### Final Checks196- [ ] No typos or grammatical errors197- [ ] Consistent formatting198- [ ] Links work (if applicable)199- [ ] Core message preserved through all edits200201---202203## Common Problems & Fixes204205### Problem: Wall of Features206**Symptom:** List of what the product does without why it matters207**Fix:** Add "which means..." after each feature to bridge to benefits208209### Problem: Corporate Speak210**Symptom:** "Leverage synergies to optimize outcomes"211**Fix:** Ask "How would a human say this?" and use those words212213### Problem: Weak Opening214**Symptom:** Company history or vague statements215**Fix:** Lead with the reader's problem or desired outcome216217### Problem: Buried CTA218**Symptom:** The ask comes after too much buildup, or isn't clear219**Fix:** Make the CTA obvious, early, and repeated220221### Problem: No Proof222**Symptom:** "Customers love us" with no evidence223**Fix:** Add specific testimonials, numbers, or case references224225### Problem: Generic Claims226**Symptom:** "We help businesses grow"227**Fix:** Specify who, how, and by how much228229### Problem: Mixed Audiences230**Symptom:** Copy tries to speak to everyone, resonates with no one231**Fix:** Pick one audience and write directly to them232233### Problem: Feature Overload234**Symptom:** Every capability listed, reader overwhelmed235**Fix:** Focus on 3-5 key benefits that matter most236237---238239## Working with Copy Sweeps240241When editing collaboratively:2422431. **Run a sweep and present findings** — show what you found, why it matters2442. **Recommend specific edits** — propose solutions, not just problems2453. **Request the updated copy** — let the author make final calls2464. **Verify previous sweeps** — re-check earlier sweeps after each round2475. **Repeat until clean** — until a full sweep surfaces no new issues248249This iteration respects the author's ownership while compounding improvements.250251---252253## References254255- [Plain English Alternatives](references/plain-english-alternatives.md): Replace complex words with simpler alternatives256- [Content Refresh](references/content-refresh.md): Full checklist, refresh vs. rewrite matrix, and cadence guide257258---259260## Content Refresh Editing261262Existing pages decay — outdated stats, stale examples, drifted brand voice. Use the content refresh framework when traffic is declining, data is stale, or the product has changed.263264Full refresh checklist, refresh-vs-rewrite matrix, cadence guide: [references/content-refresh.md](references/content-refresh.md).265266---267268## Task-Specific Questions2692701. Goal of this copy? (Awareness, conversion, retention.)2712. What action should readers take?2723. Specific concerns or known issues?2734. What proof/evidence is available?2745. New copy or refresh of existing content?275276---277278## Related Skills279280- **iblai-marketing-copywriting**: Writing new copy from scratch (use this skill to edit afterward)281- **iblai-marketing-page-cro**: Broader page optimization beyond copy282- **iblai-marketing-psychology**: Why certain edits improve conversion283- **iblai-marketing-ab-test-setup**: Testing copy variations284285---286287## When to Use Each Skill288289| Task | Skill to Use |290|------|--------------|291| Writing new page copy from scratch | iblai-marketing-copywriting |292| Reviewing and improving existing copy | iblai-marketing-copy-editing (this skill) |293| Editing copy you just wrote | iblai-marketing-copy-editing (this skill) |294| Structural or strategic page changes | iblai-marketing-page-cro |