CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

clarify

Improve unclear UX copy, error messages, microcopy, labels, and instructions to make interfaces easier to understand. Use when the user mentions confusing text, unclear labels, bad error messages, hard-to-follow instructions, or wanting better UX writing.

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 ./templates/skills/impeccable/clarify/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 well-organized with a clear multi-phase workflow and genuinely useful before/after examples, but it over-teaches writing fundamentals Claude already knows and inlines a long example catalog that belongs in a separate reference file. Tightening the prose and splitting the catalog would meaningfully improve token efficiency and structure.

Suggestions

Move the area-by-area Bad/Good example catalog (Error Messages through Navigation & Wayfinding) into a single one-level-deep reference file (e.g., references/copy-examples.md), keeping SKILL.md as a lean overview of the assess → plan → improve → verify workflow — this addresses both progressive disclosure and token efficiency.

Delete motivational filler ('**CRITICAL**: Clear copy helps users succeed...', '**IMPORTANT**: Good UX writing is invisible...') and re-taught basics (passive voice explanation, 'Be specific/concise/active/human') that Claude already knows; keep only the skill-specific principles and examples.

Clarify the MANDATORY PREPARATION step: state where /frontend-design and /teach-impeccable live or what to do if they are unavailable, and inline the few context-gathering questions that matter (audience, mental state) rather than delegating to another skill's protocol.

DimensionReasoningScore

Conciseness

The ~175-line body includes meaningful structure but also notable content Claude already knows: generic writing principles ('Be specific', 'Be concise', 'Be human'), an explanation of passive voice, and motivational filler like '**CRITICAL**: Clear copy helps users succeed. Unclear copy creates frustration, errors, and support tickets.' and '**IMPORTANT**: Good UX writing is invisible.' This matches the 'mostly efficient but includes some unnecessary explanation or could be tightened' anchor — not a 2 because the Bad/Good example pairs do add skill-specific value, not a 4 because the padding and re-taught basics are more than minor.

3 / 5

Actionability

As an instruction-only skill, it delivers concrete guidance through consistent Bad→Good example pairs across every copy area ('Error 403: Forbidden' → 'You don't have permission to view this page. Contact your admin for access.') plus explicit principles and a verification checklist. It is not a 5 because the actual delivery workflow (where to find copy, how to present rewrites to the user) is only loosely defined and the mandatory prep depends on external skills.

4 / 5

Workflow Clarity

There is a clear sequenced workflow — MANDATORY PREPARATION → Assess Current Copy → Plan Copy Improvements → Improve Copy Systematically → Apply Clarity Principles → Verify Improvements — with a verification checkpoint covering comprehension, actionability, brevity, consistency, and tone. It stops short of 5 because the verification step offers no fix-and-recheck loop, and the 'MANDATORY PREPARATION' section's dependency on /frontend-design and /teach-impeccable is underspecified (no fallback if those are unavailable). Not a destructive/batch skill, so no cap applies.

4 / 5

Progressive Disclosure

This is a single-file skill with no references/ bundle; the ~100-line area-by-area Bad/Good example catalog (Error Messages through Navigation & Wayfinding) is inlined in SKILL.md when it clearly belongs in a reference file, matching the 'content that should be separate is inline' anchor. It is not a 2 because the body itself is well-sectioned with clear headers, and not a 4 because the inline catalog makes SKILL.md a monolith rather than an overview pointing to detailed material.

3 / 5

Total

14

/

20

Passed

Description

83%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: it clearly states what the skill does and when to use it, with natural trigger phrases and a well-defined niche. The only weaknesses are a single action verb spread across many objects and a few missing synonyms for trigger coverage.

DimensionReasoningScore

Specificity

The description enumerates several specific artifact types it improves — 'unclear UX copy, error messages, microcopy, labels, and instructions' — plus a concrete goal ('make interfaces easier to understand'), matching the anchor for several specific targets with minor gaps. It falls short of a 5 because there is only one action verb ('Improve') rather than multiple distinct actions, and above a 3 because the coverage of target artifacts is comprehensive, not partial.

4 / 5

Completeness

It explicitly answers both questions: what it does ('Improve unclear UX copy, error messages, microcopy, labels, and instructions to make interfaces easier to understand') and when to use it ('Use when the user mentions confusing text, unclear labels, bad error messages, hard-to-follow instructions, or wanting better UX writing') with concrete trigger phrases. This directly matches the anchor for clearly and explicitly answering both what AND when.

5 / 5

Trigger Term Quality

The 'Use when' clause lists natural phrases users would actually say: 'confusing text', 'unclear labels', 'bad error messages', 'hard-to-follow instructions', 'wanting better UX writing' — good keyword coverage. It misses common synonyms like 'wording', 'rewrite this text', or 'make this clearer', so it fits the anchor for good-but-not-comprehensive coverage rather than the 5 anchor.

4 / 5

Distinctiveness Conflict Risk

The UX-copy/microcopy niche is mostly distinct, with triggers like 'microcopy', 'error messages', and 'labels' pointing clearly at interface text. Broad phrases like 'confusing text' and 'hard-to-follow instructions' could overlap with general writing or documentation skills, so it fits the 'mostly distinct; minor overlap risk with closely related skills' anchor rather than the minimal-conflict anchor.

4 / 5

Total

17

/

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

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

fengshao1227/ccg-workflow

Path

templates/skills/impeccable/clarify/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.