Content
77%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 excellent actionability and a well-validated workflow — concrete commands, worked graph examples, and a thorough failure-handling section with recovery loops. It is held back by redundant repetition of citation/hallucination rules, protocol-level detail inlined in SKILL.md, and the absence of a reference bundle to split that detail into.
Suggestions
Consolidate the citation, no-hallucination, and source-precedence rules — currently repeated across Contract, Phases, Output Format, Quality Rules, and Citation in Answers — into one authoritative section.
Move the Token-Budget Awareness internals (cost formulas, fractional-budget compatibility, adoption verification) into a reference file such as references/budget-policy.md, keeping only the recall example and the choose-recall-vs-search guidance inline.
Add a clearly signaled references section listing brain-first.md, MEMORY_VERBS_v1.md, and agent-operator-protocol.md with one-line descriptions instead of burying the links mid-prose.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly dense and useful, but citation rules are repeated across four sections (Contract, Output Format, Quality Rules, Citation in Answers), 'never hallucinate' appears four times, source precedence is stated three times, and the Token-Budget Awareness section carries protocol-spec internals (ceil cost estimates, fractional-budget compatibility, adoption-verification caveats) plus version/date-sensitive details ('gbrain ≥ 0.43', 'v0.10.1+', '2026-09-01') outside any deprecated section. Not 4: the redundancy and padding are more than minor; not 2: the phases, failure handling, and graph sections are tight and earn their tokens. | 3 / 5 |
Actionability | Fully executable, copy-paste-ready commands cover the common cases: 'gbrain query "<q>" --since 2026-09-01 --until 2026-09-30', four worked graph-query examples ('gbrain graph-query companies/acme --type works_at --direction in'), and a recall example given in both bash and MCP JSON forms. This matches the anchor for specific examples covering common cases. | 5 / 5 |
Workflow Clarity | The five-phase sequence (decompose → execute → read → synthesize → flag gaps) is explicit, phase 5 integrates notice-checking before claiming gaps, and 'When it fails' provides concrete feedback loops (degraded → try exact names/synonyms and surface the fix; page_not_found → search by title and check --source; listing_truncated → narrow before claiming absence). Clear sequence with explicit validation and error-recovery loops. | 5 / 5 |
Progressive Disclosure | Good section headers, but there is no bundle: external references (skills/conventions/brain-first.md, docs/protocol/MEMORY_VERBS_v1.md, ../conventions/agent-operator-protocol.md) are buried mid-sentence in prose rather than clearly signaled, and roughly 45 lines of budget-packing protocol detail belong in a separate reference file. This matches 'some structure but content that should be separate is inline'; not 4 because the navigation to deeper material is not clearly organized. | 3 / 5 |
Total | 16 / 20 Passed |