Content
92%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 excellent, tightly written body: concrete tool invocations with examples, a clear conditional workflow, and valuable anti-pattern/staleness guidance with zero concept over-explanation. The only improvement opportunity is consolidating the thrice-repeated 'read the real source' guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence — no padding or explanation of known concepts, and sections like 'Anti-patterns' carry real operational value. It falls short of 5 only because the 'read the real source, not the graph alone' guidance is repeated in the intro, workflow step 3, and the 'When NOT to use' section and could be trimmed to one place. | 4 / 5 |
Actionability | Fully concrete, executable guidance: exact tool signatures with example arguments ('hivemind_graph_search({ pattern: "<symbol>" })', 'hivemind_graph_neighborhood({ file: "src/hooks/capture.ts" })'), the multi-token 'auth+handler' syntax, and the precise config key 'plugins.entries.hivemind.config.tuning.HIVEMIND_GRAPH_CWD'. Specific examples cover the common cases, matching the top anchor. | 5 / 5 |
Workflow Clarity | The three-step workflow is a clear conditional decision tree ('Broad structural question?', 'Know the file?', 'Need the actual code?') with retry guidance ('try multiple keywords if the first misses') acting as a feedback loop. The skill is read-only querying, so no destructive/batch validation cap applies, and staleness caveats are explicitly flagged. | 5 / 5 |
Progressive Disclosure | The skill is a short (~55 line), single-purpose overview with no external references needed and no bundle files, and content is organized into well-signaled sections (When to use, Tools, Workflow, When NOT to use, Anti-patterns). This satisfies the simple-skill exception: well-organized sections alone merit the top score. | 5 / 5 |
Total | 19 / 20 Passed |