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 exemplary dispatcher-style SKILL.md body: concise, well-structured, and cleanly delegating detail to five purpose-labeled reference files that all exist. The only improvement would be removing the one sentence that duplicates the frontmatter description. All four dimensions land at or near the top anchors.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean routing table where every reference line earns its place, but "Use this skill for CLI command design and implementation." restates the frontmatter description and could be trimmed. This is a minor instance of over-explanation, matching anchor 4 rather than the every-token-earns-its-place anchor 5. | 4 / 5 |
Actionability | Each line is a fully executable directive mapping a concrete condition to a named file (e.g., "references/client-cache-sync.md when touching toolkit client services"). Per the instruction-skill note, absence of code is not penalized because the guidance is specific and directly actionable, covering the common cases. | 5 / 5 |
Workflow Clarity | The body's single action — select and read the matching reference — is unambiguous because every reference is annotated with when to use it. As a simple dispatcher skill with no destructive or batch operations in the body, it meets the simple-skill exception for a top workflow-clarity score. | 5 / 5 |
Progressive Disclosure | The body is a clear overview that splits content across five one-level-deep references (references/design.md, references/implementation.md, references/client-cache-sync.md, references/command-example.md, references/data-and-lifecycle.md), all of which exist in the bundle and are clearly signaled with their scope. Navigation is easy with no nesting or buried references. | 5 / 5 |
Total | 19 / 20 Passed |