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.
An exemplary instruction-only skill: executable commands with full flags, explicitly sequenced phases with validation checkpoints and failure-recovery branches, and textbook progressive disclosure verified against the actual bundle structure. The only notable weakness is mild editorial padding and a few over-long sentences in the Framing/Overview sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's intelligence throughout — no concept explanations, no library tutorials — with copy-paste commands kept terse. Minor over-explanation remains (e.g. "The best sessions end with the user surprised by what came out" and several long compound sentences in Framing) that could be trimmed. Not 3 because padding is isolated, not structural. | 4 / 5 |
Actionability | Fully executable guidance: exact invocations with all flags (`uv run {project-root}/_bmad/scripts/memlog.py init --workspace ... --field topic=...`), exact asset paths, literal message text to deliver, and concrete fallback branches for every failure mode (script not found, no active_initiative, page not opening). Placeholders are resolved by the activation commands themselves. | 5 / 5 |
Workflow Clarity | Phases are explicitly sequenced (On Activation 1-5, Run a Session, Choosing Techniques, Converging, Resuming, Wrap-Up) with an explicit checkpoint ("confirm every entry ran before continuing") and error-recovery loops (script missing → offer setup → re-run; "never claim it opened"). Memlog writes are specified as atomic, and no destructive/batch operation lacks validation. | 5 / 5 |
Progressive Disclosure | The SKILL.md is a true overview: each phase's detail is deferred to a real, one-level-deep reference (mode-*.md, headless.md, in-chat-techniques.md, converge.md, resume.md, finalize.md — all verified present in the bundle), loaded conditionally per phase, with explicit instructions to keep the catalog out of context ("Never pull the library whole into context"). The technique bulk lives in assets/ generated via scripts/brain.py. | 5 / 5 |
Total | 19 / 20 Passed |