Content
96%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.
An exemplary thin-dispatcher skill: fully executable command with precise substitution rules, explicit HALT and failure gates, and a recovery path, all in a lean body. The only gap is that the bundled reference files are not mentioned or linked in the body, leaving their navigation implicit in the render step.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~15-line body is a lean dispatcher: one command, two substitution rules, flag mappings, and failure handling, with zero explanation of concepts Claude already knows — every clause ("exactly once", "without changing the current working directory") carries a guard, matching the 5 anchor where every token earns its place. | 5 / 5 |
Actionability | The command is fully executable with both placeholders given unambiguous resolution rules ("nearest folder containing `_bmad/`, from the working directory upward"; "absolute path to this skill's directory"), and every branch — route flag, review flag, HALT, missing script, uv unavailable — has exact instructions. Not 4: there are no gaps in the guidance; all common invocation cases are covered. | 5 / 5 |
Workflow Clarity | The sequence is unambiguous with explicit checkpoints: run once → apply invocation-named flags → follow printed workflow, "HALT: <reason>: report the reason and stop" as a hard validation gate, and a recovery loop for the missing-script case (offer setup, "then run the command again") plus a stop on any other failure. This is a simple under-50-line single-purpose skill whose every branch is specified, satisfying the simple-skill exception at full marks. | 5 / 5 |
Progressive Disclosure | The bundle structure is healthy — a thin SKILL.md dispatcher plus two one-level-deep reference files (references/claims-check.md, references/deletion-check.md) with nothing inlined that belongs elsewhere — but the body never signals those reference files; their discovery depends entirely on the external render step, a minor organization gap. Not 5: references are not clearly surfaced in the SKILL.md itself; not 3: nothing that should be separate is inline and the structure is clean. | 4 / 5 |
Total | 19 / 20 Passed |