Content
88%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 a highly actionable, well-sequenced read-only workflow with real validation checkpoints and a verified one-level-deep reference file. Its only weaknesses are minor: duplicated error/setup tables and inline output-column and flag detail that also lives in commands.md.
Suggestions
Merge the Step 1 "Common setup issues" table into the "Error Reference" table — the same two rows (Unknown command, 429) currently appear twice.
Move the per-command "Output columns" lists out of Step 3 into references/commands.md (where they already exist), keeping only the columns needed for the most common workflows inline.
Trim domain-convention explanations Claude already knows, e.g. "Positive funding ⇒ longs pay shorts; negative ⇒ shorts pay longs", to free tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean (dense tables and commands), but the "Common setup issues" table in Step 1 duplicates the "Error Reference" table ("Unknown command: hyperliquid" and "hyperliquid info 429" appear in both), and "Positive funding ⇒ longs pay shorts; negative ⇒ shorts pay longs" explains a convention Claude already knows. It sits noticeably above the score-3 anchor (only minor trims needed) but short of the score-5 anchor because clear duplication exists. | 4 / 5 |
Actionability | Every command is copy-paste ready with exact flags, sort keys, and limits ("opencli hyperliquid markets --sort fundingAprPct --limit 15 -f json", "Valid intervals: 1m 3m 5m ... Max 5000", "--depth (max 20)"), and error-to-fix mappings cover the common failure cases — a full match to the score-5 anchor, exceeding the score-4 anchor's "minor gaps". | 5 / 5 |
Workflow Clarity | Five clearly sequenced steps with explicit validation checkpoints: the Step 1 probe branches READY / SETUP_NEEDED / NOT_INSTALLED with per-branch fixes, and Step 5 diagnostics ("A successful BTC row confirms opencli, the plugin, and the public API are all reachable") provide an explicit error-recovery loop. The skill is read-only (no destructive or batch operations), so the validation cap does not apply; checkpoints are explicit rather than implied (the score-4 anchor). | 5 / 5 |
Progressive Disclosure | One real, well-signaled, one-level-deep reference ("references/commands.md — Every command with all flags, output schemas, and analyst workflows", verified to exist) with an easy-to-navigate body. It falls short of the score-5 anchor because the body still inlines full output-column lists for all seven commands and flag minutiae that duplicate commands.md, and short of the score-3 anchor because structure and reference signaling are good. | 4 / 5 |
Total | 18 / 20 Passed |