hyperliquid-reader

Read Hyperliquid (app.hyperliquid.xyz) perp + spot market data via opencli (read-only, public info API). Use whenever the user wants Hyperliquid perpetual or spot markets, mark/oracle/mid prices, 24h change, funding rates (hourly or annualized APR), open interest, volume, the L2 order book, OHLCV candles, historical funding, or a cross-venue funding comparison (Hyperliquid vs Binance vs Bybit) for funding arbitrage. Triggers: "Hyperliquid funding for BTC", "HL perp markets", "funding on BTC perp", "Hyperliquid order book", "HL open interest", "funding arb Hyperliquid vs Binance", "Hyperliquid candles for SOL", "Hyperliquid spot markets", "PURR price on Hyperliquid", "hyperliquid", "hyperliquid.xyz", "HL DEX". READ-ONLY market data — no account, order, or trade operations.

Quality

96%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Quality

Content

92%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, actionable read-only skill body: real commands with flags, a sequenced 5-step workflow with a readiness validation gate and error-recovery table, and a clean one-level-deep reference split. The only weakness is mild repetition of the read-only boundary and a little trimmable intro context.

Suggestions

State the read-only boundary once (in the intro) and reference it rather than repeating it in the description, the bold intro paragraph, and Step 3 rule 8.

Trim the 'How it works' paragraph and the 'on-chain perps/spot DEX' gloss — the audience can be assumed to know what Hyperliquid is once the read-only scope is stated.

Consider moving the per-command output-columns list (Step 3) into references/commands.md to keep SKILL.md purely an overview, since the full schemas already live there.

Dimension	Reasoning	Score
Conciseness	Mostly efficient and domain-specific (it does not explain what funding, OHLCV, or an order book are), but the read-only boundary is restated ~3 times and the 'on-chain perps/spot DEX' gloss plus the 'How it works' paragraph could be trimmed.	4 / 5
Actionability	Fully executable guidance throughout — real 'opencli hyperliquid markets --sort fundingAprPct --limit 15 -f json' style commands with concrete flags, install commands, a diagnostic command, and explicit output columns per command.	5 / 5
Workflow Clarity	Five clearly sequenced steps with an explicit readiness gate in Step 1 ('READY' vs 'SETUP_NEEDED' vs 'NOT_INSTALLED' branches) and a Diagnostics step plus Error Reference table providing error→cause→fix recovery loops.	5 / 5
Progressive Disclosure	SKILL.md stays an overview (command mapping, key rules, presentation guidance) and points to one clearly-signaled, one-level-deep reference — 'references/commands.md — Every command with all flags, output schemas, and analyst workflows' — which exists on disk.	5 / 5
	Total	19 / 20 Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, third-person description: concrete capabilities, an explicit trigger list with synonyms, and a clear read-only boundary that minimizes conflict with trading skills. Both the 'what' and 'when' are answered explicitly.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete read actions across distinct data types — 'mark/oracle/mid prices, 24h change, funding rates (hourly or annualized APR), open interest, volume, the L2 order book, OHLCV candles, historical funding' and a 'cross-venue funding comparison' — comprehensive coverage of the read domain.	5 / 5
Completeness	Explicitly answers both what ('Read Hyperliquid perp + spot market data via opencli (read-only, public info API)') and when ('Use whenever the user wants...') with concrete trigger phrases.	5 / 5
Trigger Term Quality	An explicit 'Triggers:' list supplies natural phrases users would say ('Hyperliquid funding for BTC', 'funding arb Hyperliquid vs Binance', 'PURR price on Hyperliquid') plus synonyms ('HL', 'hyperliquid.xyz', 'HL DEX').	5 / 5
Distinctiveness Conflict Risk	Clear niche (a single named on-chain DEX), distinct Hyperliquid-specific triggers, and an explicit 'READ-ONLY market data — no account, order, or trade operations' boundary that separates it from trading skills.	5 / 5
	Total	20 / 20 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: himself65/finance-skills
Path: plugins/data-providers/skills/hyperliquid-reader/SKILL.md
Commit: 81e1f50

Reviewed: 7 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.