Content
41%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is maximally lean but nearly content-free: it supplies two behavioral constraints while omitting every executable detail of the check itself. The skill's failure mode is the opposite of verbosity — it needs concrete commands, the location of the check, and a definition of 'evidence'.
Suggestions
State how to run the check concretely: the command or script to execute (e.g. a path in scripts/ or an exact invocation) rather than an unadorned directive.
Define what counts as 'evidence' and what 'missing' looks like, so the stop condition is actionable rather than interpretable.
Show the expected shape of the result (e.g. a short example with source paths) so 'keep source paths in the result' has a concrete target.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is two sentences with zero padding and no explanation of concepts Claude already knows; every token present is an instruction. This matches anchor 5 ('Lean and efficient; assumes Claude's competence; every token earns its place'). | 5 / 5 |
Actionability | 'Keep source paths in the result. Stop when evidence is missing.' provides no command, script path, tool, or steps for actually running the check — the entire 'how' is absent, making it entirely abstract direction. Even anchor 2's example names a tool and concrete steps, so this sits at anchor 1. | 1 / 5 |
Workflow Clarity | No sequence of steps is given and the single action is ambiguous: 'evidence' is undefined, where/how the check runs is unstated, so the simple-skill exception (unambiguous single action) does not apply. This matches anchor 1 ('Steps missing or incoherent; no sequence'). | 1 / 5 |
Progressive Disclosure | The body is under 50 lines with no bundle files and nothing that belongs in a separate file is inlined, so nothing is mis-placed. However, structure is a bare heading with no section organization, which falls short of anchor 5's 'well-organized sections' for a simple skill. | 4 / 5 |
Total | 11 / 20 Passed |