# hyperliquid

Places perp, spot and RWA orders on Hyperliquid from the agent chat. The agent's EVM wallet signs each order and sends it straight to the L1.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 8700 installs · ★ 29
- Author: Starchild-ai-agent
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Starchild-ai-agent/official-skills/tree/HEAD/hyperliquid/SKILL.md
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/skills/hyperliquid

## What it does

This is a script-delivery skill. There are no `hl_*` agent tools, so asking for `hl_order` or `hl_deposit` by name fails with “not found in registry”. The README says that is intentional, and the two working lanes are the way in.

Reads live in `exports.py`: positions, token balances, PnL over several windows, order book, candles, funding, fills and staking. Most functions take an optional `address`, so you can pull data for a wallet that is not the agent's own. Writes live in the async `HyperliquidClient` in `client.py`: perp and spot orders, stop-loss and take-profit, leverage up to the asset maximum, cancels, spot/perp transfers, and USDC moves over the Arbitrum bridge.

Before the first write you need the wallet policy switched on: load the `wallet-policy` skill and put forward its standard wildcard policy, which blocks key export and allows `*`. The `WALLET_SERVICE_URL` environment variable has to be set as well. Deposits start at 5 USDC; a withdrawal carries a 1 USDC fee and takes about 5 minutes. Skip the policy step and order signing will not go through.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill hyperliquid -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill hyperliquid -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill hyperliquid -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Starchild-ai-agent/official-skills hyperliquid
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill hyperliquid -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Starchild-ai-agent/official-skills --path hyperliquid
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill 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/Starchild-ai-agent/official-skills/tree/HEAD/hyperliquid/SKILL.md

## When to use it
- open a leveraged BTC long or short
- attach a stop-loss and take-profit to a position
- read another wallet's PnL on Hyperliquid
- move USDC between spot and perps
- cancel every open order on one coin

## Example prompts
- Long BTC with 5x leverage for $20
- Set a stop-loss on my BTC position
- Show allTime PnL for `0x1f16...`

## Similar
- [churn-prevention](https://affpapa.org/en/nevibecode/skills/coreyhaines31-churn-prevention.md) — skill · 121000 installs
- [revops](https://affpapa.org/en/nevibecode/skills/revops.md) — skill · 113500 installs
- [community-marketing](https://affpapa.org/en/nevibecode/skills/community-marketing.md) — skill · 89500 installs
- [ads](https://affpapa.org/en/nevibecode/skills/ads.md) — skill · 82800 installs
- [pricing](https://affpapa.org/en/nevibecode/skills/pricing.md) — skill · 79300 installs
- [marketing-plan](https://affpapa.org/en/nevibecode/skills/marketing-plan.md) — skill · 67900 installs

From the same set: [starchild-ai-agent/official-skills](https://affpapa.org/en/nevibecode/by/starchild-ai-agent/official-skills.md) — 18 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