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.
An exceptionally lean, high-density process skill: explicit commands, naming conventions, validation checkpoints, and a full independent-review feedback loop with no wasted tokens. The only structural weakness is that it points at files outside its own bundle, which cannot be verified from the skill as shipped.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and instruction-dense with zero padding and no explanation of concepts Claude already knows — e.g., "Get dates and weekdays from `date` or `cal`, not from memory" and "Quote exactly where the wording carries weight: a commitment, a customer's own words". Every token earns its place (anchor 5); it is not a 4 because there are no trimmable over-explanations, and density never becomes verbosity. | 5 / 5 |
Actionability | Guidance is fully executable: copy-paste commands (`uv run {project-root}/_bmad/scripts/resolve_config.py --project-root {project-root} --key core.output_folder`, `npx skills add bmad-code-org/BMAD-METHOD --skill bmad`), concrete naming schemes (`YYYY-MM-DD-<slug>` with `-2`, `-3` collision handling), enumerated citation forms ("a timestamp, a section, a message's date and speaker, or a short quote"), and a four-step fallback chain for choosing the note's folder. Per the rubric's code_vs_instruction note, absence of code in an instruction-only skill is not penalized; there are no material gaps, so it is not a 4. | 5 / 5 |
Workflow Clarity | A clear sequence (activation → keep the raw → choose the template → write the note → review → finish) with explicit validation ("check that `source` and every relative link in the note resolve from the note's folder"), an independent-reviewer feedback loop with re-verification ("Check each finding against the raw before acting on it"), and error-recovery paths for missing scripts. This matches anchor 5's validation + feedback loops + checklist; it is not 4 because checkpoints are explicit rather than implicit, and the operation is neither destructive nor batch, so no cap applies. | 5 / 5 |
Progressive Disclosure | Sections are well organized and detail is appropriately delegated at runtime (templates chosen by id, extensions loaded after, output folder resolved by priority list). However, the body references files outside the shipped bundle — `{skill-root}/customize.toml` and `{project-root}/_bmad/scripts/...` — and no references/, scripts/ or assets/ exist to verify them, and the ~68-line body exceeds the under-50-line simple-skill case. This fits anchor 4 ('good structure... minor organization gaps'); it is not 5 because referenced navigation targets are not present in the bundle, and well above 3 since nothing inlined clearly belongs in a separate file. | 4 / 5 |
Total | 19 / 20 Passed |