Content
88%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.
Excellent operational content: an explicitly ordered 8-step pipeline with per-step decision questions, copy-paste-ready gbrain/grep commands for every error class, validation and feedback loops for a mutating workflow, and disciplined delegation to sibling skills. The only weaknesses are mild redundancy between the classification table, fix steps, and contract section, and reference tables inlined in a long body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and mostly efficient — the gbrain commands and error codes are custom-tool knowledge Claude doesn't have, so their inclusion is earned. Minor trims exist: the Step 5 "Fix surface" column restates Step 6, and the "Contract" section reiterates guarantees already covered by steps and anti-patterns, matching anchor 4's 'minor instances of over-explanation that could be trimmed'. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready commands with appropriate placeholders throughout: `gbrain search "<relevant terms>" --limit 10`, `gbrain forget <fact-id>`, `gbrain bootstrap interview --set KEY "corrected value"`, `grep -ri "<wrong claim terms>" "$BRAIN_DIR/people/"`, plus a concrete Step 8 report template and specific error-code recovery steps — matching anchor 5. | 5 / 5 |
Workflow Clarity | "Run these steps IN ORDER. Report findings to the user" gives explicit sequencing, each step carries a decision question ("Is the wrong fact IN the brain?"), and despite being mutating/destructive, validation and feedback loops are present: bootstrap read-back with confirm hash, re-running `recall` instead of guessing fact ids, re-sync after repo edits, a Step 7 propagation check, and a "When it fails" section with per-error recovery — anchor 5. | 5 / 5 |
Progressive Disclosure | Sections are well-organized and delegation is clearly signaled one level deep ("The full interview discipline... lives in skills/soul-audit/SKILL.md — route through it"; brain-first and agent-operator conventions linked with what they cover). No bundle files exist to verify, and the ~260-line body inlines tables (Severity Tiers, Recurring Error Patterns) that could sit in a reference file — anchor 4 rather than 5's fully split structure. | 4 / 5 |
Total | 18 / 20 Passed |