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.
The body is an exemplary lean domain router: concrete file/proof targets, a clear triage workflow with verification, and well-structured one-level-deep references. Minor redundancy across routing tables and implicit feedback loops are the only things keeping it from full marks.
Suggestions
Collapse the overlap between Owner Matrix, Quick Reference, and Agent Routing Examples into a single mapping or cross-link them to reduce redundancy.
Make the validate->fix->retry loop explicit in the 60-Second Triage (e.g. 'verify with rg; if mismatch, re-pick owner and re-verify') to lift workflow clarity.
Consider folding the 'Verify Against the Source' bullets into the triage or hard-stops section to avoid a small amount of repeated volatility guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and table-driven, assumes Claude's competence, and never explains what Perps/Hyperliquid is; however the Owner Matrix, Quick Reference, and Agent Routing Examples tables overlap somewhat on surface-to-reference mappings and could be tightened, so it sits just below the lean/efficient anchor. | 4 / 5 |
Actionability | Highly actionable for an instruction-only router: it names exact owner files (e.g. ServiceHyperliquidExchange.ts), exact reference files to open, exact commands (`rg`), exact SDK paths (node_modules/@nktkas/hyperliquid/src/api/exchange/_methods/), and exact proof methods per surface, with absence of code excused by the instruction-only scoring note. | 5 / 5 |
Workflow Clarity | The '60-Second Triage' gives a clear 4-step sequence with an explicit verify step ('verify anchors with rg before editing') plus a 'Verify Against the Source' section and Hard Stops as checkpoints, but the validate->fix->retry feedback loop is implied rather than spelled out, so it is just below the explicit-feedback-loop anchor. | 4 / 5 |
Progressive Disclosure | SKILL.md is a pure overview/router linking to 10 reference files, all verified to exist and exactly one level deep under references/rules/, with a Quick Reference table and inline markdown links providing easy, well-signaled navigation. | 5 / 5 |
Total | 18 / 20 Passed |