CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cw-simplify

Rewrite complex text in plainer language. Invoke with /cw-simplify or /cw-simplify [paste text].

Quality

76%

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 ./skills/cw-simplify/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

88%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 content is a well-structured, highly actionable instruction skill with a clear workflow and a useful moves table and output template. The main improvement would be reducing duplication between the steps, principles, and table, and either filling or removing the empty Lessons placeholder.

Suggestions

Consolidate overlapping guidance between "How to Simplify", "Principles", and the "Simplification Moves" table to reduce redundancy and token cost.

Remove or populate the empty "Lessons" placeholder rather than shipping a section with no content.

Consider tightening the Principles list since each item restates a move already covered in the steps and table.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence without explaining basic concepts, but the Principles, Simplification Moves table, and How to Simplify steps overlap noticeably, and the empty "Lessons" placeholder adds tokens without value.

4 / 5

Actionability

Concrete directive steps, a copy-paste-ready Output Format template, and a Complex→Simplified moves table provide fully executable, specific guidance covering the common cases for an instruction-only skill.

5 / 5

Workflow Clarity

The numbered "How to Simplify" sequence is clear and unambiguous for this simple, non-destructive single-purpose skill, meeting the simple-skill exception where a single clear action can score 5 without validation checkpoints.

5 / 5

Progressive Disclosure

Content is well-organized with clear section headers and needs no external references, but the body slightly exceeds the 50-line simple-skill threshold and the empty Lessons placeholder is a minor organization gap.

4 / 5

Total

18

/

20

Passed

Description

53%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 states a clear purpose and is reasonably distinct, but it provides only one concrete action and lacks an explicit "Use when" trigger clause, capping both specificity and completeness. It would benefit from listing concrete sub-actions and adding explicit trigger guidance.

Suggestions

Add an explicit "Use when..." clause naming natural triggers, e.g. "Use when the user asks to simplify, clarify, or rewrite text in plainer language."

Expand the action list to be more comprehensive, e.g. "Rewrite complex text in plainer language, shorten sentences, replace jargon, and clarify dense passages."

Include common synonyms users would actually say ("simplify", "plain English", "make this clearer") to improve trigger term coverage.

DimensionReasoningScore

Specificity

"Rewrite complex text in plainer language" names the domain and one concrete action but does not enumerate multiple specific actions, matching the anchor that lists 1-2 concrete actions without comprehensive coverage.

3 / 5

Completeness

A clear "what" is present (rewrite complex text in plainer language) but there is no "Use when..." clause or equivalent explicit trigger guidance; per the rubric cap, missing explicit trigger guidance caps completeness at 3.

3 / 5

Trigger Term Quality

The description uses relevant natural terms ("Rewrite complex text", "plainer language") but omits common synonyms a user would say such as "simplify" or "plain English," leaving coverage partial rather than comprehensive.

3 / 5

Distinctiveness Conflict Risk

Plain-language rewriting is a fairly distinct niche with the dedicated `/cw-simplify` invocation, carrying only minor overlap risk with general editing or writing skills.

4 / 5

Total

13

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

EveryInc/compound-writing

Path

skills/cw-simplify/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.