Establish clarity before starting work. Use when beginning any significant task, when input is vague or stream-of-consciousness, or when requirements seem unclear. Handles messy voice input efficiently. This is the first system in the 5-system framework.
70
45%
Does it follow best practices?
Impact
85%
1.26xAverage score across 6 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./data/1-clarity/SKILL.mdQuality
Discovery
40%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 fails to specify what concrete actions this skill performs—'establish clarity' is abstract and uninformative. While the 'when' triggers are somewhat useful (vague input, unclear requirements), the lack of specific capabilities makes it hard for Claude to know what this skill actually does versus other skills that might handle ambiguous requests. The reference to a '5-system framework' adds no useful selection information.
Suggestions
Replace 'establish clarity' with specific concrete actions, e.g., 'Parses ambiguous or stream-of-consciousness input into structured requirements, asks targeted clarifying questions, and produces a clear task definition before work begins.'
Add more natural trigger terms users would say, such as 'I'm not sure what I want,' 'rough idea,' 'brainstorm,' 'help me figure out,' 'scope this out,' or 'what should I build.'
Remove or explain the '5-system framework' reference—it provides no value for skill selection and may confuse the matching process.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description uses vague language like 'establish clarity' and 'beginning any significant task' without listing concrete actions. It doesn't specify what the skill actually does—no mention of asking clarifying questions, parsing requirements, creating structured summaries, or any other tangible action. | 1 / 3 |
Completeness | The 'when' is reasonably well-covered with 'Use when beginning any significant task, when input is vague or stream-of-consciousness, or when requirements seem unclear.' However, the 'what' is extremely weak—'establish clarity' is not a concrete description of what the skill does. The reference to '5-system framework' is unexplained context that doesn't help Claude decide when to use it. | 2 / 3 |
Trigger Term Quality | It includes some relevant trigger terms like 'vague,' 'unclear,' 'voice input,' and 'requirements,' which users might naturally mention. However, it misses common variations like 'ambiguous,' 'what do you mean,' 'clarify,' 'scope,' or 'define requirements.' | 2 / 3 |
Distinctiveness Conflict Risk | The focus on vague/unclear input and voice input gives it some distinctiveness, but 'beginning any significant task' is extremely broad and could conflict with many other skills. The phrase 'establish clarity' is generic enough to overlap with planning, scoping, or requirements-gathering skills. | 2 / 3 |
Total | 7 / 12 Passed |
Implementation
50%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill has a solid conceptual structure with a useful tiered approach (skip/light/full clarity) and a good concrete example for messy input handling. However, it suffers from verbosity in the Full Clarity Protocol section where it lists questions Claude would naturally know to ask, lacks validation checkpoints between steps, and the output template is lengthy inline content that could be referenced externally. The skill would benefit from tightening the full protocol and adding explicit confirmation gates.
Suggestions
Trim the Full Clarity Protocol steps 1-4 to just the non-obvious, project-specific questions rather than generic prompts like 'What exactly are we trying to accomplish?' — Claude already knows how to ask clarifying questions.
Add an explicit validation checkpoint after generating active-context.md, such as 'Present the completed context to the user and confirm before proceeding to the next system.'
Move the active-context.md template to a separate reference file (e.g., TEMPLATES.md) and reference it from the main skill to improve conciseness and progressive disclosure.
Add a concrete example for the Full Clarity Protocol similar to the Messy Input example, showing a complex task going through all four steps with realistic content.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill has some efficient sections (the Messy Input Protocol is well-structured and lean), but the Full Clarity Protocol includes verbose question lists that Claude already knows how to ask. The 'ask and document' bullet lists under Steps 1-4 are somewhat padded with obvious prompts like 'What exactly are we trying to accomplish?' and 'Why does this matter?' | 2 / 3 |
Actionability | The example for messy input is concrete and helpful, and the output template for active-context.md is copy-paste ready. However, the Full Clarity Protocol steps are more like abstract checklists of questions to ask rather than executable guidance—they describe what to do conceptually rather than showing concrete examples of how to do it for complex tasks. | 2 / 3 |
Workflow Clarity | The workflow has a clear sequence (Messy Input → Full Clarity → Output → Transition) and the efficiency rules provide good branching logic. However, there are no validation checkpoints—no step to verify that the active-context.md was properly created, no feedback loop if the user disagrees with the extracted intent during the full protocol, and no explicit 'confirm before proceeding' gate between the clarity steps and transition. | 2 / 3 |
Progressive Disclosure | The content is reasonably well-structured with clear sections and a logical flow from simple (Messy Input) to complex (Full Clarity Protocol). However, with no bundle files, the references to other systems (Identity, Priority, Execution, Reset) and SOURCE_OF_TRUTH.md are dangling. The full clarity protocol's detailed question lists and the output template could be split into separate reference files to keep the main skill leaner. | 2 / 3 |
Total | 8 / 12 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 — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
b1a95aa
Table of Contents
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.