Claude skill

A skill is a folder with a SKILL.md file inside it — skills/deepbookie/. The file teaches Claude when to reach for DeepBookie and in what order to call the tools. It carries no code and no keys. The tools live elsewhere (the MCP server or CLI). You install the skill, then wire up the tools separately.

What a SKILL.md is

SKILL.md is plain markdown with a short YAML header (name, description, version) and a body of instructions. Claude reads the description to decide if the skill is relevant, then follows the body as a playbook. DeepBookie’s header:

name: deepbookie
description: Trade DeepBook Predict (Sui's testnet prediction market) —
  read live odds, place binary or price-band bets, and provide liquidity.
version: 0.0.1

When it activates

The skill fires when the user wants to bet on short-term BTC moves, check prediction-market odds, or manage Predict positions on Sui:

• “What are the odds BTC is above $63k soon?” → get_odds / get_quote
• “Bet $5 that BTC stays above $63k” → mint
• “Show my positions and PnL” → get_portfolio

This skill covers Predict only — the binary and price-band bets. It stands down for spot trading and for mainnet, since Predict is testnet-only right now.

The playbook it encodes

The body gives Claude one flow to follow end to end:

You enter strikes in dollars; DeepBookie snaps them to the nearest valid grid strike. Bets are funded in dUSDC. Reads are free. Writes return an unsigned transaction — nothing happens until you sign it.

How to install it

Installing has two parts: put the skill folder where Claude can find it, then point Claude at the tools it names.

Step 1 — Install the skill

The easiest way is the Vercel skills CLI — the open “npm for agent skills.” It installs straight from this repo into your agent’s skills folder. Nothing to clone, nothing to publish.

# install the DeepBookie skill into your agent
npx skills add Blockchain-Oracle/deepbookie --skill deepbookie
 
# or target Claude Code specifically
npx skills add Blockchain-Oracle/deepbookie --skill deepbookie -a claude-code

It works with Claude Code, Cursor, Codex, and 60+ other agents. Manage it later with npx skills list, npx skills update deepbookie, or npx skills remove deepbookie.

Step 2 — Wire up the tools

The skill is just the playbook. Claude still needs the tools to call. Provide them with either the MCP server or the CLI:

# MCP path: expose the tools over stdio, then add to your MCP client
npx -y @deepbookie/mcp        # bin: deepbookie-mcp
 
# CLI path: same tools from the shell
deepbookie call get_odds '{ "oracleId": "..." }'

On first run the MCP server or CLI creates a local wallet and prints its address. Fund that address with testnet SUI (for gas) and dUSDC (for bets) before placing a trade.