Content
70%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.
The body delivers a clearly sequenced, well-validated 7-phase workflow with concrete gbrain commands and gating rules for risky operations — workflow clarity is excellent. Its main costs are duplication (the Phase 7 report block appears twice; Hard Rules restate Anti-Patterns), non-operational padding (epigraph, changelog), and a monolithic structure with references to external files that are not part of the bundle.
Suggestions
Deduplicate the Phase 7 report template: keep it once in 'Output Format' (or once in Phase 7) and reference the other section instead of repeating the full markdown block verbatim.
Move the changelog, the auto-fire-gate detail (exemptions, first-fire notice, storage policy), and the anti-patterns/hard-rules merge into a reference file (e.g. references/auto-fire-gate.md), leaving SKILL.md a concise overview with well-signaled one-level-deep links.
Tighten abstract steps with the concrete command forms already used elsewhere — e.g. give the actual gbrain command for 'append Timeline entry' (add_timeline_entry / add_timeline_entry tooling) and replace pseudo-paths like 'reference/.../page.md' with a real schema-pack-derived example.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The Phase 7 report template is duplicated almost verbatim between 'Phase 7: REPORT' and 'Output Format', and 'Hard Rules' restates the 'Anti-Patterns' section ('Auto-applying low-confidence schema suggestions' vs 'Schema changes require confirmation'); the changelog and the Radiohead epigraph add no operational value. Not 2 because the bulk of the body is operational instruction, not explanation of concepts Claude already knows. | 3 / 5 |
Actionability | Concrete copy-paste commands throughout: 'gbrain schema show --json', 'gbrain capture --file <analysis.md> --slug <taxonomist-path>', 'gbrain check-resolvable', 'gbrain doctor --json', plus manifest and report templates. Not 5 because several steps remain abstract ('update State, append Timeline entry citing this research') and the filing-plan table uses pseudo-paths like 'reference/.../page.md'. | 4 / 5 |
Workflow Clarity | Seven explicitly sequenced phases with explicit validation checkpoints: Phase 4c 'Verify every link resolves', the Phase 6 confirmation checklist, and the Phase 3 confidence floor ('when gbrain schema suggest returns confidence < 0.6... DO NOT auto-apply') that gates destructive schema writes. Matches the clear-sequence-with-validation-and-checklists anchor exactly. | 5 / 5 |
Progressive Disclosure | A monolithic ~530-line body: the full auto-fire gate section, the changelog, and the anti-patterns are inline material that would fit separate reference files, and cross-references like '../conventions/brain-first.md', 'skills/brain-taxonomist/SKILL.md', and '_brain-filing-rules.md' point to files not present in the bundle (no references/, scripts/, or assets/ directories exist). Not 4 because no bundle structure exists to absorb the overflow and the referenced paths are unverifiable at read time. | 3 / 5 |
Total | 15 / 20 Passed |