Content
63%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 well-sequenced, actionable instruction skill with concrete tool signatures and clear validation checkpoints, undermined by verbosity in the handoff and memory-reflex sections and a broken mandatory reference (gotchas.md is required but not shipped in the bundle). Tightening the inlined detail and providing the missing file would lift the weakest dimensions.
Suggestions
Ship the missing gotchas.md (referenced as a mandatory bootstrap load) or remove the 'load gotchas.md' requirement and inline only the essential gotchas.
Move the dense [W] handoff state matrix and the Memory Reflex gating rules into a reference file (e.g. references/handoff.md) and keep SKILL.md as a concise overview, fixing both conciseness and progressive_disclosure.
Add a one-line retry/escalation note to the step 6 self-review (e.g. 'if a contradiction spans multiple sections, re-run step 4 for the affected sections') so the validation step has a real feedback loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient (compact anti-triggers table, numbered steps, exact tool signatures), but several sections are padded — notably the [W] handoff bullet ('Two doc states carry cleanly... The third state does not... On a bare [W] with an untracked doc, also revert the step-5 README row...') and the Memory Reflex gating, which is re-explained in Bootstrap and again in steps 2 and 6. Matches the score-3 anchor (mostly efficient, some unnecessary explanation that could be tightened); not 4 because the padding is noticeable rather than minor. | 3 / 5 |
Actionability | Concrete, executable guidance throughout: exact file path docs/backlog/<slug>.md, exact MCP call signatures (mcp__basic-memory__search_notes({ query:..., page_size:5 }), mcp__basic-memory__write_note({...})), commit message format docs(backlog): add <slug>, and specific handoff dispatch commands. Per scoring_notes, absence of code in this instruction-only skill is not penalized. Matches the score-4 anchor; not 5 because some conditional guidance (the [W] state matrix) leaves execution ambiguous rather than copy-paste ready. | 4 / 5 |
Workflow Clarity | Six clearly sequenced steps with explicit checkpoints: step 3 blocker checkpoint ('Ask the user only when one of these blockers holds'), step 6 fresh-eyes self-review pass, and [ ] checklists for memory beats. Matches the score-4 anchor (clear sequence, most checkpoints present, minor validation gaps); not 5 because the self-review is explicitly single-pass ('No re-review loop — fix and move on'), so the error-recovery feedback loop is incomplete. | 4 / 5 |
Progressive Disclosure | Structure is mostly one-level-deep (SKILL.md overview → references/template.md, gotchas.md), but gotchas.md is referenced as a MANDATORY bootstrap load ('Before walking, load: ... gotchas.md') and again under 'Gotchas → See gotchas.md' yet is absent from the bundle (only references/template.md exists). Additionally, substantial operational detail (the Memory Reflex gating rules and the [W] handoff state matrix) is inlined in SKILL.md rather than moved to a reference. Matches the score-3 anchor (some structure, references present but one is broken/missing, content that could be separate is inline); not 4 because a missing mandatory reference is more than a minor organization gap. | 3 / 5 |
Total | 14 / 20 Passed |