copy-editing
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.
83
Quality
79%
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 description excels at providing explicit trigger terms and clear 'when to use' guidance, making it easy for Claude to select. However, it lacks specificity about what concrete editing actions are performed (grammar, tone, structure, etc.), and some trigger terms like 'proofread' and 'make this better' are generic enough to potentially conflict with other editing skills.
Suggestions
Add specific concrete actions the skill performs, e.g., 'Checks grammar, tightens prose, improves headlines, ensures brand voice consistency, and strengthens CTAs.'
Narrow generic triggers like 'proofread' and 'make this better' by qualifying them with 'marketing' context to reduce conflict risk with general editing skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (marketing copy editing) and mentions 'systematic approach' with 'multiple focused passes,' but doesn't list specific concrete actions like 'fix grammar, improve headlines, tighten sentences, check brand voice.' | 2 / 3 |
Completeness | Clearly answers both what (edit, review, improve marketing copy through systematic multi-pass approach) and when (explicit 'Use when' clause with specific trigger phrases). The 'Also use when' structure provides explicit guidance. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms users would say: 'edit this copy,' 'review my copy,' 'copy feedback,' 'proofread,' 'polish this,' 'make this better,' 'copy sweep' - these are realistic phrases users would naturally use. | 3 / 3 |
Distinctiveness Conflict Risk | Focuses on marketing copy editing which is somewhat specific, but could overlap with general writing/editing skills or proofreading skills. The 'marketing copy' qualifier helps but 'proofread' and 'make this better' are generic enough to cause conflicts. | 2 / 3 |
Total | 10 / 12 Passed |
Implementation
77%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, highly actionable skill with an excellent workflow framework (seven sweeps with feedback loops). The main weakness is verbosity—the skill explains many concepts Claude already knows and could benefit from splitting detailed reference content into separate files. The actionability and workflow clarity are strong, making this effective despite being longer than necessary.
Suggestions
Move the detailed checklists and word replacement tables to separate reference files (e.g., references/editing-checklists.md, references/word-replacements.md) and link to them from the main skill
Trim explanatory content that Claude already knows, such as definitions of passive voice, nominalizations, and basic writing principles—focus on the specific framework and decision criteria instead
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is comprehensive but verbose in places. Some sections explain concepts Claude would know (e.g., what passive voice is, basic writing principles). The tables and checklists add value but the overall length (~400 lines) could be tightened significantly. | 2 / 3 |
Actionability | Highly actionable with concrete examples, before/after comparisons, specific word replacements, and clear checklists. The seven sweeps framework provides explicit steps with specific things to check and how to fix them. | 3 / 3 |
Workflow Clarity | Excellent workflow structure with the seven sweeps framework. Each sweep has clear focus, process steps, and explicit feedback loops ('After this sweep: Return to...'). The iterative validation approach is well-defined. | 3 / 3 |
Progressive Disclosure | Content is well-organized with clear sections, but almost everything is inline rather than split into reference files. Only one external reference exists (plain-english-alternatives.md). The checklists and detailed sweep content could be separate files for better navigation. | 2 / 3 |
Total | 10 / 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 | |
- Repository
- freekmurze/dotfiles
- Commit
355d067
- Reviewed
Table of Contents
Is this your skill?
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.