CtrlK
BlogDocsLog inGet started
Tessl Logo

hyperliquid

Hyperliquid market data, account history, trade review.

57

Quality

68%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./optional-skills/blockchain/hyperliquid/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

82%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 strong, highly actionable CLI skill document: fully executable commands throughout, a clear numbered workflow, honest pitfalls about rate limits and data limitations, and a verification step, all backed by a real matching script. Its main weaknesses are mild redundancy between the Quick Reference and the Procedure sections and the absence of any split into reference files for the flag-level detail.

DimensionReasoningScore

Conciseness

The body is lean: no explanations of concepts Claude already knows, no library comparisons, and every section carries operational content. However, the Quick Reference command list substantially duplicates the commands repeated in the 7-step Procedure, and the Prerequisites/How to Run sections restate the script path four-plus times, so anchor 4 (efficient with minor instances that could be trimmed) fits better than anchor 5's every-token-earns-its-place.

4 / 5

Actionability

Every step is a fully executable copy-paste command with real flags and realistic arguments (e.g. "candles BTC --interval 1h --hours 72 --limit 48", "export BTC --interval 15m --hours 72 --end-time-ms 1760000000000"), plus a --json option and a runnable verification command. This matches anchor 5: copy-paste ready commands covering the common cases, and was verified against the actual script whose 12 subcommands match the documented set.

5 / 5

Workflow Clarity

The 7-step Procedure gives a clear, logically ordered sequence (discover markets → history → book → account → fills → review → export), and the read-only nature means the destructive/batch validation cap does not apply. The verification smoke test and rate-limit recovery guidance ("iterate with later startTime values") are present, but per-step checkpoints and explicit feedback loops are only implicit, matching anchor 4 (clear sequence, most checkpoints, minor validation gaps) rather than anchor 5.

4 / 5

Progressive Disclosure

Structure is good: a compact overview, well-labeled sections, and a correctly signaled one-level-deep bundle reference (scripts/hyperliquid_client.py, which exists and contains all 12 documented commands). It falls short of anchor 5 because the body is ~212 lines with the full flag-level Quick Reference and detailed Pitfalls inlined — content that could partly live in a references file — leaving minor organization gaps consistent with anchor 4.

4 / 5

Total

17

/

20

Passed

Description

53%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 identifies the skill's niche clearly via the Hyperliquid name and three capability areas, but it omits any "use when" trigger guidance and relies on generic noun phrases rather than concrete capabilities or natural user keywords. It is serviceable but below the standard of the good examples, which pair a concrete what with explicit when-clauses.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks about Hyperliquid markets, candles, funding, the order book, or a wallet's positions, balances, fills, or orders."

Replace generic noun phrases with concrete capabilities and natural keywords: "Fetch Hyperliquid perpetual and spot market data (candles, funding, L2 order book) and account history (positions, spot balances, fills, orders); generate post-trade reviews and normalized JSON exports."

Mention read-only scope (no API key, no order placement) so users know it applies to data inspection rather than trading.

DimensionReasoningScore

Specificity

The description "Hyperliquid market data, account history, trade review." names the domain and three action areas, but they are generic noun phrases — no concrete operations like candles, funding, order book, positions, fills, or export are mentioned. This matches anchor 3 (domain and a couple of concrete actions, not comprehensive); it is not anchor 4 because the actions lack concrete verbs or specific capabilities, and not anchor 2 because it does go beyond a bare domain mention.

3 / 5

Completeness

The "what" is reasonably clear (query Hyperliquid market and account data, trade review), but there is no "Use when..." clause or equivalent trigger guidance — per the judging guidelines, a missing when-clause caps completeness at 3. Anchor 3 (clear what, when missing or only weakly implied) is the exact fit; it is not 4 because the when is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

"Hyperliquid" is a strong natural trigger, and "market data", "account history", "trade review" are plausible user phrases, but common variations users would actually say are missing: candles, funding, L2/order book, positions, balances, fills, orders, perp, export. This fits anchor 3 (some relevant keywords, missing common variations); not 4 because coverage of synonyms is thin, not 2 because several genuinely relevant keywords are present.

3 / 5

Distinctiveness Conflict Risk

"Hyperliquid" carves out a clear niche with minimal conflict risk against unrelated skills, but the remaining terms ("market data", "trade review") are generic and could overlap with other crypto/exchange or trading-analysis skills, so anchor 4 (mostly distinct, minor overlap with closely related skills) fits better than anchor 5's fully distinct triggers.

4 / 5

Total

13

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

13

/

16

Passed

Repository
NousResearch/hermes-agent
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.