{"_id":"@bitget-ai/bitget-agent-skill","_rev":"7-6d3a8e807688655e79f9fb14313d22cf","name":"@bitget-ai/bitget-agent-skill","dist-tags":{"latest":"3.3.1"},"versions":{"1.2.0":{"name":"@bitget-ai/bitget-agent-skill","version":"1.2.0","keywords":["bitget","bitget-skill","skill","claude-code","codex","openclaw","trading","crypto","ai-agent","natural-language"],"license":"MIT","_id":"@bitget-ai/bitget-agent-skill@1.2.0","maintainers":[{"name":"andrewyang_bgai","email":"useanjieyang@gmail.com"}],"bin":{"bitget-agent-skill":"scripts/install.js"},"dist":{"shasum":"c0a136a20b929f390749e5ed96d7d36b73e09199","tarball":"https://registry.npmjs.org/@bitget-ai/bitget-agent-skill/-/bitget-agent-skill-1.2.0.tgz","fileCount":24,"integrity":"sha512-UjEfqSR4bLSXGGW33TJed5IF1ih9SQ9oukDAj1JRANhV27DC/x7Lj6f7F/nyYxLWh71rwxJGyh9Vu6B45xYMuA==","signatures":[{"sig":"MEYCIQDeGQuhJ0veZZfESq+U3fQLGmKuIq05B3+WiQL68Vmn9gIhAMnOHDJiBaIysNl0Mrg1Y0YQdNlZrl1APjOUQ936mPPp","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":128892},"type":"module","engines":{"node":">=20.0.0"},"scripts":{"install-skill":"node scripts/install.js","gen-references":"node scripts/gen-references.js","prepublishOnly":"node scripts/gen-references.js"},"_npmUser":{"name":"andrewyang_bgai","email":"useanjieyang@gmail.com"},"_npmVersion":"10.2.3","description":"Official Bitget AI skill — teaches Claude Code, Codex, and OpenClaw how to drive the Bitget API via the bgc CLI for natural-language trading. Run `npx bitget-agent-skill` to deploy into your AI tool's skill directory.","directories":{},"_nodeVersion":"20.10.0","publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"packageManager":"pnpm@8.14.1","devDependencies":{"@bitget-ai/bitget-agent-sdk":"^1.2.0"},"_npmOperationalInternal":{"tmp":"tmp/bitget-agent-skill_1.2.0_1781507954708_0.19452487688819375","host":"s3://npm-registry-packages-npm-production"}},"3.0.0":{"name":"@bitget-ai/bitget-agent-skill","version":"3.0.0","keywords":["bitget","bitget-skill","skill","claude-code","codex","openclaw","trading","crypto","ai-agent","natural-language"],"license":"MIT","_id":"@bitget-ai/bitget-agent-skill@3.0.0","maintainers":[{"name":"andrewyang_bgai","email":"useanjieyang@gmail.com"}],"bin":{"bitget-agent-skill":"scripts/install.js"},"dist":{"shasum":"f0bdb6b4e102b9c9d781854997cc6f61da52c13b","tarball":"https://registry.npmjs.org/@bitget-ai/bitget-agent-skill/-/bitget-agent-skill-3.0.0.tgz","fileCount":14,"integrity":"sha512-KwuwiMkLAqB6W6q8dUVky6i42955Hl2tEclO2XG2Vw24gAJ0GFNffpPMgLrwUqu85qvSoOGMZcesYltLSZTSPA==","signatures":[{"sig":"MEYCIQD5kQD6rwHcnCNcgG5yt9IVu2Y9n5qkOUkGGhbH9YzveAIhAIMWyBmADH1SlMucAEwvnbp7zprW/VlDHW3bd7PPYGVi","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":154385},"type":"module","engines":{"node":">=20.0.0"},"scripts":{"e2e:real":"node e2e/run.mjs","e2e:agent":"node e2e/agent/run.mjs","install-skill":"node scripts/install.js","gen-references":"node scripts/gen-references.js","prepublishOnly":"node scripts/gen-references.js"},"_npmUser":{"name":"andrewyang_bgai","email":"useanjieyang@gmail.com"},"_npmVersion":"10.2.3","description":"Official Bitget AI skill — teaches Claude Code, Codex, and OpenClaw when and how to drive the Bitget Unified Trading Account (UTA / v3) API through the `bgc` CLI from natural language. Run `npx @bitget-ai/bitget-agent-skill` to deploy into your AI tool's ","directories":{},"_nodeVersion":"20.10.0","publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"packageManager":"pnpm@8.14.1","devDependencies":{"@bitget-ai/bitget-agent-sdk":"^3.0.0"},"_npmOperationalInternal":{"tmp":"tmp/bitget-agent-skill_3.0.0_1782276550722_0.12107442543482594","host":"s3://npm-registry-packages-npm-production"}},"3.1.0":{"name":"@bitget-ai/bitget-agent-skill","version":"3.1.0","keywords":["bitget","bitget-skill","skill","claude-code","codex","openclaw","trading","crypto","ai-agent","natural-language"],"license":"MIT","_id":"@bitget-ai/bitget-agent-skill@3.1.0","maintainers":[{"name":"andrewyang_bgai","email":"useanjieyang@gmail.com"}],"bin":{"bitget-agent-skill":"scripts/install.js"},"dist":{"shasum":"0a740613cee0cad2dff1fccb46ac809c2e90d44f","tarball":"https://registry.npmjs.org/@bitget-ai/bitget-agent-skill/-/bitget-agent-skill-3.1.0.tgz","fileCount":14,"integrity":"sha512-dcp1FPW2XaSdignY1+BZ3N7ANCkbRNYouKHdCy9xjmXilyTTFHUtTwCUAg/GDDn8NVQPt/BKQnX+RYgWeoF+hQ==","signatures":[{"sig":"MEUCIQD3aoCfLRRLPWkFKj3A7QAuVMVABtCtCDP3iJQCJArg6wIgMa1tqEh2YZG08AySznOotmz0evs7oFQFFWBRoGy+CvY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":154135},"type":"module","engines":{"node":">=20.0.0"},"scripts":{"e2e:real":"node e2e/run.mjs","e2e:agent":"node e2e/agent/run.mjs","install-skill":"node scripts/install.js","gen-references":"node scripts/gen-references.js","prepublishOnly":"node scripts/gen-references.js"},"_npmUser":{"name":"andrewyang_bgai","email":"useanjieyang@gmail.com"},"_npmVersion":"10.2.3","description":"Official Bitget AI skill — teaches Claude Code, Codex, and OpenClaw when and how to drive the Bitget Unified Trading Account (UTA / v3) API through the `bgc` CLI from natural language. Run `npx @bitget-ai/bitget-agent-skill` to deploy into your AI tool's ","directories":{},"_nodeVersion":"20.10.0","publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"packageManager":"pnpm@8.14.1","devDependencies":{"@bitget-ai/bitget-agent-sdk":"^3.0.0"},"_npmOperationalInternal":{"tmp":"tmp/bitget-agent-skill_3.1.0_1788335671257_0.5110866043332551","host":"s3://npm-registry-packages-npm-production"}},"3.2.0":{"name":"@bitget-ai/bitget-agent-skill","version":"3.2.0","keywords":["bitget","bitget-skill","skill","claude-code","codex","openclaw","trading","crypto","ai-agent","natural-language"],"license":"MIT","_id":"@bitget-ai/bitget-agent-skill@3.2.0","maintainers":[{"name":"andrewyang_bgai","email":"useanjieyang@gmail.com"}],"bin":{"bitget-agent-skill":"scripts/install.js"},"dist":{"shasum":"8f2bf684bb814cafab5366dad126a073bc607cda","tarball":"https://registry.npmjs.org/@bitget-ai/bitget-agent-skill/-/bitget-agent-skill-3.2.0.tgz","fileCount":15,"integrity":"sha512-GciQiSjOlDcbD4jEg7MO5Nkd8vBONhk8+asOkAxsvvBTA9oYZjRFtWpwRCjYSNK67OxNAs3olmnVNCdWjISqiA==","signatures":[{"sig":"MEUCIQD4taXlTKqSJd6W907hxEyKZZ/ruQS1kX0gZOrbfmisIQIgPjFFglxSkOK7deIPrfK4ifwS8Roq1LWztRF6mQThsjk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":164611},"type":"module","engines":{"node":">=20.0.0"},"scripts":{"e2e:real":"node e2e/run.mjs","e2e:agent":"node e2e/agent/run.mjs","install-skill":"node scripts/install.js","gen-references":"node scripts/gen-references.js","prepublishOnly":"node scripts/gen-references.js"},"_npmUser":{"name":"andrewyang_bgai","email":"useanjieyang@gmail.com"},"_npmVersion":"10.2.3","description":"Official Bitget AI skill — teaches Claude Code, Codex, and OpenClaw when and how to drive the Bitget Unified Trading Account (UTA / v3) API through the `bgc` CLI from natural language. Run `npx @bitget-ai/bitget-agent-skill` to deploy into your AI tool's ","directories":{},"_nodeVersion":"20.10.0","publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"packageManager":"pnpm@8.14.1","devDependencies":{"@bitget-ai/bitget-agent-sdk":"^3.0.0"},"_npmOperationalInternal":{"tmp":"tmp/bitget-agent-skill_3.2.0_1788346456764_0.19895670017579414","host":"s3://npm-registry-packages-npm-production"}},"3.2.1":{"name":"@bitget-ai/bitget-agent-skill","version":"3.2.1","keywords":["bitget","bitget-skill","skill","claude-code","codex","openclaw","trading","crypto","ai-agent","natural-language"],"license":"MIT","_id":"@bitget-ai/bitget-agent-skill@3.2.1","maintainers":[{"name":"andrewyang_bgai","email":"useanjieyang@gmail.com"}],"bin":{"bitget-agent-skill":"scripts/install.js"},"dist":{"shasum":"bf1763c3c4c2c2266fcdd63ef7b30aeeb3f989a7","tarball":"https://registry.npmjs.org/@bitget-ai/bitget-agent-skill/-/bitget-agent-skill-3.2.1.tgz","fileCount":15,"integrity":"sha512-/YQSP/Bjnx07E8ury13HaGuy/XMSik+Eetr2NcIlDzz27Kligf8aW/OknX6rDpYk7+ACYGuDguCbpr92Ow2b+g==","signatures":[{"sig":"MEUCIQDqJl77puOpLV9vnwxXoYsSvQYLfx45SW+fp4sTfBtANAIgD4a5Idj+Rpc13W8JIzQ6a3caNnGZN5WXMQ4V9x7tuHs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":164933},"type":"module","engines":{"node":">=20.0.0"},"scripts":{"e2e:real":"node e2e/run.mjs","e2e:agent":"node e2e/agent/run.mjs","install-skill":"node scripts/install.js","gen-references":"node scripts/gen-references.js","prepublishOnly":"node scripts/gen-references.js"},"_npmUser":{"name":"andrewyang_bgai","email":"useanjieyang@gmail.com"},"_npmVersion":"10.2.3","description":"Official Bitget AI skill — teaches Claude Code, Codex, and OpenClaw when and how to drive the Bitget Unified Trading Account (UTA / v3) API through the `bgc` CLI from natural language. Run `npx @bitget-ai/bitget-agent-skill` to deploy into your AI tool's ","directories":{},"_nodeVersion":"20.10.0","publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"packageManager":"pnpm@8.14.1","devDependencies":{"@bitget-ai/bitget-agent-sdk":"^3.0.0"},"_npmOperationalInternal":{"tmp":"tmp/bitget-agent-skill_3.2.1_1788353577110_0.7494343987719856","host":"s3://npm-registry-packages-npm-production"}},"3.3.0":{"name":"@bitget-ai/bitget-agent-skill","version":"3.3.0","keywords":["bitget","bitget-skill","skill","claude-code","codex","openclaw","trading","crypto","ai-agent","natural-language"],"license":"MIT","_id":"@bitget-ai/bitget-agent-skill@3.3.0","maintainers":[{"name":"andrewyang_bgai","email":"useanjieyang@gmail.com"}],"bin":{"bitget-agent-skill":"scripts/install.js"},"dist":{"shasum":"f22cc13ca1308b5a0ceac17c6886c0d320a6666f","tarball":"https://registry.npmjs.org/@bitget-ai/bitget-agent-skill/-/bitget-agent-skill-3.3.0.tgz","fileCount":15,"integrity":"sha512-FfOGFM9/XpQ6lzhpw7GVVlTa7VxKNmdZaGVdSNUfAyi2mlFKzKBuiSUIlZSFxHjiaHaFHP76u2H4vbAIu3p4Tg==","signatures":[{"sig":"MEYCIQC8D/+jf/NBi55OpV5HSDReHI1g42IDJPfP1VLMV8R3kwIhAPWgs2iWeWadYN1FyhKpMPEaOquBBdCVPFepbeCVAuVI","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQCpq5LDHd6pQJDomMHsbRLNDk0nzZZ+lGCHAjiwLvE5rgIgZGJC7WezYss7200wUhOQzypVt6MbiFpRt1HZu2kj4/I=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":167492},"type":"module","engines":{"node":">=20.0.0"},"scripts":{"e2e:real":"node e2e/run.mjs","e2e:agent":"node e2e/agent/run.mjs","install-skill":"node scripts/install.js","gen-references":"node scripts/gen-references.js","prepublishOnly":"node scripts/gen-references.js"},"_npmUser":{"name":"andrewyang_bgai","email":"useanjieyang@gmail.com"},"_npmVersion":"10.2.3","description":"Official Bitget AI skill — teaches Claude Code, Codex, and OpenClaw when and how to drive the Bitget Unified Trading Account (UTA / v3) API through the `bgc` CLI from natural language. Run `npx @bitget-ai/bitget-agent-skill` to deploy into your AI tool's ","directories":{},"_nodeVersion":"20.10.0","publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"packageManager":"pnpm@8.14.1","devDependencies":{"@bitget-ai/bitget-agent-sdk":"^3.0.0"},"_npmOperationalInternal":{"tmp":"tmp/bitget-agent-skill_3.3.0_1789636068026_0.4331846449548096","host":"s3://npm-registry-packages-npm-production"}},"3.3.1":{"_id":"@bitget-ai/bitget-agent-skill@3.3.1","bin":{"bitget-agent-skill":"scripts/install.js"},"dist":{"shasum":"85ff7abd9f57fbc96048df8d9b599428073febd0","tarball":"https://registry.npmjs.org/@bitget-ai/bitget-agent-skill/-/bitget-agent-skill-3.3.1.tgz","fileCount":15,"integrity":"sha512-7wc5D2NuWFF5Ks6cUUvJlt+QxTHM6BYOGMFK5pkx0t4/oyYFLv3a9frCR+XXQyUwz91uKSlmiGP5hutH/bnq+g==","signatures":[{"sig":"MEUCIG1XcEg9QgHYDJJ8VqKSb8mUpEJUY8i+7a/H5vel1DwXAiEAyMmMjhGuUywJ3MWvIwNnKSKyQskTGl+EYbAusnsXTIY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIAWF3t044yvEDXTkM5OzFsJ+xiWHXL4P/GqlJ9oZImzJAiB8/IxQojJinIGfPrp0NkA1ZHt9pyeDPhBsP1TkVfH+1Q=="}],"unpackedSize":168459},"name":"@bitget-ai/bitget-agent-skill","type":"module","engines":{"node":">=20.0.0"},"license":"MIT","scripts":{"e2e:real":"node e2e/run.mjs","e2e:agent":"node e2e/agent/run.mjs","install-skill":"node scripts/install.js","gen-references":"node scripts/gen-references.js","prepublishOnly":"node scripts/gen-references.js"},"version":"3.3.1","_npmUser":{"name":"andrewyang_bgai","email":"useanjieyang@gmail.com"},"keywords":["bitget","bitget-skill","skill","claude-code","codex","openclaw","trading","crypto","ai-agent","natural-language"],"_npmVersion":"10.2.3","description":"Official Bitget AI skill — teaches Claude Code, Codex, and OpenClaw when and how to drive the Bitget Unified Trading Account (UTA / v3) API through the `bgc` CLI from natural language. Run `npx @bitget-ai/bitget-agent-skill` to deploy into your AI tool's ","directories":{},"maintainers":[{"name":"andrewyang_bgai","email":"useanjieyang@gmail.com"}],"_nodeVersion":"20.10.0","publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"packageManager":"pnpm@8.14.1","devDependencies":{"@bitget-ai/bitget-agent-sdk":"^3.0.0"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/bitget-agent-skill_3.3.1_1789893572028_0.9274541348592353"}}},"time":{"created":"2026-06-15T07:19:14.587Z","modified":"2026-09-20T08:39:32.296Z","1.2.0":"2026-06-15T07:19:14.849Z","3.0.0":"2026-06-24T04:49:10.852Z","3.1.0":"2026-09-02T07:54:31.425Z","3.2.0":"2026-09-02T10:54:16.924Z","3.2.1":"2026-09-02T12:52:57.272Z","3.3.0":"2026-09-17T09:07:48.119Z","3.3.1":"2026-09-20T08:39:32.106Z"},"license":"MIT","keywords":["bitget","bitget-skill","skill","claude-code","codex","openclaw","trading","crypto","ai-agent","natural-language"],"description":"Official Bitget AI skill — teaches Claude Code, Codex, and OpenClaw when and how to drive the Bitget Unified Trading Account (UTA / v3) API through the `bgc` CLI from natural language. Run `npx @bitget-ai/bitget-agent-skill` to deploy into your AI tool's ","maintainers":[{"name":"andrewyang_bgai","email":"useanjieyang@gmail.com"}],"readme":"<p align=\"center\">\n  <img src=\"assets/logo.png\" alt=\"Bitget Agent Skill — AI reasoning guide for Claude Code, Codex and terminal crypto trading\" width=\"120\" />\n</p>\n\n<h1 align=\"center\">bitget-agent-skill — Official Bitget AI Trading Skill</h1>\n\n<p align=\"center\">\n  <strong>Give Claude Code, Codex, and OpenClaw the judgment to understand your trading instructions — when to call Bitget, how to build the right command, and what to do when something goes wrong.</strong>\n</p>\n\n<p align=\"center\">\n  <a href=\"https://www.npmjs.com/package/@bitget-ai/bitget-agent-skill\"><img src=\"https://img.shields.io/npm/v/%40bitget-ai%2Fbitget-agent-skill.svg?style=flat-square&color=28a745\" alt=\"npm version\" /></a>\n  <a href=\"https://www.npmjs.com/package/@bitget-ai/bitget-agent-skill\"><img src=\"https://img.shields.io/npm/dm/%40bitget-ai%2Fbitget-agent-skill.svg?style=flat-square&color=026e00\" alt=\"npm downloads\" /></a>\n  <img src=\"https://img.shields.io/badge/Node.js-%E2%89%A520-026e00?style=flat-square\" alt=\"Node.js ≥ 20\" />\n  <a href=\"LICENSE\"><img src=\"https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square\" alt=\"MIT License\" /></a>\n</p>\n\n<p align=\"center\">\n  <a href=\"#quick-start\">Quick Start</a> ·\n  <a href=\"#what-changes-after-installing\">What Changes</a> ·\n  <a href=\"#why-a-skill-vs-just-installing-bgc\">Why a Skill</a> ·\n  <a href=\"#installation\">Installation</a> ·\n  <a href=\"#security\">Security</a> ·\n  <a href=\"#troubleshooting\">Troubleshooting</a> ·\n  <a href=\"#faq\">FAQ</a>\n</p>\n\n---\n\n> **Bitget Agent Hub** is Bitget's official open-source AI Agent ecosystem. This repository is `bitget-agent-skill` — the **skill surface** that teaches terminal AI agents when and how to correctly invoke Bitget tools. Ecosystem packages: [agent-skill](https://github.com/Bitget-AI/agent-skill) (this repo), [agent-cli](https://github.com/Bitget-AI/agent-cli), [agent-mcp](https://github.com/Bitget-AI/agent-mcp), [agent-sdk](https://github.com/Bitget-AI/agent-sdk), [bitget-signal](https://github.com/Bitget-AI/bitget-signal), [agent_hub](https://github.com/Bitget-AI/agent_hub).\n\n`@bitget-ai/bitget-agent-skill` is Bitget's official AI trading skill file, giving Claude Code, Codex, and OpenClaw the judgment to use Bitget tools correctly — knowing when to invoke Bitget, how to break your intent into the right multi-step operations, how to handle confirmation before write actions, and what to do when something goes wrong. Pure markdown, runtime-free.\n\n**Is this for you?** You're already using Claude Code, Codex, or OpenClaw and want it to actually understand your trading instructions — not just have the tool but lack the reasoning to use it — install this.\n\n---\n\n## Quick Start\n\nPaste the block below into your AI agent — it will handle the entire setup (requires Node.js 20+):\n\n```prompt\nPlease help me install the Bitget trading skill (requires Node.js 20+): 1. Run npx @bitget-ai/bitget-agent-skill --target all to deploy the skill files to my AI tool; 2. Run npm install -g @bitget-ai/bitget-agent-cli to install the bgc CLI globally. Tell me the result when done.\n```\n\n> Both must be installed together: the skill file is the AI's instruction manual, `bgc` is the execution tool — the skill teaches the AI when to call it and how to build commands, `bgc` actually makes the API requests. Without either one, the full flow is incomplete.\n\n**Verify it worked.** Ask your AI: *\"What trading modules does Bitget support?\"* If it returns the correct module list (market, trade, account, etc.), the skill is loaded and active.\n\n---\n\n## What Changes After Installing\n\n```mermaid\ngraph LR\n    A[You<br/>Natural Language] --> B[Claude Code / Codex<br/>with bitget-agent-skill]\n    B -->|Generates v3 Command| C[bgc CLI<br/>bitget-agent-cli]\n    C -->|HMAC-SHA256 Signed| D[Bitget REST API]\n    style B fill:#28a745,stroke:#333,stroke-width:2px,color:#fff\n```\n\nWithout the skill, `bgc` executes one command at a time. With the skill loaded, the AI can chain your intent into a sequence of operations across modules — check positions, evaluate conditions, place the order, handle the result — all in one go.\n\n- **Trigger recognition in English and Chinese**: whether you say \"buy BTC at market\" or「帮我买 BTC」, the AI recognizes it as a Bitget trading instruction and calls the right tool automatically — no need to specify command syntax\n- **v3 grammar and full reference**: the skill file includes the `bgc` v3 grammar (`bgc <tool> --action <name>`) and an auto-generated catalog of every operation — the AI knows which intent verb maps to which operation and how to fill in the parameters\n- **Multi-step workflow**: \"check my positions, and if I have no BTC open a 10x long\" — the AI queries first, reasons, then places the order, showing `[CAUTION]` before every write operation and waiting for your confirmation\n- **Paper trading and error handling**: tell the AI \"use demo account\" to switch to Bitget's sandbox automatically; when API errors occur, the AI knows whether to retry or surface the issue to you — instead of getting stuck\n\n---\n\n## Why a Skill (vs. just installing `bgc`)\n\nThe CLI alone gives the AI 14 intent verbs over the Unified Trading Account (89 operations) but no semantics — the assistant doesn't know **when** to reach for Bitget, **which** verb to use, or **how** to drive it safely.\n\nThe skill adds:\n\n- 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 (*\"查看我的持仓\"*).\n- The **v3 grammar** (`bgc <tool> --action <name> --<param> <value>`) and a **discover-first** workflow, plus a complete catalog of every verb, action, and parameter.\n- **Operational guidance** for write-safety (`--dry-run` / `--confirm`), close-direction rules, demo trading, error categories, and auth setup.\n\nResult: you say *\"buy 0.1 BTC at market on Bitget\"* and it actually works — the assistant composes `bgc order --action place --category SPOT --symbol BTCUSDT --side buy --orderType market --qty 0.1`, previews it with `--dry-run`, confirms with you, then runs it.\n\n---\n\n## What Ships in the Skill\n\n| File | Purpose |\n|---|---|\n| `SKILL.md` | Top-level skill definition with trigger phrases (English + Chinese) so the AI knows when to invoke, plus the v3 grammar, the 14-verb map, and the write-safety workflow. |\n| `references/commands.md` | Auto-generated static catalog — every domain, verb, action, and parameter (with enums + descriptions), from the SDK's own `discover` surface. |\n| `references/discover-guide.md` | How to navigate the live surface with `bgc discover` (the four rungs, search, `raw`). |\n| `references/trading-safety.md` | Close-direction rules (one-way/hedge), TP/SL, `qty` units, cancel-all, and withdrawal safety. |\n| `references/auth-setup.md` | How to create a Bitget API key and configure environment variables. |\n| `references/demo-trading.md` | How to use `--paper-trading` for safe rehearsal. |\n| `references/error-codes.md` | The v3 error payload, category-driven recovery, and the curated Bitget code table. |\n\n---\n\n## Installation\n\n### Step 1: Install the CLI\n\n```bash\nnpm install -g @bitget-ai/bitget-agent-cli\n```\n\n> Why `-g`? `bgc` is a persistent CLI your AI calls dozens of times per session — it must be on `$PATH`. This skill, by contrast, is a one-shot deploy: `npx` copies markdown into your AI tool's skill directory and exits. `npx` always pulls the latest version, so subsequent runs auto-upgrade you.\n\n### Step 2: Deploy the Skill File\n\n```bash\n# Default — Claude Code only\nnpx @bitget-ai/bitget-agent-skill\n\n# All supported AI tools\nnpx @bitget-ai/bitget-agent-skill --target all\n\n# Choose interactively\nnpx @bitget-ai/bitget-agent-skill --interactive\n```\n\n`--target all` deploys to Claude Code, Codex, and OpenClaw simultaneously.\n\n| Target | Skill location |\n|---|---|\n| Claude Code | `~/.claude/skills/bitget-agent-skill/` |\n| Codex | `~/.codex/skills/bitget-agent-skill/` |\n| OpenClaw | `~/.openclaw/skills/bitget-agent-skill/` |\n\n### Step 3: Set Up Credentials\n\n```bash\nexport BITGET_API_KEY=\"your-api-key\"\nexport BITGET_SECRET_KEY=\"your-secret-key\"\nexport BITGET_PASSPHRASE=\"your-passphrase\"\n```\n\n[Create an API key](https://www.bitget.com/api-doc/common/intro) if you don't have one. For demo trading, use a [Demo API Key](https://www.bitget.com/account/demo) instead:\n\n```bash\nexport BITGET_DEMO_API_KEY=\"your-demo-key\"\nexport BITGET_DEMO_SECRET_KEY=\"your-demo-secret\"\nexport BITGET_DEMO_PASSPHRASE=\"your-demo-passphrase\"\n```\n\n### Step 4: Restart and Verify\n\nClose and reopen your AI tool, then ask: *\"What Bitget trading capabilities do you have?\"*\n\n---\n\n## Related Tools\n\n| Tool | Relationship |\n|---|---|\n| [`@bitget-ai/bitget-agent-cli`](https://github.com/Bitget-AI/agent-cli) | Must be installed together: `bgc` is the execution tool, the skill file is the AI's instruction manual — neither works without the other |\n| [`@bitget-ai/bitget-agent-mcp`](https://github.com/Bitget-AI/agent-mcp) | Alternative for desktop AI (Claude Desktop, Cursor) — no `bgc` required |\n| [`@bitget-ai/bitget-signal`](https://github.com/Bitget-AI/bitget-signal) | Market analysis skills — no API key needed. This skill handles trading execution; `bitget-signal` handles market analysis. Complementary, can be installed side by side |\n\n---\n\n## Security\n\nThe skill files themselves:\n- No API key required — pure Markdown\n- No network access — no runtime process\n- No credential storage — keys are passed via environment variables to `bgc`\n\nAll actual API calls go through `bgc`, which provides:\n- Credentials live only in environment variables (no `.env` file parsing)\n- `--read-only` strips all write tools\n- `--paper-trading` switches to the demo environment\n- Local HMAC-SHA256 request signing\n\n---\n\n## Troubleshooting\n\n### \"Skill not recognized by AI\"\n\n**Cause:** Skill file not deployed or AI tool not restarted.\n\n**Fix:**\n1. Re-deploy: `npx @bitget-ai/bitget-agent-skill --target all`\n2. Restart your AI tool completely\n3. Verify: ask *\"What Bitget trading modules are available?\"*\n\n### \"AI has bgc but doesn't understand trading commands\"\n\n**Cause:** The skill file is missing — `bgc` is installed but the AI has no instruction manual.\n\n**Fix:** Deploy the skill and verify the files landed in the correct location:\n\n| AI Tool | Expected Location |\n|---|---|\n| Claude Code | `~/.claude/skills/bitget-agent-skill/SKILL.md` |\n| Codex | `~/.codex/skills/bitget-agent-skill/SKILL.md` |\n| OpenClaw | `~/.openclaw/skills/bitget-agent-skill/SKILL.md` |\n\n### \"bgc: command not found\"\n\n**Cause:** `bitget-agent-cli` not installed or not on `$PATH`.\n\n**Fix:** `npm install -g @bitget-ai/bitget-agent-cli` then restart your terminal.\n\n---\n\n## Updates\n\n```bash\n# Update all Bitget AI packages\nnpx @bitget-ai/bitget-agent-installer upgrade-all --target all\n\n# Or update just this skill\nnpx @bitget-ai/bitget-agent-skill@latest\n```\n\n---\n\n## FAQ\n\n**Will the AI automatically place orders after the skill is installed?**\nNo. For write operations like placing orders or transferring funds, the AI displays a `[CAUTION]` annotation and waits for your confirmation before executing.\n\n**How do I trade without real money?**\nTell your AI \"use demo account\" or \"use paper trading\" — it will switch to Bitget's Demo Trading environment automatically. Requires a [Demo API Key](https://www.bitget.com/account/demo).\n\n**What's the difference between this and the MCP server?**\nTerminal AI (Claude Code, Codex) → install `bitget-agent-skill` + `bgc`. Desktop AI (Claude Desktop, Cursor) → install `bitget-agent-mcp`. Both enable natural language Bitget trading — they adapt to different AI environments.\n\n**Does the skill file require an API key or network access?**\nNo. Pure Markdown files with no runtime process. All API calls happen at execution time through `bgc`.\n\n**Is it free?**\nMIT-licensed and free to use.\n\n---\n\n## Contributing\n\n- **Bug reports & feature requests:** [GitHub Issues](https://github.com/Bitget-AI/agent-skill/issues)\n- **Discussions:** [GitHub Discussions](https://github.com/Bitget-AI/agent-skill/discussions)\n- **Security concerns:** security@bitget.com\n\n---\n\n## License\n\n[MIT](LICENSE) — Free for personal and commercial use.\n\n---\n\n<sub>Part of the **[Bitget Agent Hub](https://github.com/Bitget-AI/agent_hub)** ecosystem — the official open-source AI Agent ecosystem from Bitget.<br/>\nTrading Stack · Skill Surface. ⚠️ Trading cryptocurrency carries risk; you are responsible for any orders your AI agent places. Use demo account to practice safely before trading with real funds.<br/>\nFoundation: [agent-sdk](https://github.com/Bitget-AI/agent-sdk) · Execution: [agent-cli](https://github.com/Bitget-AI/agent-cli) · Desktop: [agent-mcp](https://github.com/Bitget-AI/agent-mcp) · Market signals: [bitget-signal](https://github.com/Bitget-AI/bitget-signal)</sub>\n","readmeFilename":"README.md"}