Content
88%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 exemplary operational skill body: fully executable native commands, a hard verification gate with failure-recovery paths, and an honest limitations section, all assuming Claude's competence without padding. The only deductions are minor redundancy between the Contract and Anti-Patterns sections and slightly imperfect content placement for a single-file skill with no bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and gbrain-specific throughout — no explanations of concepts Claude already knows, and every section carries non-obvious operational detail (provenance tag rules, exact-match `--type` semantics, edge-uniqueness keys). Minor over-explanation remains: the Contract and Anti-Patterns sections repeat several points (relational-recall limitation, test-before-bulk, source scoping), which fits the 4 anchor (efficient, minor instances that could be trimmed) rather than the lean 5. | 4 / 5 |
Actionability | Copy-paste-ready commands throughout: `gbrain link doc-b-example doc-a-example --link-type extends --link-source citation-graph --context ... --source <corpus-source>`, `gbrain graph-query ... --type overrules --direction in`, plus `link-sources` and `check-backlinks` hygiene, a worked synthetic fixture, and a concrete output-format template. Fully executable guidance covering the common cases, matching the 5 anchor; the judgment steps (detect/classify) are instruction-only but name the exact tools (`gbrain search`, `get_page`, `resolve_slugs`) and are actionable. | 5 / 5 |
Workflow Clarity | A clearly sequenced 5-step pipeline (preflight → detect → classify → write → verify → hygiene) with an explicit hard validation gate ("The run is not complete until a `graph-query` walk... No verified walk = the run reports failure"), failure-recovery guidance for specific errors (`page_not_found`, `sync_in_progress`/`lock_busy`), and a test-before-bulk checkpoint. This matches the 5 anchor (explicit validation, feedback loops, checklist-style process) — the batch-operation cap does not apply because validation is present. | 5 / 5 |
Progressive Disclosure | Well-organized single-file skill with clear sections (What it is / Contract / Pipeline / Run it / Output Format / When it fails / Anti-Patterns / Dedup) and clearly signaled one-level-deep references to shared convention files at the top. It fits the 4 anchor (good structure, references mostly clear, minor gaps) rather than 5 because the conventions live outside the skill directory and a couple of sections (Dedup, Anti-Patterns) could arguably be externalized if the skill grows. | 4 / 5 |
Total | 18 / 20 Passed |