# grimoire-hyperliquid

A skill that lets your agent pull Hyperliquid market data through the Grimoire CLI: mids, order books, metadata, open orders. Withdrawals too, when asked.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1100 installs · ★ 6
- Author: franalgaba
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/franalgaba/grimoire/tree/HEAD/skills/grimoire-hyperliquid/SKILL.md
- Updated: 2026-05-08
- HTML: https://affpapa.org/en/nevibecode/skills/grimoire-hyperliquid

## What it does

The skill wires the Grimoire venue CLI into your agent under `grimoire venue hyperliquid`. Read-only calls cover `mids` for perp mid prices, `l2-book --coin <symbol>`, `open-orders --user <address>`, plus `meta` and `spot-meta`. The `-snapshot` variants emit `params:` blocks for spell inputs and are meant for the agent alone — interactive output is suppressed.

Run `grimoire venue doctor --adapter hyperliquid --json` first. The `withdraw` command is stateful: it wants `HYPERLIQUID_PRIVATE_KEY` in the environment, a keystore, and a clear confirmation from you. Orders go through a `custom` action with `op: "order"`; accepted TIF values are `Gtc`, `Ioc`, `Alo` and `FrontendMarket`. Runtime constraints such as `max_slippage` are not supported — order parameters get checked at the adapter boundary instead.

To compare symbols by midpoint, use the `mid_price` metric: `hl_mid = metric("mid_price", hyperliquid, ETH)`. Pick `--format spell` for spell inputs, `--format json` when scripting `meta` or `spot-meta`, and `--format table` for compact summaries of nested payloads. EVM tooling like `anvil` or `cast` is of no use here.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add franalgaba/grimoire --skill grimoire-hyperliquid -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/grimoire-hyperliquid/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/grimoire-hyperliquid/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add franalgaba/grimoire --skill grimoire-hyperliquid -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/grimoire-hyperliquid/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add franalgaba/grimoire --skill grimoire-hyperliquid -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/grimoire-hyperliquid/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install franalgaba/grimoire grimoire-hyperliquid
```

2. **Manually: put the files in place**
- File: `.github/skills/grimoire-hyperliquid/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add franalgaba/grimoire --skill grimoire-hyperliquid -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/franalgaba/grimoire --path skills/grimoire-hyperliquid
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/grimoire-hyperliquid/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add franalgaba/grimoire --skill grimoire-hyperliquid -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/franalgaba/grimoire/tree/HEAD/skills/grimoire-hyperliquid/SKILL.md

## When to use it
- read mid prices across all perp assets
- pull the L2 book for one coin
- list open orders for an address
- grab perp and spot market metadata
- emit a `params:` block for a spell input

## Example prompts
- Show Hyperliquid mid prices as a table
- Fetch the L2 book for BTC and output it as a spell
- Run the Hyperliquid doctor check and print the JSON

## Similar
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [ask-matt](https://affpapa.org/en/nevibecode/skills/ask-matt.md) — skill · 766587 installs
- [to-tickets](https://affpapa.org/en/nevibecode/skills/to-tickets.md) — skill · 711230 installs
- [writing-plans](https://affpapa.org/en/nevibecode/skills/writing-plans.md) — skill · 282859 installs
- [caveman-review](https://affpapa.org/en/nevibecode/skills/caveman-review.md) — skill · 411800 installs
- [caveman-compress](https://affpapa.org/en/nevibecode/skills/caveman-compress.md) — skill · 411500 installs

From the same set: [franalgaba/grimoire](https://affpapa.org/en/nevibecode/by/franalgaba/grimoire.md) — 4 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md