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.
A well-sequenced, highly actionable body: the procedure has an explicit validation gate with exit-code-driven feedback loops, and all commands are copy-paste ready. The main weakness is conciseness — the report-only and rendered-file rules are each restated across four-plus sections, ironically the same redundancy pattern the skill audits — and progressive disclosure could be improved by moving the output template and dedup details into reference files.
Suggestions
State the report-only and rendered-file rules once in the Contract and have other sections link to it ("see Contract") instead of restating them in Procedure, Anti-Patterns, and Dedup — this targets the lowest dimension, conciseness.
Move the full report template (Output Format) and the Dedup section into a reference file (e.g. references/output-format.md) with a one-line pointer, reducing the always-inlined body and improving progressive disclosure.
Trim the motivational 'What this is' paragraph to one sentence; the per-turn cost framing is evident to Claude from the procedure itself.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient — no concept explanations Claude wouldn't know, and sections like Scope and Output Format earn their tokens — but the same rules are restated multiple times: report-only appears in the Contract ("No audited file is edited, no page is written, nothing is auto-fixed"), Procedure step 5, Anti-Patterns ("Report-only — even 🟢 zero-risk deletions are recommendations"), and Dedup; the rendered-file rule likewise repeats across Contract, Procedure step 4, Anti-Patterns, and Dedup, plus the motivational "per-turn tax" paragraph. This matches the level-3 anchor (mostly efficient but could be tightened): it is above level 2 because there is no padding or explained background material, and below level 4 because the cross-section repetition of two core rules is more than a minor trim. | 3 / 5 |
Actionability | Guidance is fully executable: a copy-paste enumeration loop with the exact token arithmetic ("bytes/2.8 ... (n*10+27)/28"), a complete `gbrain eval cross-modal` invocation with every flag resolved (JUDGE=$(gbrain config get models.tier.utility) with a fallback note via `gbrain models`), enumerated exit codes with per-code responses, and a concrete report template. This matches the level-5 anchor (copy-paste ready commands covering the common cases); level 4 is excluded because there is no missing key detail — even the judge-model resolution and the error paths are specified. | 5 / 5 |
Workflow Clarity | The five-step Procedure is clearly sequenced (enumerate → analyze → classify → judge → deliver) with an explicit validation gate: step 4 defines exit codes "0 PASS — deliver. 1 FAIL — fix the flagged weaknesses in the draft ... and re-judge. 2 INCONCLUSIVE ... deliver the report but label it 'unjudged'", which is a full validate-fix-retry feedback loop, and the 'When it fails' section adds error-recovery guidance for provider/key failures. This matches the level-5 anchor (explicit validation steps, feedback loops for error recovery); level 4 is excluded because no checkpoint is implicit — even the INCONCLUSIVE path has a defined action. | 5 / 5 |
Progressive Disclosure | Good structure with clear sections and well-signaled, one-level-deep references to sibling material ("[conventions/brain-first.md](../conventions/brain-first.md)", "[skills/soul-audit/SKILL.md](../soul-audit/SKILL.md)", the cron-scheduler and brain-ops skills), each with its purpose stated. It sits at level 4 rather than 5 because everything lives inline in a single ~220-line SKILL.md with no bundle split — the Output Format template, the multi-model opt-in detail, and the Dedup section are all candidates for reference files — so a reader consumes the whole body to reach any part; it is above level 3 because the references that do exist are clearly signaled and the body is easy to navigate via headers. | 4 / 5 |
Total | 17 / 20 Passed |