When the user wants to edit, review, or improve existing marketing copy. Also use when the user mentions 'edit this copy,' 'review my copy,' 'copy feedback,' 'proofread,' 'polish this,' 'make this better,' or 'copy sweep.' This skill provides a systematic approach to editing marketing copy through multiple focused passes.
71
64%
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 ./config/claude/skills/copy-editing/SKILL.mdQuality
Discovery
82%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 solid description with excellent trigger term coverage and clear completeness, explicitly stating both what the skill does and when to use it. Its main weaknesses are the lack of specific concrete actions (what kinds of edits or passes are performed) and some risk of overlap with general editing/proofreading skills due to generic trigger terms like 'proofread' and 'make this better.'
Suggestions
Add more specific concrete actions to improve specificity, e.g., 'Checks tone consistency, tightens headlines, strengthens CTAs, and ensures brand voice alignment through multiple focused editing passes.'
Qualify generic triggers like 'proofread' and 'make this better' with 'marketing' context to reduce conflict risk with general writing/editing skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description mentions 'editing marketing copy through multiple focused passes' and lists actions like 'edit, review, or improve,' but doesn't specify concrete actions (e.g., tighten headlines, fix tone inconsistencies, check CTAs). The actions remain somewhat general. | 2 / 3 |
Completeness | Clearly answers both 'what' (systematic approach to editing marketing copy through multiple focused passes) and 'when' (explicit 'Use when' triggers with multiple natural phrases). The when clause is explicit and detailed. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms users would actually say: 'edit this copy,' 'review my copy,' 'copy feedback,' 'proofread,' 'polish this,' 'make this better,' 'copy sweep.' These are realistic phrases users would use. | 3 / 3 |
Distinctiveness Conflict Risk | The focus on 'marketing copy' editing is somewhat distinctive, but terms like 'proofread,' 'make this better,' and 'polish this' are generic enough to potentially overlap with general writing/editing skills. The 'marketing copy' qualifier helps but doesn't fully prevent conflicts. | 2 / 3 |
Total | 10 / 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.
The skill demonstrates strong workflow design with its seven sweeps framework and explicit feedback loops, but is severely over-long for a skill file. Much of the content teaches general copywriting editing principles that Claude already knows (what clarity means, why specificity matters, common weak words). The content would be significantly more effective as a concise overview with the detailed sweep instructions and checklists moved to reference files.
Suggestions
Reduce the main skill to ~80 lines: keep the sweep names/focus areas as a concise checklist and move detailed sweep instructions to a separate reference file like `references/seven-sweeps-detail.md`
Remove content Claude already knows: word replacement tables (utilize→use), sentence-level writing advice, and explanations of concepts like 'what is clarity in copy'—keep only project-specific conventions and non-obvious guidance
Move the Common Copy Problems & Fixes section and the full checklist to separate reference files, linking to them from the main skill
Trim each sweep to 3-4 lines max in the main file: the focus question, 2-3 key non-obvious checks, and the feedback loop instruction
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | This skill is extremely verbose at ~350+ lines. It over-explains concepts Claude already understands (what clarity means, what voice consistency is, what emotion in copy looks like). The seven sweeps framework, while structured, repeats patterns extensively and includes obvious advice like 'no typos or grammatical errors.' The word replacement tables and common problems sections contain knowledge Claude already has. | 1 / 3 |
Actionability | The skill provides concrete examples (before/after comparisons, specificity tables, word replacements) and structured processes for each sweep. However, it lacks executable code or commands since it's an instruction-only skill, and the guidance is more of a general copywriting education than specific, copy-paste-ready editing instructions. The examples like the 'So What' test are genuinely useful and actionable. | 2 / 3 |
Workflow Clarity | The seven sweeps framework provides a clear sequential workflow with explicit validation steps—each sweep includes a process section with numbered steps, and importantly includes feedback loops ('After this sweep: Return to previous sweeps'). The checklist at the end serves as a verification mechanism. The collaborative editing section also includes an iterative validation loop. | 3 / 3 |
Progressive Disclosure | There is one reference to an external file (plain-english-alternatives.md) and cross-references to related skills, which is good. However, the massive amount of inline content (all seven sweeps fully detailed, quick-pass checks, common problems, full checklist) should be split into separate reference files with the SKILL.md serving as an overview. The content is essentially a monolithic wall of text despite having headers. | 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 |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
2c6f6e8
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.