Hummingbot Skills¶

Hummingbot Skills are structured agent capabilities for AI assistants that provide commands, scripts, and documentation for managing the Hummingbot ecosystem. Each skill bundles everything an AI agent needs to perform a specific set of tasks — from deploying bots to managing LP positions.

GitHub Repository: github.com/hummingbot/skills

Unlike MCP (which requires a running server), skills work with any AI assistant or agent framework by providing self-contained scripts and structured prompts that can be run directly against the Hummingbot API.

Available Skills¶

Skill	Description
`hummingbot`	Core skill: manage bots, strategies, connectors, and accounts
`lp-agent`	LP position management for CLMM pools (Meteora, Raydium) with visualization and export
`hummingbot-deploy`	Deploy and manage Hummingbot API stack via Docker
`hummingbot-developer`	Developer workflow: install, build, and run the full stack from source
`hummingbot-heartbeat`	Hourly Hummingbot status updates (API, Gateway, bots, portfolio) delivered to Telegram or Discord
`connectors-available`	Discover and test available exchange connectors
`find-arbitrage-opps`	Scan for arbitrage opportunities across CEX and DEX exchanges (Jupiter, Uniswap, PancakeSwap)
`find-xemm-opps`	Find Cross-Exchange Market Making opportunities via order book depth analysis and auto-generate strategy configs

Environment Variables¶

All skills authenticate against Hummingbot API using the same environment variables:

Variable	Default	Description
`HUMMINGBOT_API_URL`	`http://localhost:8000`	Hummingbot API base URL
`API_USER`	`admin`	API username
`API_PASS`	`admin`	API password

Set these in your shell or a .env file before running any skill scripts:

export HUMMINGBOT_API_URL=http://localhost:8000
export API_USER=admin
export API_PASS=admin

Install via npx (Claude Code / Cursor / Codex)¶

The recommended way to install skills for MCP-compatible AI coding agents is via npx:

npx skills add hummingbot/skills --yes

This installs all skills from the repository into your agent's skill directory. To install a specific skill only:

npx skills add hummingbot/skills/skills/lp-agent --yes

After installation, skills are available as agent commands (e.g., /lp-agent run-strategy).

Install for OpenClaw¶

OpenClaw is a personal AI assistant platform that uses skills natively. Skills provide structured commands that OpenClaw's AI agent can execute on your behalf.

Installing Skills¶

Install all Hummingbot skills into your OpenClaw workspace:

npx skills add hummingbot/skills --yes

Or install a specific skill:

npx skills add hummingbot/skills/skills/hummingbot --yes

Skills are installed to ~/.openclaw/workspace/.agents/skills/.

Using Skills in OpenClaw¶

Once installed, invoke skills using slash commands in your OpenClaw chat:

/hummingbot start
/lp-agent run-strategy
/hummingbot-deploy deploy-api
/hummingbot-developer verify-build

lp-agent Skill¶

The lp-agent skill is purpose-built for managing liquidity positions on Solana CLMM pools (Meteora, Raydium). Use it to:

Deploy and monitor LP executors via Hummingbot API
Visualize position performance with interactive HTML dashboards
Export position history to CSV for analysis

Key commands:

Command	Description
`run-strategy`	Start an LP strategy on a CLMM pool
`manage-positions`	List, stop, and inspect LP executors
`analyze-performance`	Generate a visual dashboard for a position
`export-data`	Export position history to CSV
`add-wallet`	Add a Solana wallet to Gateway
`setup-gateway`	Configure Gateway for DEX connectivity

Required setup:

export HUMMINGBOT_API_URL=http://localhost:8000
export API_USER=admin
export API_PASS=admin

Then in OpenClaw:

/lp-agent setup-gateway
/lp-agent add-wallet
/lp-agent run-strategy

hummingbot-developer Skill¶

The hummingbot-developer skill manages the full Hummingbot dev stack from source — useful when developing custom strategies or contributing to Hummingbot.

Key commands:

Command	Description
`start`	Check dev environment status
`install-all`	Install all three repos in order
`verify-build`	Verify builds are correct and in sync
`run-dev-stack`	Start full stack from source
`test-integration`	Smoke test the full stack

Creating Custom Skills¶

Skills follow a simple structure:

my-skill/
├── SKILL.md          # Skill definition: name, commands, instructions for the agent
└── scripts/          # Supporting scripts called by the agent
    ├── my_script.py
    └── my_script.sh

SKILL.md defines the skill's commands in YAML frontmatter and provides instructions the AI agent follows when a command is invoked. See the hummingbot/skills repository for examples.

To contribute a skill, open a pull request against the main branch of hummingbot/skills.

find-arbitrage-opps Skill¶

The find-arbitrage-opps skill scans for price discrepancies across CEX and DEX exchanges, including on-chain liquidity via Gateway.

Features:

Compares prices across all connected CEX connectors in parallel
DEX support via --dex flag: queries Jupiter (Solana), Uniswap (Ethereum), and PancakeSwap (BSC) through Hummingbot Gateway
Smart chain-aware routing — Jupiter only queried for Solana tokens, Uniswap/PancakeSwap for Ethereum/BSC tokens
Regional exchange filtering: btc_markets (AU-only) and ndax (CA-only) excluded by default with opt-in flags
Outlier filtering (±20% from median) to remove stale or erroneous prices

Usage:

# CEX only
python scripts/find_arb_opps.py --base SOL --quote USDC

# Include DEX (Jupiter + Uniswap + PancakeSwap)
python scripts/find_arb_opps.py --base ETH --quote USDC --dex

# Filter to specific connectors
python scripts/find_arb_opps.py --base BTC --quote USDT --connectors binance,kraken,coinbase

find-xemm-opps Skill¶

The find-xemm-opps skill identifies optimal exchange pairs for Cross-Exchange Market Making (XEMM) by analyzing live order book depth.

What is XEMM?

XEMM involves quoting on one exchange (maker) while hedging fills on another (taker). Best opportunities exist where:

Maker side: wide bid-ask spread + shallow book = room to profit from quotes
Taker side: tight spread + deep book = cheap and liquid hedge

Features:

Fetches order book snapshots (depth 20) from all connectors in parallel
Scores each exchange pair by: mid-price gap, spread ratio, depth ratio, and order book balance (B/A ratio)
Penalizes imbalanced books (B/A > 2.0 or < 0.5) to filter risky opportunities
Auto-suggests xemm_multiple_levels profitability levels based on taker spread
--create-config flag saves a ready-to-deploy controller config to Hummingbot API

Usage:

# Scan for XEMM opportunities
python scripts/find_xemm_opps.py --base SOL --quote USDT,USDC

# Scan and auto-create a controller config
python scripts/find_xemm_opps.py --base ETH --quote USDT \
  --connectors binance,okx,kraken,mexc \
  --create-config --total-amount 500 --config-name my_eth_xemm

Environment variables:

export HUMMINGBOT_API_URL=http://localhost:8000
export API_USER=admin
export API_PASS=admin