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 is a highly actionable, well-sequenced operator manual with concrete commands, explicit validation, and thorough error-recovery loops. Its weaknesses are the oversized opening blockquote that inlines what belongs in reference files, some duplicated caveats, and unverifiable external references given no bundle files ship with the skill.
Suggestions
Move the opening blockquote's topics (memory verbs contract, budget packing, visibility/redaction rules, keyless-brain extraction) into reference files under references/ and keep one-line pointers in SKILL.md, which would fix both the progressive-disclosure and conciseness penalties.
De-duplicate the repeated remote-visibility caveat ("Every MCP caller, including stdio, and a thin CLI connected to MCP...") into a single stated rule.
Condense the shallow-ls anecdote (the 132-file example) to its one-line takeaway: always scope with `gbrain sources list` or `find <dir> -name '*.md' | wc -l`, never `ls *.md`.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with gbrain-specific operational facts and avoids explaining concepts Claude already knows, but the ~60-line opening blockquote, a duplicated visibility sentence ("Every MCP caller, including stdio, and a thin CLI connected to MCP..." appears twice), and an anecdotal "Real example" of the shallow ls undercount could all be tightened. This fits score 3 (mostly efficient but could be tightened) rather than 4, which requires only minor trimming. | 3 / 5 |
Actionability | Guidance is fully executable throughout: copy-paste-ready commands with flags ("gbrain recall --query 'zebra telescope' --budget-tokens 75 --budget-policy query_first --json", "find <dir> -name '*.md' | wc -l", "gbrain sweep --once"), exact error codes, and concrete recovery steps. This matches the score-5 anchor of copy-paste-ready commands covering common cases. | 5 / 5 |
Workflow Clarity | Phases 1–4 are clearly sequenced with numbered steps, validation is explicit ("Confirm authorized writes only after readback"), and error-recovery feedback loops are specified (revision_conflict: re-read, merge, save with new revision; write_pending: poll before claiming the write landed). This matches the score-5 anchor of explicit validation steps with feedback loops. | 5 / 5 |
Progressive Disclosure | References are one level deep and clearly signaled ("See skills/conventions/quality.md for format", "Docs: docs/guides/write-refusals.md"), but none exist in this skill's bundle, and the opening mega-blockquote inlines memory verbs, budget packing, visibility rules, redaction handling, and keyless-brain extraction — content that clearly belongs in separate reference files. This matches score 3 (content that should be separate is inline) rather than 4, where inlining would be only a minor gap. | 3 / 5 |
Total | 16 / 20 Passed |