Content
92%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 exemplary lean dispatcher: an exact command, precise substitution and flag rules, and explicit handling for every failure mode (HALT, missing script, uv unavailable, unexpected output). The only weakness is that the two bundled reference files are completely unsignaled from SKILL.md, leaving no navigation path to them.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | "Run the following command exactly once without changing the current working directory" plus two one-line substitution rules and five compact bullets — lean and efficient with zero padding and no explanations of concepts Claude already knows, matching anchor 5. Not 4 because there is nothing to trim: every instruction carries operational weight. | 5 / 5 |
Actionability | A fully executable command with precise placeholder rules ("Replace `{project-root}` with the nearest folder containing `_bmad/`, from the working directory upward"), exact flag syntax (`--set workflow.route=<value>`) with enumerated valid values (`oneshot`, `full`, `none`/`quick`/`thorough` including the "skip review"/"no review" synonym mapping), and concrete handling for every branch — matching anchor 5 (copy-paste ready, common cases covered). | 5 / 5 |
Workflow Clarity | The single action (substitute placeholders, run the render command, follow the printed workflow) is unambiguous, and every anticipated outcome has an explicit checkpoint: `HALT: <reason>` → "report the reason and stop"; missing script → offer BMad setup then re-run; "On any other output or failure, including `uv` being unavailable, report the command output and stop." This matches anchor 5's explicit error-recovery branches, and the simple-skill exception applies (the skill is a single-purpose dispatcher, not itself a destructive or batch operation). | 5 / 5 |
Progressive Disclosure | The bundle provides references/claims-check.md and references/deletion-check.md, but the body never mentions or signals either file — matching anchor 3 ("references present but not clearly signaled"). Not 4 because navigation to the existing bundle files is entirely absent; not lower because the body itself is well organized with no content inlined that belongs in a separate file, and the run-on-demand render design is itself a disclosure mechanism. | 3 / 5 |
Total | 18 / 20 Passed |