Content
81%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 a well-structured, actionable orchestration guide with a strong sequenced activation workflow and validation checkpoints, supported by genuine one-level-deep reference files. The main weaknesses are a somewhat lengthy coaching section and template placeholders that prevent literal copy-paste execution.
Suggestions
Tighten the 'Keep It Feeling Like a Party' bullets to their operative directives to trim tokens while preserving the creative bar.
Resolve or document the {project-root}/{skill-root}/{workflow.*} placeholders with a one-line note on how they expand, so commands read as more directly executable.
Consider inlining the single sentence mode-auto borrows from mode-subagent to eliminate the inter-reference hop and keep references strictly one level deep.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's competence with no library or concept padding, but the 'Keep It Feeling Like a Party' coaching section runs long with philosophical directives that could be trimmed without losing the bar, so it sits just below the leanest anchor. | 4 / 5 |
Actionability | Concrete, runnable commands with flags are given throughout ('uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow'), but template placeholders and reliance on non-bundled _bmad/scripts keep it just short of copy-paste-ready. | 4 / 5 |
Workflow Clarity | 'On Activation' is a clearly sequenced 7-step workflow with explicit validation and feedback branches ('On failure, read customize.toml directly', 'if installed_agents_resolved is false... tell the user, carry on', 'confirm every entry ran'), matching the top anchor's checkpoints and error-recovery loops. | 5 / 5 |
Progressive Disclosure | SKILL.md is a clear overview pointing to real, well-signaled one-level-deep references (all referenced files exist and are loaded at the point of need), but minor cross-references between mode files (mode-auto.md -> mode-subagent.md) introduce light nesting, keeping it just below the cleanest anchor. | 4 / 5 |
Total | 17 / 20 Passed |