CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

hyperliquid-reader

Read Hyperliquid (app.hyperliquid.xyz) perp and spot market data through opencli and Hyperliquid's public info API: mark, oracle, and mid prices, 24h change, funding rates (hourly and annualized APR), open interest, volume, the L2 order book, OHLCV candles, funding history, and cross-venue funding comparisons (Hyperliquid vs Binance vs Bybit) for funding arbitrage. Use this skill whenever the user mentions Hyperliquid (HL, HL DEX, hyperliquid.xyz) or asks about its perps, spot pairs such as PURR, funding, open interest, order book, or candles. Read-only market data: no account, order, or transfer operations.

76

Quality

95%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

88%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.

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.

DimensionReasoningScore

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

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.

The description is exemplary: it enumerates the full capability set concretely, pairs it with explicit and well-scoped trigger guidance including platform synonyms (HL, HL DEX, hyperliquid.xyz), and states a clear read-only boundary. No weaknesses were identified against any anchor.

DimensionReasoningScore

Specificity

"mark, oracle, and mid prices, 24h change, funding rates (hourly and annualized APR), open interest, volume, the L2 order book, OHLCV candles, funding history, and cross-venue funding comparisons (Hyperliquid vs Binance vs Bybit)" enumerates every capability concretely and comprehensively, matching the score-5 anchor rather than the score-4 anchor (which expects minor coverage gaps).

5 / 5

Completeness

It explicitly answers what ("Read Hyperliquid ... perp and spot market data through opencli and Hyperliquid's public info API") and when ("Use this skill whenever the user mentions Hyperliquid ... or asks about its perps, spot pairs such as PURR, funding, open interest, order book, or candles"), with concrete trigger phrases and a clear read-only boundary — an exact match to the score-5 anchor; the score-4 anchor requires a less explicit 'when', which is not the case here.

5 / 5

Trigger Term Quality

"Hyperliquid (HL, HL DEX, hyperliquid.xyz)" plus natural terms "perps", "spot pairs such as PURR", "funding", "open interest", "order book", or "candles" covers the platform identifiers and every synonym a user would naturally say, with nothing significant missing (the score-4 anchor).

5 / 5

Distinctiveness Conflict Risk

The trigger is scoped to a single venue ("whenever the user mentions Hyperliquid" / "asks about its perps") so generic terms like funding and order book do not fire for other exchange-data skills — a clear niche with minimal conflict risk, matching the score-5 rather than the score-4 anchor (which expects overlap with closely related skills).

5 / 5

Total

20

/

20

Passed

Validation

100%

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

Reviewed

Table of Contents

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.