CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

65

Quality

80%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is copy-editing in alirezarezvani/claude-skills

SKILL.md
Quality
Evals
Security

Quality

Content

70%Weight 40%Scale 1-5

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

The body is a well-structured, highly actionable editing framework with strong workflow sequencing and validation loops. Its weaknesses are length/redundancy and progressive disclosure — substantial content is inlined rather than split into referenced files, and the bundle files it does reference are missing.

Suggestions

Consolidate or remove the redundant 'Common X killers/issues' subsections and the standalone Copy Editing Checklist, since both restate the seven sweeps already detailed above.

Actually provide the referenced bundle files (scripts/readability_scorer.py, scripts/ai_content_detector.py, references/plain-english-alternatives.md) or remove the references — broken paths make the executable commands non-functional.

Move the large Copy Editing Checklist and Common Copy Problems catalogs into a separate reference file linked from the overview to reduce the monolithic inline content.

DimensionReasoningScore

Conciseness

The ~500-line body is mostly relevant domain methodology rather than concepts Claude already knows, but it carries notable redundancy — the 'Common X killers/issues' subsections restate the 'What to check' bullets, and the Copy Editing Checklist section largely re-lists the seven sweeps — so it could be tightened.

3 / 5

Actionability

Concrete, specific guidance throughout: executable commands with flags ('python3 scripts/readability_scorer.py --file draft.md', '--json'), before/after So What examples, and weak/strong replacement tables; the gap is that the referenced scripts do not exist in the bundle, so the commands are not actually copy-paste runnable.

4 / 5

Workflow Clarity

The Seven Sweeps Framework is an explicit numbered sequence with validation checkpoints and feedback loops — Sweep 1 re-runs the scorer to confirm the Flesch score improves, each sweep loops back to prior sweeps, and the process repeats 'until a full sweep finds no new issues', plus a full checklist.

5 / 5

Progressive Disclosure

Section headers and navigation are clear, but the document is monolithic with large inline blocks (the checklist, common-problems catalog, quick-pass tables) that would fit better in separate files, and the single References link (references/plain-english-alternatives.md) and the two referenced scripts point to files that do not exist in the bundle.

3 / 5

Total

15

/

20

Passed

Description

91%Weight 40%Scale 1-5

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

The description is strong: third-person voice, explicit what-and-when structure, and a rich set of natural trigger phrases. Its only weakness is that the listed actions (edit/review/improve) are generic verbs and the distinctive seven-sweep methodology is not surfaced.

DimensionReasoningScore

Specificity

Names the domain ('existing marketing copy') and several concrete actions ('edit, review, or improve') plus the method ('systematic approach... through multiple focused passes'), but does not enumerate the specific seven sweeps, leaving minor gaps in coverage.

4 / 5

Completeness

Explicitly answers both what ('edit, review, or improve existing marketing copy' via 'multiple focused passes') and when ('When the user wants to...' and 'Also use when the user mentions...') with concrete trigger phrases, matching the top anchor.

5 / 5

Trigger Term Quality

Comprehensive natural trigger phrases users would actually say — 'edit this copy,' 'review my copy,' 'copy feedback,' 'proofread,' 'polish this,' 'make this better,' 'copy sweep' — with multiple synonyms for the same intent.

5 / 5

Distinctiveness Conflict Risk

The 'existing marketing copy' framing distinguishes it from new-copy skills and triggers are specific, but 'improve existing marketing copy' and 'make this better' are broad enough to risk minor overlap with related marketing skills like content-humanizer or copywriting.

4 / 5

Total

18

/

20

Passed

Validation

81%

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

Validation13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (503 lines); consider splitting into references/ and linking

Warning

relative_links

Relative link issues: 1 missing

Warning

referenced_paths_exist

Referenced path issues: 3 missing

Warning

Total

13

/

16

Passed

Repository
alirezarezvani/claude-skills
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.