Content
47%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 carries no actionable content — a single vacuous step that tells Claude nothing about what to actually do. It scores well only on token efficiency and adequate structure; actionability and workflow clarity are at the bottom of the scale.
Suggestions
Replace "Do the first thing." with concrete, executable guidance — specific commands, code, or a precisely defined instruction.
If the task has multiple steps, list the full sequence with explicit validation checkpoints where things can fail.
Keep the current brevity while ensuring each line conveys real, specific instructions rather than placeholders.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a single heading ("# Skill A") plus one step ("1. Do the first thing.") — nothing padded, no concepts explained, no wasted tokens. Every token present is as lean as the anchor-5 standard; the thinness is an actionability problem, not a verbosity one. | 5 / 5 |
Actionability | "Do the first thing." is entirely vague and abstract — no code, no commands, no specifics about what 'the first thing' is. It matches anchor 1 ("only describes rather than instructs" with nothing concrete to execute). | 1 / 5 |
Workflow Clarity | A numbered step exists, so a rudimentary sequence is present (keeping it above anchor 1's "steps missing"), but the single step is vacuous and poorly defined, matching anchor 2's "steps poorly defined". The simple-skill exception for a 5 does not apply because the action is ambiguous, and no validation is required since nothing risky is described. | 2 / 5 |
Progressive Disclosure | The skill is under 50 lines with no bundle files (no references/, scripts/, or assets/ exist) and no external references are needed, so nothing is inlined that belongs elsewhere. Structure (heading + step) is appropriate for its scale, but the near-empty body keeps it below the anchor-5 bar of genuinely well-organized sections. | 4 / 5 |
Total | 12 / 20 Passed |