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.

71

Quality

64%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./config/claude/skills/copy-editing/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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.

DimensionReasoningScore

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

DimensionReasoningScore

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.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
freekmurze/dotfiles
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.