Skip to main content
skill CX Codex

copy-editing · borghei — Claude Code skill: Seven Sweeps editorial review

copy-editing — a skill for Claude Code, Codex, Cursor and other agents that runs text through seven sequential editorial passes: clarity, voice, benefit framing, proof, specificity, emotional pull, and CTA friction removal.

MIT 113 installs ★ 1,183 updated 2026-10-23

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add borghei/Claude-Skills --skill copy-editing -a claude-code
Open on GitHub

What copy-editing does

Each platform installs with a single npx skills add command, placing a SKILL.md file in the agent's designated folder.

The Seven Sweeps framework drives the full review. Each pass targets one dimension: Sweep 1 catches overloaded sentences and unclear pronoun references. Sweep 2 checks tone and brand voice consistency throughout. Sweep 3 applies a "so what?" test to every claim, pushing features toward concrete reader benefits. Sweep 4 flags unsubstantiated assertions — anything like "industry-leading" without a cited source gets marked for revision. Sweep 5 replaces vague language with specific numbers and examples. Sweep 6 sharpens pain points and aspirations. Sweep 7 strips barriers near the CTA. After each pass, the skill verifies that earlier passes remain intact.

A quick-pass mode also exists for lighter work: it cuts filler words, swaps weak verbs for direct ones, and flips passive constructions to active voice. Before a full review, the skill asks for the copy's goal, target audience, and voice standard if any of those would change the output — otherwise it picks a sensible default and states which one.

What it helps with

  • run a marketing draft through all seven editorial passes
  • flag unsubstantiated claims on a landing page
  • align tone and brand voice across a multi-section document
  • replace vague promises with specific numbers and proof
  • cut filler words and CTA friction from a short email

Example prompts for the agent

  • Run the Seven Sweeps on this draft, target audience is B2B marketers
  • Quick pass only — cut filler words and replace weak verbs
  • Flag every unsubstantiated claim in this landing page copy

How to install copy-editing

1Skills CLI (Vercel)

npx skills add borghei/Claude-Skills --skill copy-editing -a claude-code

2Manually: put the files in place

~/.claude/skills/copy-editing/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/copy-editing/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about copy-editing

How do I install copy-editing in Claude Code?

Run npx skills add borghei/Claude-Skills --skill copy-editing -a claude-code. The skill file will appear at ~/.claude/skills/copy-editing/SKILL.md.

What does the copy-editing skill do?

It edits text through seven focused passes covering clarity, voice consistency, benefit framing, proof, specificity, emotional resonance, and CTA friction. A quick-pass mode handles lighter polishing in a single sweep.

Which platforms does copy-editing support?

Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode — each installed separately with the matching -a flag in the npx skills add command.

Source text

SKILL.md · MIT
---
name: copy-editing
description: >
  Systematic copy editing through focused passes (the Seven Sweeps Framework)
  covering clarity, voice, proof, specificity, and friction removal. Use when
  editing marketing copy, reviewing drafts, polishing content, or proofreading.
license: MIT
metadata:
  version: 1.0.0
  author: borghei
  category: marketing
  domain: copywriting
  updated: 2026-03-09
  tags:
    - copy-editing
    - editing
    - clarity
    - brand-voice
    - copywriting
---
# Copy Editing

Systematic copy improvement through focused editorial passes that enhance clarity, voice, proof, and conversion impact.

---

## Table of Contents

