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.
An exceptionally actionable, well-sequenced gate specification: concrete gbrain commands at every step, an explicit decision tree, dedup-skip carve-outs, verification with a recovery loop, and clear delegation boundaries. Its main weaknesses are repetition (the vector-score rule stated three times, a Contract section that restates the body) and its monolithic length when a couple of sections could be split into reference files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with genuinely non-obvious, gbrain-specific rules (native pipeline dedup limits, fused-score warning, write_pending exit 10), but it repeats itself: the 'vector score is a floor for prose, never a gate for named things' point is made three times (The Rule, the Named-Entity Gate intro, rule 3), and the Contract section fully restates body rules while admitting 'this section exists for the conformance test'. This matches anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') better than anchor 4's 'minor instances'. | 3 / 5 |
Actionability | Fully executable commands are given for every step: 'gbrain entity "<name>"', 'gbrain query "<name>" --limit 3', 'gbrain search "<core claim>" --limit 5', 'gbrain get <slug>', 'gbrain link' / 'gbrain timeline-add', and the verification trio (check-backlinks check, backlinks <new-slug>, re-search). The band table, decision tree, and a filled-in output-format example cover the common cases, matching anchor 5. | 5 / 5 |
Workflow Clarity | The two-gate sequence is explicit and ordered (Named-Entity Resolution Gate 'runs FIRST', Dedup Gate 'runs SECOND'), an ASCII decision tree encodes the full flow, and the batch/destructive-adjacent operation has both a trial-first reference ('gate 3-5 items and inspect the decisions') and a Verification section with a feedback loop ('If check-backlinks check reports gaps... route back through enrich before declaring the ingest done'). This matches anchor 5: clear sequence, explicit validation, error-recovery loop. | 5 / 5 |
Progressive Disclosure | No bundle files exist (no references/, scripts/, or assets/), so all guidance is inline; the body compensates with a clear Owns-vs-Delegates table and clearly signaled one-level-deep links to sibling skills and conventions (../conventions/brain-first.md, ../enrich/SKILL.md, etc.), all of which are path-relative references rather than shipped bundle files. At ~290 lines with a sharp-boundaries comparison section and a self-admitted duplicate Contract section that could live in separate reference files, this sits at anchor 4 ('good structure; most content appropriately placed; minor organization gaps') rather than 5's 'content appropriately split'. | 4 / 5 |
Total | 17 / 20 Passed |