Content
96%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 router-style skill body: lean, concrete, and fully sequenced with explicit validation gates, fail-closed rules, and exact commands. The only structural weakness is bundle navigation — a portion of the references/ tree is not reachable or signaled from SKILL.md itself.
Suggestions
Add one-line entries to the References section for the remaining bundle data files (contract.yaml, knowledge-demand.yaml, task-profile.json, eval-scenarios.json) and the evals/ and scorer-calibration/ subdirectories, or state explicitly that they are consumed by the ./bin/ask tooling rather than read directly.
Note in the References section that knowledge-capsule-routing.md is the index for all capsule files, so readers know the deeper reference tree is intentional and one hop away.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean router: no concept explanations Claude already knows, no padding, and dense imperative sections ('Prefer deterministic file, schema, regex, command, or artifact checks over LLM judges'). Every section carries routing or proof semantics that Claude could not infer. The only trim candidate is the near-duplicate failure-classification lists in Workflow step 5 and Failure Mode, but they serve distinct purposes (result classification vs blocking ownership), so this does not drop it to anchor 4's 'minor instances of over-explanation'. | 5 / 5 |
Actionability | Guidance is fully executable for an instruction/router skill: exact commands with flags ('./bin/ask skills package verify <skill-path> --json --robot', 'scorer-calibration', 'external-review'), concrete artifact shapes (claim-to-case map, sentence-support map, lane tables with named columns), and explicit pass conditions for every route check ('pass when every claim maps to a case or named gap'). Anchor 5's copy-paste-ready commands and specific coverage of common cases is met; anchor 4 would require missing key details, and none are found. | 5 / 5 |
Workflow Clarity | The 10-step Workflow is dependency-ordered with explicit validation checkpoints ('Run the deterministic proof closest to the changed claim', 'Stop dependent downstream gates at the first failed prerequisite') and error-recovery feedback loops ('patch only the responsible prompt, case, judge... and rerun the same check before widening'; repair followed by a 'sibling-pattern probe'). The route-check list is a per-lane checklist with pass criteria, matching anchor 5's sequence + validation + feedback loops + checklist pattern; anchor 4 would have minor validation gaps, which are absent. | 5 / 5 |
Progressive Disclosure | The References section is well-signaled with one-line descriptors and every referenced path exists one level deep; knowledge-capsule-routing.md explicitly serves as a first-party index into the deeper capsule files with load_when conditions, preventing hidden second-order guidance. However, scored against the actual bundle, several files and subdirectories (contract.yaml, knowledge-demand.yaml, task-profile.json, eval-scenarios.json, references/evals/, references/scorer-calibration/) are not discoverable from SKILL.md, and the bulk of the bundle sits two hops behind the routing index — minor organization gaps that fit anchor 4 rather than the fully clean split of anchor 5. | 4 / 5 |
Total | 19 / 20 Passed |