- [Keywords](#keywords)
- [Quick Start](#quick-start)
- [The Seven Sweeps Framework](#the-seven-sweeps-framework)
- [Quick-Pass Editing Guide](#quick-pass-editing-guide)
- [Common Copy Problems and Fixes](#common-copy-problems-and-fixes)
- [Style Consistency Standards](#style-consistency-standards)
- [Fact-Checking Protocol](#fact-checking-protocol)
- [Editorial Checklist](#editorial-checklist)
- [Best Practices](#best-practices)
- [Integration Points](#integration-points)

---

## Keywords

copy editing, editorial review, copy feedback, proofreading, content polishing, copy sweep, editorial standards, style consistency, grammar check, fact-checking, clarity editing, voice consistency, benefit framing, proof validation, specificity, conversion copy editing, marketing copy review, copy quality

---

## Clarify First

Before editing, settle the inputs below. When one is missing or vague and would change the result, ask about it; when it wouldn't, use a sensible default and say which one you used.

- **Goal & desired action:** what the copy must get the reader to do (prioritizes the CTA / Zero Risk sweep).
- **Target audience:** who reads it and their awareness level (calibrates the So What, Specificity, and Emotion sweeps).
- **Voice & style standard:** brand voice or an existing style guide (drives the Voice and Style Consistency sweeps).
- **Edit depth:** full Seven Sweeps or a quick polish pass (sets the scope of the review).

Ask about the two or three inputs that matter most for this request, not the whole list. If the user wants a result straight away, produce it and state your assumptions at the top.

## Quick Start

### Full Copy Review (Seven Sweeps)

1. Read through once without editing to understand the whole piece
2. Sweep 1 — Clarity: flag confusing sentences, unclear references, jargon
3. Sweep 2 — Voice and Tone: flag shifts in formality, personality inconsistencies
4. Sweep 3 — So What: flag features without benefits, claims without consequences
5. Sweep 4 — Prove It: flag unsubstantiated claims, missing social proof
6. Sweep 5 — Specificity: flag vague language, round numbers, generic statements
7. Sweep 6 — Heightened Emotion: strengthen pain points, aspirations, urgency
8. Sweep 7 — Zero Risk: remove barriers near CTAs, add trust signals

### Quick Copy Pass

1. Cut filler words (very, really, just, actually, basically)
2. Replace weak verbs (utilize > use, facilitate > help, leverage > use)
3. Fix passive voice (reports are generated > we generate reports)
4. Verify one idea per sentence, one topic per paragraph
5. Check CTA for action orientation

---

## The Seven Sweeps Framework

Edit through seven sequential passes. Each focuses on one dimension. After each sweep, verify previous sweeps are not compromised.

### Sweep 1: Clarity

**Focus:** Can the reader understand what you are saying on the first read?

**What to check:**
- Sentences trying to say too much (split them)
- Unclear pronoun references ("it" — what is "it"?)
- Jargon or insider language without explanation
- Ambiguous statements that could be read two ways
- Missing context that assumes reader knowledge

**Clarity killers to fix:**

| Problem | Fix |
|---------|-----|
| Sentence over 30 words | Split into two sentences |
| Abstract language | Replace with concrete example |
| Buried main point | Move to beginning of paragraph |
| Three-clause sentence | Simplify to one or two clauses |
| Undefined acronym | Spell out on first use |

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

### Sweep 2: Voice and Tone

**Focus:** Does the copy sound consistent throughout?

**What to check:**
- Shifts between formal and casual language
- Inconsistent brand personality (joking in one paragraph, corporate in the next)
- Jarring mood changes without transition
- Word choices that do not match the established voice
- Mixing "we" and "the company" references

**Voice consistency indicators:**

| Consistent | Inconsistent |
|-----------|-------------|
| Same level of contractions throughout | Contractions in some sections, full forms in others |
| Humor style maintained | Random joke in otherwise serious copy |
| Same sentence structure patterns | Short punchy intro, corporate middle, casual close |
| Consistent use of "you" | Switching between "you," "users," "customers," "one" |

**After this sweep:** Return to Sweep 1 to ensure voice edits did not introduce confusion.

### Sweep 3: So What

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

**The So What test:** For every statement, ask "So what?" If the copy does not answer with a deeper benefit, it needs work.

| Before (features only) | After (feature + benefit) |
|------------------------|--------------------------|
| "Our platform uses AI-powered analytics" | "Our AI analytics surface insights you would miss manually — so you make better decisions in half the time" |
| "SOC 2 Type II certified" | "SOC 2 certified — your security team approves us in days, not months" |
| "Real-time dashboard" | "See exactly what is happening right now, not what happened last week" |

**After this sweep:** Return to Sweeps 2 and 1.

### Sweep 4: Prove It

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

**Types of proof to verify:**

| Proof Type | Strength | Example |
|-----------|----------|---------|
| Named testimonial | Strong | "Sarah Chen, VP Marketing at Stripe: 'Reduced our setup time by 60%'" |
| Specific statistic | Strong | "2,847 teams use [Product] daily" |
| Case study reference | Strong | "See how Linear reduced churn by 23% in 90 days" |
| Third-party validation | Strong | "Named a Leader in Gartner's Magic Quadrant 2025" |
| Customer logos | Medium | Recognizable brand logos with permission |
| Generic claim | Weak — flag it | "Customers love us," "Industry-leading" |

**Common proof gaps to flag:**
- "Trusted by thousands" (which thousands? give a number)
- "Industry-leading" (according to whom? cite the source)
- "Best-in-class" (by what measure?)
- "Customers love us" (show them saying it)
- Results claims without timeframe or specifics

**After this sweep:** Return to Sweeps 3, 2, and 1.

### Sweep 5: Specificity

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

**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 reporting time from 4 hours to 15 minutes" |
| "Great support" | "Average response time: 2 hours" |
| "Easy to use" | "Set up in 10 minutes, no code required" |
| "Affordable" | "Starting at $29/month" |
| "Scalable" | "Handles 10,000 to 10 million records without slowdown" |

**Rule:** If a claim cannot be made specific, it is probably filler. Cut it or replace it with something verifiable.

**After this sweep:** Return to Sweeps 4, 3, 2, and 1.

### Sweep 6: Heightened Emotion

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

**Emotional dimensions to check:**

| Emotion | Where to Use | Technique |
|---------|-------------|-----------|
| Pain/frustration | Problem section | Paint the "before" state vividly |
| Relief | Solution section | Show the contrast with current pain |
| Fear of missing out | Social proof | "Teams like yours already use..." |
| Pride | Aspiration section | "Be the team that..." |
| Confidence | CTA area | "Join 2,847 teams who already..." |
| Urgency | Near CTA | Only if genuine (real deadline, limited spots) |

**Emotion techniques:**
- Paint the "before" state with sensory detail
- Use micro-stories (1-2 sentences) from customer scenarios
- Ask questions that prompt self-reflection
- Reference shared experiences the audience recognizes

**After this sweep:** Return to Sweeps 5, 4, 3, 2, and 1.

### Sweep 7: Zero Risk

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

**Friction checklist near CTAs:**
- [ ] What happens after clicking is clear (not a mystery)
- [ ] Objections addressed within 2 scrolls of the CTA
- [ ] Trust signals visible (guarantee, certifications, customer count)
- [ ] Next steps are specific ("Start your 14-day free trial" not "Get started")
- [ ] Risk reversals stated explicitly (money-back, no CC, cancel anytime)
- [ ] Privacy concerns addressed if form collects data

**After this sweep:** Return through all previous sweeps one final time.

---

## Quick-Pass Editing Guide

### Word-Level Cuts

**Always cut:**
very, really, extremely, incredibly, quite, rather, somewhat, just, actually, basically, essentially, literally (unless literal), in order to (use "to"), the fact that, it should be noted that, it is important to

**Always replace:**

| Weak | Strong |
|------|--------|
| Utilize | Use |
| Implement | Set up, build, create |
| Leverage | Use, apply |
| Facilitate | Help, enable |
| Innovative | New, original, first-of-its-kind |
| Robust | Strong, thorough, [be specific] |
| Seamless | Smooth, easy, [be specific] |
| Cutting-edge | Modern, latest, [be specific] |
| Synergy | [Delete or be specific about the collaboration] |
| Paradigm | [Delete or say what actually changed] |

### Sentence-Level Checks

- One idea per sentence
- Vary sentence length (mix 8-word and 20-word sentences)
- Front-load important information (do not bury the point)
- Maximum 3 conjunctions per sentence
- Active voice default (flip passive constructions)

### Paragraph-Level Checks

- One topic per paragraph
- 2-4 sentences maximum for web copy
- Strong opening sentence that states the paragraph's point
- Logical flow between paragraphs
- White space for scannability

---

## Common Copy Problems and Fixes

| Problem | Symptom | Fix |
|---------|---------|-----|
| Wall of features | List of what it does, no why | Add "which means..." after each feature |
| Corporate speak | "Leverage synergies to optimize outcomes" | Ask "How would a human say this?" |
| Weak opening | Starts with company history or vague statement | Lead with reader's problem or desired outcome |
| Buried CTA | Ask comes after too much buildup | Make CTA obvious, early, and repeated |
| No proof | "Customers love us" with no evidence | Add specific testimonials, numbers, case references |
| Generic claims | "We help businesses grow" | Specify who, how, and by how much |
| Mixed audiences | Tries to speak to everyone | Pick one audience per page/section |
| Feature overload | Every capability listed | Focus on 3-5 benefits that matter most |
| Passive voice | "Reports are generated by the system" | "The system generates reports" |
| Weasel words | "Up to 50% improvement" | State the median or typical result with context |

---

## Style Consistency Standards

### Checklist for Style Consistency

- [ ] Oxford comma: used consistently (or consistently omitted)
- [ ] Contractions: consistent usage throughout
- [ ] Heading case: consistent (sentence case or title case, not mixed)
- [ ] Number style: consistent (spell out 1-9, numerals for 10+, or chosen standard)
- [ ] Date format: consistent (March 9, 2026 or 2026-03-09, not mixed)
- [ ] Brand name: capitalized and formatted consistently
- [ ] Product/feature names: capitalized consistently per brand standards
- [ ] Bulleted lists: consistent punctuation (periods or no periods)
- [ ] Acronyms: spelled out on first use in each document
- [ ] Em dashes, en dashes, hyphens: used correctly and consistently
- [ ] Quotation marks: consistent style (straight or curly)

### Common Style Conflicts

| Decision | Option A | Option B | How to Decide |
|----------|----------|----------|---------------|
| Oxford comma | Yes | No | Pick one, document it, enforce it |
| Heading capitalization | Sentence case | Title Case | Sentence case is modern standard |
| "Login" vs "Log in" | One word (noun) | Two words (verb) | "Log in" as verb, "Login" as noun/adjective |
| "Setup" vs "Set up" | One word (noun) | Two words (verb) | Same pattern as login |
| Ampersand vs "and" | & | and | "and" in prose, "&" only in headings if brand standard |

---

## Fact-Checking Protocol

### What to Verify

- [ ] All statistics have a named source and year
- [ ] Customer testimonials are attributed to real, named individuals
- [ ] Customer logos are used with permission
- [ ] Competitive claims are accurate and current
- [ ] Product capabilities described are actually available (not roadmap items)
- [ ] Pricing is current and matches the pricing page
- [ ] Certifications and compliance claims are active (SOC 2, GDPR, etc.)
- [ ] Awards and recognition are current year or specified year
- [ ] Integration claims list actual integrations, not aspirational ones
- [ ] Uptime/SLA claims match the actual SLA

### Red Flags to Investigate

- Round numbers without source (sounds made up)
- Superlatives without qualification ("fastest," "best," "only")
- Claims that contradict other pages on the same site
- Screenshots from an older version of the product
- Competitor comparisons without date (may be outdated)

---

## Editorial Checklist

### Pre-Edit

- [ ] Understand the goal of this copy
- [ ] Know the target audience
- [ ] Identify the desired action
- [ ] Read through once without editing

### During Edit (Seven Sweeps Summary)

- [ ] Sweep 1: Every sentence is immediately understandable
- [ ] Sweep 2: Voice is consistent throughout
- [ ] Sweep 3: Every feature connects to a benefit
- [ ] Sweep 4: Claims are substantiated with evidence
- [ ] Sweep 5: Vague words replaced with specifics
- [ ] Sweep 6: Copy evokes appropriate emotion
- [ ] Sweep 7: Barriers to action removed near CTAs

### Post-Edit

- [ ] No typos or grammatical errors
- [ ] Consistent formatting throughout
- [ ] Core message preserved through all edits
- [ ] All links functional (if applicable)
- [ ] Consistent style applied (see style checklist)

---

## Best Practices

1. **Edit in passes, not all at once** — Trying to fix everything in one read misses issues. Each sweep catches what the others miss.

2. **Preserve the author's voice** — Good copy editing enhances; it does not replace. Maintain the original voice while improving clarity and impact.

3. **Every edit needs a reason** — Never change a word without explaining the principle. "Changed because it is clearer" or "Replaced because the original was vague."

4. **Prioritize by conversion impact** — Fix the CTA before fixing a comma. Fix the headline before fixing paragraph 12.

5. **Read aloud** — Voice and rhythm problems become obvious when read aloud. If it sounds wrong spoken, it reads wrong too.

6. **Flag what you cannot fix** — If a claim needs proof the author must provide, flag it clearly. You can improve phrasing but you cannot invent evidence.

7. **Re-check previous sweeps** — Each sweep can introduce issues caught by earlier sweeps. Always go back.

8. **Cut first, add second** — Most marketing copy is 20-30% too long. Cut the fat before adding new content.

9. **Get context before editing** — A copy edit without knowing the audience, goal, and voice standard produces misaligned feedback.

10. **Track recurring issues** — If the same problems appear across multiple pieces, the issue is systemic. Flag it as a process improvement, not just an edit.

---

## Integration Points

- **Copywriting** — Use for writing new copy from scratch. Copy Editing handles reviewing and improving existing copy.
- **Content Humanizer** — Use when AI-generated copy needs humanization before editorial review.
- **Content Production** — Use Copy Editing as part of the production pipeline between drafting and publishing.
- **Brand Guidelines** — Reference brand voice and style standards during the Voice and Tone sweep.
- **Marketing Psychology** — Apply psychological principles during the Heightened Emotion sweep.
- **Content Strategy** — Use when the problem is what to say, not how to say it.

---

## Troubleshooting

| Problem | Likely Cause | Fix |
|---------|-------------|-----|
| Same issues appear across multiple pieces from the same writer | Systemic writing habit, not a one-off error | Create a writer-specific checklist of recurring issues; address in style guide or training, not just per-piece edits |
| Copy loses its original voice after editing | Editor over-corrected; replaced author voice with editor's style | Preserve author voice — enhance clarity and impact without rewriting personality. Read original aloud before editing |
| Edits introduce new inconsistencies | Previous sweeps not re-checked after later sweeps modified content | Always re-run earlier sweeps after making changes — Sweep 7 edits can break Sweep 1 clarity |
| CTA buried or ineffective despite multiple edit passes | CTA was not the focus of any sweep — copy editing focused on prose quality | Prioritize CTA area first (Sweep 7: Zero Risk) before polishing earlier sections |
| Fact-checking reveals unverifiable claims | Writer invented statistics or used outdated data | Flag and return to writer — editor cannot invent evidence. Document all unverifiable claims explicitly |
| Style inconsistencies between sections | Multiple writers contributed or copy was assembled from different drafts | Run style consistency checklist end-to-end; standardize contractions, heading case, number format, and punctuation |

---

## Success Criteria

- **Seven Sweeps completion**: All 7 sweeps completed per piece with previous sweeps re-verified after each pass
- **Error rate**: Zero grammatical errors, typos, or broken links in published copy
- **Style consistency**: 100% adherence to documented style guide (Oxford comma, heading case, number format, etc.)
- **Fact verification**: All statistics have named source and year; all claims are verifiable or labeled as opinion
- **CTA effectiveness**: Every piece has a clear, specific CTA visible within 2 scrolls of the content end
- **Clarity score**: Every sentence understandable on first read — zero ambiguous pronoun references or multi-clause confusion
- **Edit turnaround**: 48-hour maximum turnaround on editorial review with clear change documentation

---

## Scope & Limitations

**In scope:**
- Seven Sweeps editorial framework (clarity, voice, so-what, proof, specificity, emotion, zero-risk)
- Quick-pass editing (word-level, sentence-level, paragraph-level)
- Style consistency auditing and enforcement
- Fact-checking protocol for claims, statistics, and competitive references
- Pre-edit and post-edit checklists
- Common copy problem diagnosis and fixing

**Out of scope:**
- Writing new copy from scratch (use Copywriting skill)
- AI content detection and humanization (use Content Humanizer)
- SEO optimization passes (use Content Production optimization pipeline)
- Content strategy or topic selection (use Content Strategy)
- Visual design or layout feedback
- Legal review of marketing claims

**Known limitations:**
- Cannot verify internal company claims (product capabilities, uptime SLAs) without access to product documentation
- Fact-checking external claims requires access to original sources — may need writer input
- Style consistency requires an existing style guide; without one, editor must make judgment calls
- Emotional impact (Sweep 6) is subjective and varies by audience — use target audience context
- Multi-language copy editing requires native-level proficiency in each language

---

## Scripts

```bash
# Score content readability with detailed metrics
python scripts/readability_scorer.py article.md --json

# Detect AI patterns that need humanization before editing
python scripts/ai_pattern_detector.py article.md --verbose

# Check style consistency across multiple documents
python scripts/style_checker.py --files doc1.md doc2.md doc3.md --json
```

© borghei · MIT · borghei/Claude-Skills

Similar skills

All skills for Marketing and content →

copy-editing by other authors comes first.

copy-editing coreyhaines31 copy-editing — a skill for editing marketing copy, emails, and descriptions without full rewrite. CX Codex +1 163,900installs copy-editing OpenClaudia Line-by-line copy editing for marketing content to sharpen clarity and cut filler words. Helpful when preparing landing pages, product announcements, and sales emails. CX Codex +1 458installs brand-voice arnabbagxd Generates a brand voice guide with tone dimensions, vocabulary lists, and channel rules. Helpful when onboarding writers or standardizing copy. CX Codex +1 2,200installs website-copy-specialist ncklrs website-copy-specialist writes copy for SaaS and B2B pages: homepage, pricing, comparisons, integrations, navigation microcopy. Useful when you need text for a specific page, not generic advice. CX Codex +1 582installs writing-copy spencerpauly writing-copy — a skill that gives the agent rules for marketing copy: headlines, CTAs, emails, interface microcopy. Useful when landing pages and UI text live in the same repo. CX Codex +1 475installs market-brand zubair-trabzada market-brand reads a brand's pages and social profiles, scores its tone on four scales, and writes a voice document any copywriter on the team can follow. CX Codex +1 ★ 2,938repo stars content-engine Indranil Banerjee content-engine is a skill that writes blogs, ads, emails, and social posts in a brand voice, applying its profile, platform limits, and industry rules. CX Codex +1 ★ 1,596repo stars brand-copy genspark-ai brand-copy turns product details and target audience inputs into Markdown taglines, selling points, and brand stories. CX Codex +1 ★ 12,746repo stars

From the same set120

The whole set →
codebase-onboarding codebase-onboarding — a skill for Claude Code, Codex, Cursor and several other agents that scans a repository and produces onboarding docs: architecture overview, key file map, local setup guide, and debugging reference. CX Codex +1 117installs stripe-integration-expert stripe-integration-expert is a Claude Code skill for building Stripe billing integrations for SaaS, covering subscriptions, webhooks, and local testing with Stripe CLI. CX Codex +1 116installs summarize-meeting summarize-meeting — a skill for Claude Code and Codex that turns meeting transcripts into action items and logged decisions. Flags missing assignees or dates instead of inventing them. CX Codex +1 114installs executive-mentor executive-mentor challenges strategic plans, exposes blind spots, and prepares founders for tough board inquiries. CX Codex +1 113installs context-engine context-engine — a skill for Claude Code, Codex, Cursor, GitHub Copilot, and Gemini CLI that decides what goes into the context window, what gets written to persistent memory, and what is retrieved on demand. CX Codex +1 112installs competitive-teardown The competitive-teardown skill structures competitor research, product scoring, and side-by-side comparisons. Use it to inform a roadmap discussion or prepare sales material. CX Codex +1 112installs api-test-suite-builder api-test-suite-builder is a Claude Code skill that creates API test scaffolds from OpenAPI and checks endpoint coverage. Use it to add tests, audit assertions, or spot contract drift. CX Codex +1 111installs brainstorm-okrs brainstorm-okrs — a skill for AI-powered code editors that drafts and validates quarterly OKRs using the Radical Focus method: one objective, three measurable key results, and counter-metrics. CX Codex +1 111installs

Project sponsors

Companies that keep this analytics open