@bitget-ai/bitget-agent-skill

The skill surface of the Bitget Agent Hub — installs an AI skill that teaches Claude Code, Codex, and OpenClaw when and how to use bgc for natural-language Bitget trading. Pure markdown, runtime-free.

npm install -g @bitget-ai/bitget-agent-cli      # the bgc CLI this skill drives
npx @bitget-ai/bitget-agent-skill                # one-shot: deploys SKILL.md into your AI tool

Why one is -g and the other is npx? bgc is a persistent CLI your AI calls dozens of times per session — it goes on $PATH. This skill, by contrast, is a one-shot deploy: it copies markdown into your AI tool's skill directory and exits, then is never used again until you upgrade. npx always pulls the latest version, so subsequent runs auto-upgrade you.

Prerequisites: Node.js ≥ 20. The bgc CLI (@bitget-ai/bitget-agent-cli) installed and on $PATH. A Bitget API key, secret, and passphrase (create one).

Installation is a separate, explicit step (no postinstall side effects). By default it deploys to Claude Code at ~/.claude/skills/bitget-agent-skill/.

Why a skill (vs. just installing bgc)

The CLI alone gives the AI 59 commands but no semantics — the assistant doesn't know when to reach for Bitget, or how to compose the right tool.

The skill adds:

• A trigger description so Claude Code / Codex / OpenClaw automatically invokes the skill on any Bitget-relevant request — including casual phrasings ("buy 0.1 BTC at market") and Chinese ("查看我的持仓").
• A reference catalog of every command with parameters and examples, auto-generated from the SDK's tool definitions.
• Operational guidance for write operations, demo trading, error codes, auth setup, and safety patterns.

Result: you say "buy 0.1 BTC at market on Bitget" and it actually works — the assistant knows to compose bgc spot spot_place_order --symbol BTCUSDT --side buy --orderType market --size 0.1, surfaces a [CAUTION] confirmation, and runs it.

Targets

# Default — Claude Code
npx @bitget-ai/bitget-agent-skill

# Pick targets explicitly
npx @bitget-ai/bitget-agent-skill --target claude
npx @bitget-ai/bitget-agent-skill --target claude,codex
npx @bitget-ai/bitget-agent-skill --target all

# Pick interactively
npx @bitget-ai/bitget-agent-skill --interactive

Currently supported skill destinations:

| Target | Skill location | |---|---| | Claude Code | ~/.claude/skills/bitget-agent-skill/ | | Codex | ~/.codex/skills/bitget-agent-skill/ | | OpenClaw | ~/.openclaw/skills/bitget-agent-skill/ |

After installing, restart your AI host so the new skill is picked up.

How it fits together

You → Claude Code / Codex / OpenClaw  (with this skill loaded)
             │
             │   "buy 0.1 BTC at market on Bitget"
             ▼
        bgc CLI  (@bitget-ai/bitget-agent-cli)
             │
             ▼
       Bitget REST API

bitget-agent-skill ships pure markdown — no daemon, no runtime, no MCP server. The actual API calls go through bgc, which the skill teaches the AI to invoke correctly.

What ships in the skill

| File | Purpose | |---|---| | SKILL.md | Top-level skill definition with trigger phrases (English + Chinese) so the AI knows when to invoke. | | references/commands.md | Auto-generated catalog of all 59 tools — names, parameters, defaults, auth requirements. | | references/auth-setup.md | How to create a Bitget API key and configure environment variables. | | references/demo-trading.md | How to use --paper-trading for safe rehearsal. | | references/error-codes.md | Bitget API error codes and recommended AI responses. |

Pair with market signals

For market analysis (no API key needed), pair this skill with @bitget-ai/bitget-signal:

npx @bitget-ai/bitget-signal

Five additional skills get installed (macro / market-intel / sentiment / technical / news) and Bitget's public market-data MCP server is registered. The two products are complementary — one trades, the other analyses.

Manage everything with the meta installer

If you're using more than one Bitget AI package, the meta installer can install / upgrade / rollback the lot:

npx @bitget-ai/bitget-agent-installer

See agent-hub for the full installer feature list.

License

MIT

Part of the Bitget Agent Hub ecosystem · Trading Stack · Surface. Foundation: agent-sdk · Other surfaces: agent-cli · agent-mcp · Market signals: bitget-signal