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 routing-style SKILL.md: a tight task-to-reference table, real one-level-deep bundle files, explicit scope boundaries and safety rules with zero padding. The only soft spot is that actionable detail and validation checkpoints are delegated almost entirely to the reference files, leaving the body's own guidance partly principle-level.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~35-line body is lean and assumes Claude's competence: 'Paths describe the current implementation, not the only valid edit locations. Confirm them in the working branch.' Nothing explains concepts Claude already knows, and every sentence carries routing, scope, or safety information. Matches the 'every token earns its place' anchor. | 5 / 5 |
Actionability | The routing table gives concrete, executable direction — task categories mapped to real files ('references/rules/order-contracts.md') and named starting owners ('Hyperliquid actions and exchange service'). Not a 5 because some guidance stays at the principle level ('Trace incorrect trading facts to their source', 'Preserve account/instrument identity') with no commands or examples inline, and not a 3 because the navigation instructions are specific and immediately followable. | 4 / 5 |
Workflow Clarity | The sequence is unambiguous for a routing skill: 'Start with the matching topic below; add another reference when the investigation crosses that boundary', with validation addressed via per-topic 'validation cases' and 'validation recipes'. Not a 5 because validation checkpoints are delegated to referenced files rather than stated explicitly inline, and not a 3 because the sequence is coherent and validation/verification is clearly signposted, including reporting expectations. | 4 / 5 |
Progressive Disclosure | A clear overview with well-signaled one-level-deep references: the topic table routes to 7 rule files and the closing paragraph routes to 3 more, and all 10 referenced files exist under references/rules/ with substantive matching content (verified against order-contracts.md). Content is appropriately split — the body holds only routing and boundaries while details live in the references. | 5 / 5 |
Total | 18 / 20 Passed |