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 is exceptionally actionable with copy-paste-ready gbrain commands and a strong failure-handling loop, but it pays for that with noticeable redundancy and inlined protocol detail that inflate token cost. Consolidating the duplicated rule sections and moving token-budget protocol minutiae into a referenced file would materially improve efficiency.
Suggestions
Merge the overlapping Contract / Anti-Patterns / Output Format / Quality Rules / Citation in Answers sections into one 'Rules & output format' section — citation, source-precedence, and no-hallucination rules are each stated 3-4 times.
Move the Token-Budget Awareness protocol minutiae (cost formulas, fractional-budget compatibility, adoption verification) into the referenced protocol doc (docs/protocol/MEMORY_VERBS_v1.md) and keep only the decision guidance and one example inline.
Collect scattered version-sensitive details ("gbrain ≥ 0.43", "v0.10.1+", "pre-0.43 servers") into a single compatibility note so they don't read as time-sensitive instructions.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Noticeably verbose: citation rules appear in four sections (Contract, Output Format, Quality Rules, Citation in Answers), source precedence in three, and "never hallucinate" in four; the ~55-line Token-Budget Awareness section inlines protocol minutiae (cost formulas, fractional-budget compatibility, adoption verification) that belongs in the referenced protocol doc. Not 3 because the duplication and inlined protocol detail go beyond 'some unnecessary explanation'; not 1 because most content is genuinely non-obvious operational guidance rather than concepts Claude already knows. | 2 / 5 |
Actionability | Fully executable, copy-paste-ready commands with realistic arguments cover the common cases: `gbrain query "<q>" --since 2026-09-01 --until 2026-09-30`, `gbrain graph-query companies/acme --type works_at --direction in`, `gbrain recall --query 'zebra telescope' --budget-tokens 75 --budget-policy query_first --json`, and `--return-unit page --token-budget 6000`, plus a complete MCP JSON request example. | 5 / 5 |
Workflow Clarity | Five clearly sequenced phases with explicit validation and error-recovery feedback loops: step 5 mandates reading notices before answering, and 'When it fails' prescribes concrete retries (try display name/synonyms/hybrid before declaring a gap; page or narrow before claiming absence; search by title before reporting a page missing). Matches the anchor for clear sequence with explicit validation steps and feedback loops. | 5 / 5 |
Progressive Disclosure | Section headers are clear, but the skill ships no bundle files while referencing external docs (docs/protocol/MEMORY_VERBS_v1.md, ../conventions/agent-operator-protocol.md, skills/conventions/brain-first.md) and inlining the token-budget protocol detail inline instead of splitting it out. Not 4 because inlining ~55 lines of protocol-level content is more than a minor organization gap; not 2 because the 13-section structure is real and references are clearly signaled. | 3 / 5 |
Total | 15 / 20 Passed |