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: an overview that routes each request class to a concrete, verified reference file or to a fully specified help command, with explicit token-budget rules and unambiguous branching. Its only imperfection is minor trimmable filler in the persona paragraph; structure, actionability, and disclosure are all top-tier.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~30-line body explains nothing Claude already knows and even encodes token discipline ("loading the help then only fills context", "Skip this section while the request is only a setup, migrate or initiative action"). It is not a 5 only because the persona paragraph carries minor trimmable filler ("be helpful and guiding"; the self-introduction overlaps the first-person instruction). | 4 / 5 |
Actionability | Guidance is fully executable: the exact command "uv run {skill-root}/scripts/knowledge.py --content" with "--root <folder>" per active skills folder (project folders first), precise definitions of {project-root} and {skill-root}, and each reference file paired with an explicit load condition. No pseudocode or vague direction. | 5 / 5 |
Workflow Clarity | The routing is unambiguous: action-only requests load exactly one named reference; everything else follows a numbered two-step help flow, with an explicit skip rule and a come-back rule if the conversation turns to help, plus a guard that every answer comes from installed module help "never from memory". No destructive or batch operations are performed in the body, so the validation cap does not apply. | 5 / 5 |
Progressive Disclosure | The body is a clear overview with well-signaled one-level-deep references: references/setup.md, migrate.md, initiative.md and help.md are all real files (verified) whose content is appropriately split out rather than inlined, and scripts/knowledge.py exists at the path the body names. Each reference is labeled with the exact requests it serves, making navigation easy. | 5 / 5 |
Total | 19 / 20 Passed |