Content
86%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 hub-style SKILL.md: a lean, directive overview that defers all rule detail to well-signaled, one-level-deep reference files with explicit ownership boundaries, and a clear four-step workflow with an explicit verification step. The only minor gaps are the absence of in-body example commands and an explicit error-recovery loop in the workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~45-line body is lean and directive throughout: "This skill owns TypeScript policy within the kit", "Do not reimplement deterministic TypeScript, ESLint, or formatting checks", with no padding and no explanation of concepts Claude already knows — every token earns its place, matching anchor 5. | 5 / 5 |
Actionability | The guidance is concrete and executable for an instruction-only hub skill (inspect repository configuration, precedence rules, named verification loops: "focused type checks, lint, formatting, and behavioral tests as relevant"), and the absence of code is not penalized per the rubric's scoring note; the minor gap versus anchor 5 is that no example commands or snippets appear in the body itself — the concrete examples all live one level deeper in the references. | 4 / 5 |
Workflow Clarity | Four clearly sequenced steps (Establish policy → Load rules → Apply → Verify) with an explicit verification checkpoint, escalation guidance ("Expand by impact and run repository-mandated gates at their defined stages"), and completion criteria ("Finish when each relevant rule is satisfied or a justified exception is identified") — anchor 4 rather than 5 because no explicit error-recovery/fix-retry loop is described, though this policy skill involves no destructive or batch operations, so the workflow cap does not apply. | 4 / 5 |
Progressive Disclosure | The body is a model one-level-deep index: every one of the 10 local reference files exists and is clearly signaled with "read for…" scope statements plus ownership boundaries (e.g., "Types owns narrowing and assertion policy"), organized under Conventions and Worked comparisons, with the section-level contents claim verified in the actual files; the three cross-kit comparison links (../typescript-contracts/, ../node/) are explicitly labeled as belonging to sibling skills, so navigation remains clear — anchor 5. | 5 / 5 |
Total | 18 / 20 Passed |