CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

62

Quality

78%

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

Fix and improve this skill with Tessl

tessl review fix ./marketing-skill/skills/copy-editing/SKILL.md
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 excels at actionability and workflow clarity — an explicit seven-pass sequence with loop-back checkpoints, runnable scoring scripts, and concrete before/after examples. It is dragged down by significant redundancy (each sweep's twin bullet lists, the verbatim checklist restatement, inline tables duplicating a bundled reference) and one orphaned reference file, making the ~500-line body noticeably less token-efficient than its content warrants.

Suggestions

Collapse each sweep's 'What to check' and 'Common issues' lists into a single deduplicated list, and cut the per-sweep loop-back sentences in favor of one statement of the return-chain rule at the top of the framework — this alone would remove well over a hundred lines.

Move the 'Copy Editing Checklist' section into a reference file (e.g., references/copy-editing-checklist.md) and keep only a pointer, since it restates all seven sweeps; likewise replace the inline word-replacement tables with a pointer to references/plain-english-alternatives.md.

Link references/ai-detection-patterns.md from the AI-Pattern Check section so the detector's output can be interpreted with the bundled patterns, and ensure every bundle file is reachable from SKILL.md.

DimensionReasoningScore

Conciseness

The body is noticeably verbose through systematic duplication: every sweep carries two overlapping bullet lists (e.g., Sweep 3's 'What to check: Features without benefits / Claims without consequences...' vs. 'Common So What failures: Feature lists without benefit connections...'), a per-sweep loop-back note that restates the return chain seven times, a ~50-line 'Copy Editing Checklist' that restates all seven sweeps nearly verbatim, and a word-replacement table ('Utilize→Use, Leverage→Use...') that duplicates the bundled references/plain-english-alternatives.md. This matches anchor 2 ('noticeably verbose; several unnecessary explanations or padded sections') — the duplicated material is domain-specific rather than concepts Claude already knows, so it is not the severe padding of anchor 1, but 'mostly efficient' (anchor 3) does not hold for a ~500-line body whose second half repeats its first.

2 / 5

Actionability

Guidance is fully executable for an instruction-only skill: two runnable commands with flags and expected outputs ('python3 scripts/readability_scorer.py --file draft.md' with '--json', 'python3 scripts/ai_content_detector.py draft.md --json'), numbered per-sweep processes, a concrete before/after example (❌ 'Our platform uses AI-powered analytics' → ✅ benefit-bridged rewrite), specific vague→specific replacement tables, symptom/fix problem patterns, and an output-artifacts table mapping requests to deliverables. It matches anchor 5 — copy-paste-ready commands with specific examples covering the common cases.

5 / 5

Workflow Clarity

The Seven Sweeps Framework is a clearly sequenced multi-step process with explicit checkpoints: each sweep ends with a return-loop instruction ('After this sweep: Return to So What, Voice and Tone, then Clarity'), Sweep 1 embeds a mechanical validation loop ('re-run the scorer; the Flesch score should improve, not regress'), and the collaborative workflow closes with 'Repeat until clean — Continue until a full sweep finds no new issues.' Editing is non-destructive and the AI-detector pre-check gates the workflow ('polishing AI mush produces polished AI mush'). This matches anchor 5: clear sequence, explicit validation steps, feedback loops, and a checklist.

5 / 5

Progressive Disclosure

Structure exists (clear section headers, one properly signaled reference: '[Plain English Alternatives](references/plain-english-alternatives.md)', and both scripts referenced with usage), but scored against the actual bundle it has real gaps: references/ai-detection-patterns.md exists in the bundle yet is never linked from SKILL.md — the AI-Pattern Check section runs the detector but does not point to the patterns file — and substantial content that belongs in reference files is inlined (the word-level 'Cut these/Replace these' tables duplicate plain-english-alternatives.md, and the full checklist section restates the sweeps). This matches anchor 3 ('some structure... content that should be separate is inline') rather than anchor 4, where most content would be appropriately placed.

3 / 5

Total

15

/

20

Passed

Description

77%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.

A strong description with excellent, natural trigger coverage and an explicit dual 'when' clause. Its main weakness is an under-specified 'what' — the verbs are generic and the seven concrete editing sweeps never surface, so the user learns when to invoke it better than what they will get.

Suggestions

Enumerate the concrete editing passes in the 'what' sentence, e.g., '...through seven focused passes: clarity, voice and tone, benefit bridges, proof, specificity, emotion, and risk reduction.'

Mention the deliverables (sweep-by-sweep report with proposed edits, quick-pass word-level edits, completed checklist) so the 'what' answers what the user receives, not just the internal method.

Tighten the generic triggers ('polish this,' 'make this better') by scoping them to copy, e.g., 'make this copy better,' to reduce overlap with general proofreading requests.

DimensionReasoningScore

Specificity

The description names the domain ('existing marketing copy') and a couple of generic actions ('edit, review, or improve'), plus a mechanism ('systematic approach to editing marketing copy through multiple focused passes'), but it never enumerates the concrete actions the skill performs (e.g., the seven sweeps: clarity, tone, proof, specificity, risk reduction). It matches anchor 3 ('names domain and 1-2 concrete actions, but not comprehensive') rather than anchor 4, which expects several specific actions listed; it is above anchor 2 because the domain and approach are clearly stated rather than minimal.

3 / 5

Completeness

Both parts are present: an explicit 'when' (twice — 'When the user wants to edit...' and 'Also use when the user mentions...') with concrete trigger phrases, and a 'what' ('provides a systematic approach to editing marketing copy through multiple focused passes'). It falls short of anchor 5 because the 'what' is a single high-level sentence rather than a concrete statement of what the skill actually does or produces; it is above anchor 4's typical weakness because the 'when' is highly explicit and specific.

4 / 5

Trigger Term Quality

The trigger list is comprehensive and natural: "'edit this copy,' 'review my copy,' 'copy feedback,' 'proofread,' 'polish this,' 'make this better,' or 'copy sweep'" — these are exactly the synonyms and phrasings a user would say, covering review, edit, feedback, and proofreading verbs with variations. It clearly matches anchor 5 (comprehensive coverage of natural terms including synonyms); no file extensions are relevant to this domain, and the variation coverage exceeds anchor 4's 'good coverage, a few natural terms missing'.

5 / 5

Distinctiveness Conflict Risk

The niche is clear (editing existing marketing copy vs. writing new copy, which the related-skill table distinguishes), and most triggers are copy-specific. Minor overlap risk remains from generic phrases like 'polish this' and 'make this better,' which a user could say about non-marketing text (essays, emails, code docs), pulling in this skill for general proofreading. That matches anchor 4 ('mostly distinct; minor overlap risk with closely related skills') rather than anchor 5, whose triggers are unambiguous.

4 / 5

Total

16

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

skill_md_line_count

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

Warning

Total

15

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

marketing-skill/skills/copy-editing/SKILL.md

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.