Skip to content
cccskills
FreePublished on GitHub

copy-editing

Systematic copy editing via seven focused sweeps — clarity, voice, so-what, proof, specificity, emotion, zero-risk. For new copy use copywriting.

The English summary is being prepared. Showing the original description.

SebastianLuser/claude-code-arcane3 stars(GitHub 3 + cccskills 0)

Run score Not tested

See how to install

Files included (5)

  • SKILL.md5.8 KB
  • references/copy-editing-checklist.md3.7 KB
  • references/plain-english-alternatives.md8.0 KB
  • references/seven-sweeps-framework.md6.3 KB
  • scripts/readability_scorer.py10.3 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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 .claude/product-marketing-context.md exists, 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: Clarity, Voice & Tone, So What, Prove It, Specificity, Heightened Emotion, Zero Risk. After each sweep, loop back to verify previous sweeps aren't compromised.

See references/seven-sweeps-framework.md for the detailed guide per sweep.

See references/copy-editing-checklist.md for the full checklist, quick-pass word/sentence/paragraph checks, and common copy problems & fixes.


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.


References


Task-Specific Questions

  1. What's the goal of this copy? (Awareness, conversion, retention)
  2. What action should readers take?
  3. Are there specific concerns or known issues?
  4. What proof/evidence do you have available?

When to Use Each Skill

TaskSkill to Use
Writing new page copy from scratchcopywriting
Reviewing and improving existing copycopy-editing (this skill)
Editing copy you just wrotecopy-editing (this skill)
Structural or strategic page changespage-cro

Proactive Triggers

Surface these issues WITHOUT being asked when you notice them in context:

  • Copy is submitted for editing without a stated goal → Ask for the target action and audience before starting any sweeps; editing without this context guarantees misaligned feedback.
  • Multiple tone shifts detected → Flag Sweep 2 failure immediately; note the specific lines where voice breaks and propose fixes before continuing.
  • Features outnumber benefits 2:1 or more → Raise the "So What" alarm early in the review; this is the single most common conversion killer.
  • Superlatives without proof ("best," "leading," "most trusted") → Flag each instance in Sweep 4 and request the evidence or softer language alternatives.
  • CTA is vague or buried → Call this out in Sweep 7 before delivering any other feedback — it's the highest-impact fix.

Output Artifacts

When you ask for...You get...
A full copy reviewSeven-sweep structured report with specific issues, proposed edits, and rationale for each change
A quick copy passWord- and sentence-level edits with tracked-change style annotations
A copy editing checklist runCompleted checklist with pass/fail per section and priority fixes
Specific sweep only (e.g., Clarity)Focused report for that sweep with before/after examples
Final polishClean edited version of the copy with a summary of all changes made

Communication

All output follows the structured communication standard:

  • Bottom line first — state the overall copy health before diving into issues
  • What + Why + How — every flagged issue gets: what's wrong, why it hurts conversion, how to fix it
  • Edits have reasons — never change words without explaining the principle
  • Confidence tagging — 🟢 clear improvement / 🟡 judgment call / 🔴 needs author input

Deliver findings sweep-by-sweep. Don't dump all issues at once. Prioritize by conversion impact, not writing preference.


Related Skills

  • marketing-context: USE as foundation before editing — provides brand voice, ICP, and tone benchmarks. NOT a substitute for reading the copy itself.
  • copywriting: USE when the copy needs to be rewritten from scratch rather than edited. NOT for polishing existing drafts.
  • content-strategy: USE when the problem is what to say, not how to say it. NOT for line-level improvements.
  • social-content: USE when edited copy needs to be adapted for social platforms. NOT for page-level editing.
  • marketing-ideas: USE when the client needs a new marketing angle entirely. NOT for editorial improvement.
  • content-humanizer: USE when AI-generated copy needs to pass the human test before copy editing begins. NOT for structural review.
  • ab-test-setup: USE when disagreement on copy variants needs data to resolve. NOT for the editing process itself.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Plan, design, and implement A/B tests and experiments with statistical rigor. Covers hypothesis frameworks, sample sizing, metrics, and result analysis.

The English summary is being prepared. Showing the original description.

SebastianLuser/claude-code-arcane3Updated Oct 27, 2026

Web/mobile accessibility decision guide: WCAG 2.2 AA, ARIA, keyboard nav, focus management, contrast, testing. Use for: a11y, accessibility, wcag, aria, screen reader, keyboard, contrast.

The English summary is being prepared. Showing the original description.

SebastianLuser/claude-code-arcane3Updated Oct 27, 2026

Generate, iterate, and scale ad creative for paid advertising across Google, Meta, LinkedIn, and X. Covers platform specs, creative frameworks, and quality validation.

The English summary is being prepared. Showing the original description.

SebastianLuser/claude-code-arcane3Updated Oct 27, 2026

Musica interactiva para juegos: layering vertical, re-secuenciacion horizontal, stingers, reglas de transicion con sync points, y mapeo de estados de gameplay a musica. Usar para: musica adaptativa, sistema de musica dinamica, transiciones musicales, combat music.

The English summary is being prepared. Showing the original description.

SebastianLuser/claude-code-arcane3Updated Oct 27, 2026

Design multi-agent systems, create agent architectures, define communication patterns, and build autonomous agent workflows with structured evaluation frameworks.

The English summary is being prepared. Showing the original description.

SebastianLuser/claude-code-arcane3Updated Oct 27, 2026

Inter-agent communication protocol for C-suite agent teams. Defines invocation syntax, loop prevention, isolation rules, response formats, and quality loops.

The English summary is being prepared. Showing the original description.

SebastianLuser/claude-code-arcane3Updated Oct 27, 2026

See all skills by SebastianLuser

Report a problem with this skill