copy-editing
Verified@coreyhaines
npx machina-cli add skill coreyhaines31/marketingskills/copy-editing --openclawCopy 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
Process:
- Read through quickly, highlighting unclear parts
- Don't correct yet—just note problem areas
- After marking issues, recommend specific edits
- 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:
- Read aloud to hear inconsistencies
- Mark where tone shifts unexpectedly
- Recommend edits that smooth transitions
- 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:
- Read each claim and literally ask "so what?"
- Highlight claims missing the answer
- Add the benefit bridge or deeper meaning
- 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:
- Identify every claim that needs proof
- Check if proof exists nearby
- Flag unsupported assertions
- 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:
- Highlight vague words and phrases
- Ask "Can this be more specific?"
- Add numbers, timeframes, or examples
- 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:
- Read for emotional impact—does it move you?
- Identify flat sections that should resonate
- Add emotional texture while staying authentic
- 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:
- Focus on sections near CTAs
- List every reason someone might hesitate
- Check if the copy addresses each concern
- 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:
- Run a sweep and present findings - Show what you found, why it's an issue
- Recommend specific edits - Don't just identify problems; propose solutions
- Request the updated copy - Let the author make final decisions
- Verify previous sweeps - After each round of edits, re-check earlier sweeps
- 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.
References
- Plain English Alternatives: Replace complex words with simpler alternatives
Task-Specific Questions
- What's the goal of this copy? (Awareness, conversion, retention)
- What action should readers take?
- Are there specific concerns or known issues?
- What proof/evidence do you have available?
Related Skills
- 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 |
Source
git clone https://github.com/coreyhaines31/marketingskills/tree/main/skills/copy-editingView on GitHub Overview
Copy editing improves clarity, tone, and impact of existing copy while preserving the original message. It follows the Seven Sweeps Framework to methodically refine copy, starting with Clarity and progressing through Voice, So What, and more, looping back after each pass. It also checks product marketing context and brand voice to stay on-brand.
How This Skill Works
It begins by verifying product marketing context if available, then applies seven sequential passes focusing on a single dimension at a time. After each sweep, it reevaluates to ensure edits don’t compromise clarity or voice. Each edit includes a clear justification to preserve the core message and author’s voice.
When to Use It
- You have existing copy and want to improve it rather than rewrite from scratch.
- The copy feels too wordy, awkward, or uses jargon and needs tightening.
- Brand voice or tone has drifted across sections and needs consistency.
- You’re preparing a landing page, email, or ad and want polishing before publish.
- You want to align copy with product marketing context before finalizing.
Quick Start
- Step 1: Read the copy and identify issues across the seven sweeps without editing yet.
- Step 2: Apply Sweep 1 (Clarity) then proceed through the seven sweeps in order, noting edits with reasons.
- Step 3: Deliver the edited copy with a brief rationale and a before/after summary.
Best Practices
- Preserve the core message and the author’s voice while making improvements.
- Apply the Seven Sweeps in order and verify previous edits aren’t compromised.
- If context exists, read .agents/product-marketing-context.md (or .claude/...) before editing.
- For every edit, include a specific reason tied to clarity, tone, or value.
- Avoid wholesale rewrites; edits should refine, not replace the original intent.
Example Use Cases
- Polish a product landing page hero and subheadline without changing the core value proposition.
- Tighten a rambling marketing email intro and CTA while preserving the offer.
- Clean up a long feature list to clearly connect features to customer benefits.
- Proofread a campaign landing page for pronoun consistency and brand voice.
- Standardize tone and terminology across a multi-section case study.
Frequently Asked Questions
Related Skills
ad-creative
coreyhaines31/marketingskills
When the user wants to generate, iterate, or scale ad creative — headlines, descriptions, primary text, or full ad variations — for any paid advertising platform. Also use when the user mentions 'ad copy variations,' 'ad creative,' 'generate headlines,' 'RSA headlines,' 'bulk ad copy,' 'ad iterations,' 'creative testing,' 'ad performance optimization,' 'write me some ads,' 'Facebook ad copy,' 'Google ad headlines,' 'LinkedIn ad text,' or 'I need more ad variations.' Use this whenever someone needs to produce ad copy at scale or iterate on existing ads. For campaign strategy and targeting, see paid-ads. For landing page copy, see copywriting.
ai-seo
coreyhaines31/marketingskills
When the user wants to optimize content for AI search engines, get cited by LLMs, or appear in AI-generated answers. Also use when the user mentions 'AI SEO,' 'AEO,' 'GEO,' 'LLMO,' 'answer engine optimization,' 'generative engine optimization,' 'LLM optimization,' 'AI Overviews,' 'optimize for ChatGPT,' 'optimize for Perplexity,' 'AI citations,' 'AI visibility,' 'zero-click search,' 'how do I show up in AI answers,' 'LLM mentions,' or 'optimize for Claude/Gemini.' Use this whenever someone wants their content to be cited or surfaced by AI assistants and AI search engines. For traditional technical and on-page SEO audits, see seo-audit. For structured data implementation, see schema-markup.
cold-email
coreyhaines31/marketingskills
Write B2B cold emails and follow-up sequences that get replies. Use when the user wants to write cold outreach emails, prospecting emails, cold email campaigns, sales development emails, or SDR emails. Also use when the user mentions "cold outreach," "prospecting email," "outbound email," "email to leads," "reach out to prospects," "sales email," "follow-up email sequence," "nobody's replying to my emails," or "how do I write a cold email." Covers subject lines, opening lines, body copy, CTAs, personalization, and multi-touch follow-up sequences. For warm/lifecycle email sequences, see email-sequence. For sales collateral beyond emails, see sales-enablement.
competitor-alternatives
coreyhaines31/marketingskills
When the user wants to create competitor comparison or alternative pages for SEO and sales enablement. Also use when the user mentions 'alternative page,' 'vs page,' 'competitor comparison,' 'comparison page,' '[Product] vs [Product],' '[Product] alternative,' 'competitive landing pages,' 'how do we compare to X,' 'battle card,' or 'competitor teardown.' Use this for any content that positions your product against competitors. Covers four formats: singular alternative, plural alternatives, you vs competitor, and competitor vs competitor. For sales-specific competitor docs, see sales-enablement.
content-strategy
coreyhaines31/marketingskills
When the user wants to plan a content strategy, decide what content to create, or figure out what topics to cover. Also use when the user mentions "content strategy," "what should I write about," "content ideas," "blog strategy," "topic clusters," "content planning," "editorial calendar," "content marketing," "content roadmap," "what content should I create," "blog topics," "content pillars," or "I don't know what to write." Use this whenever someone needs help deciding what content to produce, not just writing it. For writing individual pieces, see copywriting. For SEO-specific audits, see seo-audit. For social media content specifically, see social-content.
copywriting
coreyhaines31/marketingskills
When the user wants to write, rewrite, or improve marketing copy for any page — including homepage, landing pages, pricing pages, feature pages, about pages, or product pages. Also use when the user says "write copy for," "improve this copy," "rewrite this page," "marketing copy," "headline help," "CTA copy," "value proposition," "tagline," "subheadline," "hero section copy," "above the fold," "this copy is weak," "make this more compelling," or "help me describe my product." Use this whenever someone is working on website text that needs to persuade or convert. For email copy, see email-sequence. For popup copy, see popup-cro. For editing existing copy, see copy-editing.