Content
45%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 substantively empty: it names an undefined 'second thing' with no concrete guidance, executable steps, or validation. Structure is trivially fine for a skill this small, but the content gives Claude nothing to act on.
Suggestions
Replace 'Do the second thing' with the actual concrete task, including specific commands or executable guidance for it.
If the task involves multiple steps or any destructive/batch operation, list the sequence explicitly with validation checkpoints.
For a genuine single-step skill, state the one action unambiguously so workflow clarity qualifies for the simple-skill exception.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is three lines with zero padding, zero explanation of concepts Claude already knows, and no wasted tokens — 'every token earns its place' in the lean-and-efficient anchor. Emptiness is penalized under actionability and workflow clarity, not here, since this dimension measures token efficiency of what is written. | 5 / 5 |
Actionability | "Do the second thing" refers to an action that is never defined anywhere; there is no code, command, or specific guidance — vaguer even than the anchor-1 example 'Use a PDF library to extract the text content'. It only gestures at an instruction without instructing, so score 2's 'high-level hints' is still too generous. | 1 / 5 |
Workflow Clarity | The single step is incoherent because 'the second thing' is undefined, and no validation or checkpoints exist. The simple-skill exception allows a 5 only when the single action is unambiguous; here the one step present fails to communicate any actionable sequence, matching 'steps missing or incoherent'. | 1 / 5 |
Progressive Disclosure | The skill is under 50 lines, no bundle directories (references/, scripts/, assets/) exist, nothing that belongs in a separate file is inlined, and there are no nested references. Per the simple-skill guideline, a body this small with a clear header and organized line meets the structure bar with nothing to disclose progressively. | 5 / 5 |
Total | 12 / 20 Passed |