Content
100%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 index skill: lean and information-dense, with fully specified quick-start calls, a sequenced workflow containing an explicit verification checkpoint and recovery path, and the bulk detail correctly deferred to a one-level REFERENCE.md. Both judges' strong examples are met or exceeded; no dimension shows a real defect.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line earns its place: the tool families are compact one-line lists, and non-obvious gotchas ("REST handlers whitelist fields and drop unknown ones", "This runs hybrid BM25 plus vector plus graph-expanded search") are stated without padding. Nothing explains concepts Claude already knows, matching the 'lean and efficient; every token earns its place' anchor rather than 4's 'minor instances of over-explanation'. | 5 / 5 |
Actionability | The quick start fully specifies the common cases with exact tool and parameter names ("memory_save with content (the insight), concepts (comma-separated keywords), files (comma-separated paths)" and "memory_smart_search with query, limit, and targetLayer: 'memory'") — copy-paste-ready for an MCP skill, satisfying the 5 anchor's 'specific examples cover the common cases'. It stays at 5 rather than 4 because the only deferred detail (exact requiredness of other tools' parameters) is explicitly routed to REFERENCE.md rather than left as a gap. | 5 / 5 |
Workflow Clarity | The 4-step workflow is clearly sequenced and includes an explicit verification checkpoint with a recovery loop: "distinguish matched_count: 0 from excluded_by_budget > 0. Expand clipped or omitted IDs with memory_smart_search and expandIds, preserving the same scope filters." This matches the 5 anchor (explicit validation steps plus error-recovery feedback). No destructive/batch cap applies since the workflow is tool selection and calling, not bulk mutation. | 5 / 5 |
Progressive Disclosure | The body is a clear overview with a well-signaled, one-level-deep reference ("Full tool table with parameters and the core-set marking lives in REFERENCE.md, generated from source so it never drifts") and a 'See also' section for sibling skills; the bulk tool table is appropriately split out. No bundle directories (references/, scripts/, assets/) are provided, so scoring follows the body's structure, which matches the 5 anchor's 'content appropriately split; easy navigation'. | 5 / 5 |
Total | 20 / 20 Passed |