Content
78%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.
A tight, well-structured instruction-only skill: concrete tool names, an explicit escalation ladder with stop conditions, and clear trigger/skip policy. Remaining gaps are minor — a trimmable motivational opening, CLI syntax relegated to a comment, and a mild reflex-vs-judgment framing tension.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and policy-dense with no explanation of concepts Claude already knows; the opening address-book analogy ("A person doesn't bulk-load their whole address book into working memory…") is rhetorical framing that could be trimmed to one line. Not level 5 because those few motivational lines don't strictly earn their place; not level 3 because the padding is minor and everything else is tight. | 4 / 5 |
Actionability | Concrete, executable guidance throughout: `get_page <slug>` (MCP), pulling `graph` / `backlinks`, and a 3-level escalation ladder with explicit stop conditions ("stop there", "only when relationship context is needed"). Not level 5 because the exact CLI command forms (`gbrain graph`, `gbrain backlinks`) live only in a frontmatter comment rather than the body, leaving a minor gap for non-MCP use. | 4 / 5 |
Workflow Clarity | The WHEN-to-retrieve conditions, skip rules, and the numbered escalate-and-stop ladder form a clear, unambiguous sequence with built-in checkpoints ("stop there", "no bulk-loading"). Not level 5 because the framing "Encode that reflex" sits in unresolved tension with "Judgment first — retrieve when it changes the quality of the reply, not reflexively", leaving slight ambiguity about whether to act reflexively or deliberatively; not level 3 because the sequence and stop conditions are explicit, and the skill is read-only so no validation loop is required. | 4 / 5 |
Progressive Disclosure | No bundle files exist and the skill is under 50 lines with well-organized sections (Trigger policy, Retrieval spec, failure rationale, See also). Per the rubric's simple-skill guidance, well-organized sections with no need for external references score 5; the "See also" pointers to sibling skills are one level deep and clearly signaled. | 5 / 5 |
Total | 17 / 20 Passed |