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.

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

The canonical home for this skill is copy-editing in coreyhaines31/marketingskills

Quality

Content

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

Highly actionable and well-sequenced with strong feedback loops, but the body is long and somewhat monolithic — most reference-grade material (word/replace tables, common-problem fixes) is inline rather than offloaded to bundle files, capping both conciseness and progressive disclosure at the middle anchor.

Suggestions

Move the Quick-Pass Editing Checks (word-level/sentence-level/paragraph-level tables) and the 'Common Copy Problems & Fixes' section into separate reference files, keeping SKILL.md as an overview of the seven sweeps.

Tighten the per-sweep template: the 'Common ... killers/issues' subsections often restate the 'What to check' bullets and can be merged to cut length.

Collapse the duplicated Copy Editing Checklist, which repeats each sweep's checks; reference it once or move it to a bundled checklist file.

Dimension	Reasoning	Score
Conciseness	Mostly efficient and free of generic concept explanation, but the seven sweeps each repeat a full 'What to check / Common issues / Process / After this sweep' template plus a duplicated checklist section, adding length that could be tightened without losing value.	2 / 3
Actionability	Provides concrete, ready-to-use guidance throughout — specificity upgrade tables (vague→specific), word-replacement tables, named sweeps with explicit questions like the 'So what?' test, and a checklist — all directly applicable.	3 / 3
Workflow Clarity	The Seven Sweeps are explicitly sequenced with 'After this sweep: Return to...' feedback loops for re-checking earlier sweeps, plus a 'Working with Copy Sweeps' iterative loop ('Repeat until clean') and a structured before/during/final checklist.	3 / 3
Progressive Disclosure	The single real reference (references/plain-english-alternatives.md) is correctly signaled one level deep, but the SKILL.md itself is a ~440-line monolith that keeps substantial inline reference material (full tables, problem/fix lists, quick-pass checks) which could be split into separate files rather than living in the overview.	2 / 3
	Total	10 / 12 Passed

Description

92%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, specific description with explicit trigger phrases and a clear what/when statement, all in third person. Slight overlap risk with general writing/copywriting skills keeps distinctiveness below the top anchor.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions ('edit, review, or improve existing marketing copy', 'proofread,' 'polish this,' 'copy sweep') plus a described approach ('systematic approach to editing marketing copy through multiple focused passes').	3 / 3
Completeness	Explicitly answers what it does ('systematic approach to editing marketing copy through multiple focused passes') and when to use it ('When the user wants to edit, review, or improve existing marketing copy. Also use when the user mentions...') with explicit trigger guidance.	3 / 3
Trigger Term Quality	Includes natural phrases a user would say — 'edit this copy,' 'review my copy,' 'copy feedback,' 'proofread,' 'polish this,' 'make this better,' 'copy sweep' — with strong coverage of variations.	3 / 3
Distinctiveness Conflict Risk	Niche is fairly distinct (marketing copy editing) but 'review my copy,' 'make this better,' and 'proofread' could overlap with general copywriting or generic writing-improvement skills, leaving some conflict risk.	2 / 3
	Total	11 / 12 Passed

Validation

93%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: TheCraigHewitt/seomachine
Path: .claude/skills/copy-editing/SKILL.md
Commit: 70231da

Reviewed: about 13 hours ago

Table of Contents

Discovery Implementation Validation

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.