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 copywriting.
74
68%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/copy-editing/SKILL.mdQuality
Discovery
89%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong skill description with excellent trigger term coverage and clear completeness, explicitly answering both what the skill does and when to use it. The boundary with the related copywriting skill is well-drawn. The main weakness is that the 'what' portion could be more specific about the concrete actions performed (e.g., tone adjustment, readability improvements, structural edits) rather than staying at the general 'edit, review, improve' level.
Suggestions
Add more specific concrete actions to the 'what' portion, e.g., 'Tightens verbose prose, fixes tone inconsistencies, improves readability, restructures awkward sentences, and updates stale messaging in existing marketing copy.'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (marketing copy editing) and some actions like 'edit, review, or improve existing marketing copy, or refresh outdated content,' but doesn't list multiple specific concrete actions (e.g., tighten headlines, fix tone inconsistencies, restructure paragraphs). The actions remain somewhat general. | 2 / 3 |
Completeness | Clearly answers both 'what' (edit, review, improve existing marketing copy, refresh outdated content) and 'when' (explicit 'Use when' clause with extensive trigger phrases). Also includes a helpful boundary condition distinguishing it from the copywriting skill for new copy. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms users would actually say: 'edit this copy,' 'proofread,' 'polish this,' 'make this better,' 'too wordy,' 'tighten this up,' 'this reads awkwardly,' 'clean up this text,' 'sharpen the messaging,' 'refresh this content,' 'content audit,' etc. These are highly natural and varied. | 3 / 3 |
Distinctiveness Conflict Risk | Clearly distinguished from general copywriting by explicitly stating it's for existing copy improvement rather than writing from scratch, and even references the sister skill ('For writing new copy, see copywriting'). The niche of copy editing/polishing is well-defined and unlikely to conflict with other skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
47%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured copy editing framework with a clear sequential workflow (Seven Sweeps) and good validation checkpoints, but it is far too verbose for a skill file. The content repeats itself significantly (sweeps described in detail, then repeated as checklists), explains concepts Claude already knows (basic editing principles, what passive voice is), and includes extensive inline content that should be in reference files. The actionability is moderate — good examples exist but the skill is more of a comprehensive copywriting guide than a concise, actionable skill.
Suggestions
Reduce the skill to ~100 lines by condensing each sweep to 2-3 lines (name, focus question, key checks) and moving detailed explanations, examples, and checklists to a reference file like references/seven-sweeps-detail.md
Remove the Copy Editing Checklist section entirely — it duplicates the sweeps content and adds no new information
Move the Expert Panel Scoring section, Quick-Pass Editing Checks, and Common Copy Problems & Fixes to separate reference files, linking to them from the main skill
Cut explanatory text that Claude already knows (e.g., what passive voice is, what nominalizations are, general principles like 'one idea per sentence') and keep only the project-specific conventions and frameworks
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | This skill is extremely verbose at ~400+ lines. It explains concepts Claude already knows (what passive voice is, what adverbs are, basic editing principles), includes extensive checklists that repeat the sweep content, and provides lengthy explanations of obvious concepts like 'Good copy editing isn't about rewriting—it's about enhancing.' The seven sweeps framework alone could be condensed to a fraction of its size. | 1 / 3 |
Actionability | The skill provides concrete examples (before/after tables, specific word replacements, the 'so what' test with examples) and structured processes for each sweep. However, it lacks executable code or commands, and much of the guidance remains at the level of general copywriting advice rather than specific, copy-paste-ready instructions Claude can directly apply. | 2 / 3 |
Workflow Clarity | The seven sweeps framework provides a clear sequential process with explicit validation steps — each sweep includes a defined process (mark → recommend → verify) and instructs to loop back through previous sweeps after each pass. The expert panel scoring adds a clear quality gate with specific thresholds (all personas 7+, average 8+). The iterative feedback loop is well-defined. | 3 / 3 |
Progressive Disclosure | The skill references two external files (plain-english-alternatives.md, content-refresh.md) and links to related skills, which is good. However, the main file is monolithic — the seven sweeps, expert panel scoring, quick-pass checks, common problems, and checklists could all be split into separate reference files. The checklist section largely duplicates the sweep content inline. | 2 / 3 |
Total | 8 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
skill_md_line_count | SKILL.md is long (509 lines); consider splitting into references/ and linking | Warning |
Total | 10 / 11 Passed | |
2c7c108
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.