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.
The body is an exemplary thin dispatcher: a single exact command, concretely defined placeholders, and exhaustive handling of every output outcome including failure modes. The single gap is that the bundle's phase references and scripts are only reachable through the rendered workflow rather than being signaled from the SKILL.md itself.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 12-line body is entirely instruction with zero padding: "Run the following command exactly once without changing the current working directory", two placeholder definitions, one command, and three output-handling bullets. Every token earns its place and no concept Claude already knows is explained, matching the lean-and-efficient anchor rather than the anchor below, which allows minor trimmable over-explanation. | 5 / 5 |
Actionability | The single exact command ("uv run --no-cache \"{project-root}/_bmad/scripts/render_skill.py\" --project-root ... --skill ...") is executable once its two placeholders are filled, and both placeholders are concretely defined ("the nearest folder containing `_bmad/`, from the working directory upward"). The three enumerated output branches cover the common success and failure cases, matching the fully-executable anchor; the anchor below would require gaps in the guidance, and there are none. | 5 / 5 |
Workflow Clarity | The sequence is clear (resolve project root, resolve skill root, run once, interpret output) with an explicit validation checkpoint on the command's stdout: each outcome has a mandated response — "read and follow <rendered workflow.md>", "HALT: <reason>: report the reason and stop", and on any other failure "report the command output and stop. Do not run any workflow source directly". The script-missing branch adds a feedback loop (offer setup, then run again). This matches the anchor requiring explicit validation steps and error-recovery loops; the retrospective workflow itself is read-only, so the destructive-operation cap does not apply. | 5 / 5 |
Progressive Disclosure | The entry point is maximally lean and the multi-phase content is appropriately split into real bundle files — five phase documents under references/ (e.g., evidence-gathering.md, which invokes {skill-root}/scripts/git_evidence.py) and a measurement script under scripts/ — all verified to exist and effectively one level deep behind the rendered workflow. It falls short of the top anchor because the body itself signals none of the bundle paths: navigation is mediated entirely by the externally rendered workflow.md, so references are not directly signaled from the overview. | 4 / 5 |
Total | 19 / 20 Passed |