Content
33%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 an unfilled template: one heading and one placeholder sentence. Its only virtue is that it wastes almost no tokens and has no structural problems; it contains no instructions, commands, examples, or workflow an agent could act on. Every substantive dimension (actionability, workflow clarity) is at the floor.
Suggestions
Replace "Put the instructions the agent needs here" with the actual instructions — concrete, executable commands or code covering the skill's common cases.
If the skill involves a multi-step process, lay it out as an explicit numbered sequence with validation checkpoints, especially for batch or destructive operations (which would otherwise cap workflow clarity at 3).
Fill in the heading and overview so the body states what the skill does and when to apply it; if detailed material exists, move it into references/ files and link them one level deep from SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 3-line body ("# My skill" / "What the skill does. Put the instructions the agent needs here.") has no verbosity, padding, or explanations of concepts Claude already knows. It is not a 5 because anchor 5 requires "every token earns its place" — the two placeholder sentences are authoring instructions that deliver nothing to the agent, i.e., a minor instance of content that could be trimmed; it is not a 3 because there is no unnecessary explanation, only placeholder text. | 4 / 5 |
Actionability | "What the skill does. Put the instructions the agent needs here." provides no concrete code, commands, or steps — it is placeholder that only gestures at where instructions would go. This matches anchor 1 ("Entirely vague or abstract; no concrete code or commands; only describes rather than instructs"); even anchor 2's high-level hints about what to do are absent. | 1 / 5 |
Workflow Clarity | No steps or sequence of any kind exist in the body — there is no workflow to evaluate. The simple-skill exception (a single unambiguous action can score 5) does not apply because no action is described at all, so anchor 1 ("Steps missing or incoherent; no sequence") is the best fit. | 1 / 5 |
Progressive Disclosure | The body is 3 lines with no bundle files (references/, scripts/, assets/ are absent) and no file references, so it has zero structural defects — nothing inlined that belongs in a separate file, no buried or nested references. It is not 5 because anchor 5 (and the simple-skill exception, which requires the content to be clear and well-organized) presupposes a clear overview, and a placeholder sentence is not one; it is not 3 because the defects in that anchor (unclearly signaled references, inline content that should be separate) are all absent. | 4 / 5 |
Total | 10 / 20 Passed |