Content
85%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.
A dense, well-sequenced orchestration skill: lean prose, concrete commands, and an activation workflow with genuine error-recovery loops. The main weakness is bundle navigation — the template assets are not explicitly linked, and two referenced files (customize.toml, bmod.toml) plus the brd template have no counterpart in the shipped bundle.
Suggestions
Explicitly link the template assets from the body (e.g. 'templates live in {skill-root}/assets/template-<id>.md') or name the assets folder in Conventions, so the 13 bundle files are discoverable without resolving {workflow.template_libraries} first.
Resolve the dangling file references: either ship customize.toml and bmod.toml in the bundle or note where they come from, since both are named as fallback resolution sources in the activation steps.
Clarify the brd template situation — the body routes 'write the BRD' to a brd template but no template-brd.md exists in assets/, so state whether it maps to another template or is resolved elsewhere.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~45-line body is compressed with zero padding and no explanation of concepts Claude already knows — e.g. 'Stay John until dismissed; the persona carries into every skill you invoke' — every token carries operational content, matching the lean anchor 5 rather than anchor 4 (there are no over-explanation instances left to trim). | 5 / 5 |
Actionability | Concrete executable commands are given verbatim (resolve_customization.py, resolve_config.py, tickets.py with full argument lists, 'npx skills add bmad-code-org/BMAD-METHOD --skill bmad', the '<epic folder>/<template id>-<slug>/' output pattern) with placeholders defined in Conventions. It falls short of anchor 5 because the core create/update/validate execution is delegated to the bmad-facilitate skill, so this file's guidance is not fully copy-paste self-contained. | 4 / 5 |
Workflow Clarity | The 8-step activation is a clear sequence with explicit error-recovery branches — 'Script not found: offer the bmad skill's setup, installing bmad first if needed… then run it again. Any other failure: use customize.toml as shipped and say the overrides were not applied' — plus fallbacks for a missing active_initiative and uninstalled skills, matching the anchor-5 feedback-loop pattern rather than anchor 4's 'minor validation gaps'. | 5 / 5 |
Progressive Disclosure | Sections are well-organized and templates are correctly kept out of the body, but the 13 assets/template-*.md files are never directly linked (navigation runs indirectly through {workflow.template_libraries}), the body references {skill-root}/customize.toml and {skill-root}/bmod.toml which are absent from the bundle, and 'brd' names a template with no matching asset file — 'references present but not clearly signaled' matches anchor 3 rather than anchor 4's minor organization gaps. | 3 / 5 |
Total | 17 / 20 Passed |