# @bitget-ai/getagent-skill

> Install the official GetAgent Agent Skill for Playbook authoring.

Latest version **0.6.4** (published 2026-09-02) · Proprietary license · 0 weekly downloads

## Install

```sh
npm install @bitget-ai/getagent-skill
pnpm add @bitget-ai/getagent-skill
yarn add @bitget-ai/getagent-skill
bun add @bitget-ai/getagent-skill
```

Provides the command `getagent-skill`.

## Health

**Score 55/100 (C)** — status: active.

Positive: no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no types; no esm support; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.6.4 |
| Published | 2026-09-02 |
| First published | 2026-06-02 |
| Weekly downloads | 0 |
| License | Proprietary |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=18 |
| Dependencies | 0 |
| Unpacked size | 1.2 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Maintainers | andrewyang_bgai |
| Keywords | getagent, agent-skills, claude-code, cursor, codex, trading, playbook, backtesting |

## Links

- npm: https://www.npmjs.com/package/@bitget-ai/getagent-skill
- Repository: https://github.com/Bitget-AI/getagent-skill
- Homepage: https://github.com/Bitget-AI/getagent-skill#readme
- Issues: https://github.com/Bitget-AI/getagent-skill/issues
- npm.io page: https://npm.io/package/@bitget-ai/getagent-skill

## Alternatives

- [duck](https://npm.io/package/duck.md) — 4.2M weekly downloads
- [ava](https://npm.io/package/ava.md) — 560.2K weekly downloads
- [storybook-addon-module-mock](https://npm.io/package/storybook-addon-module-mock.md) — 71.7K weekly downloads
- [@ethereum-waffle/mock-contract](https://npm.io/package/@ethereum-waffle/mock-contract.md) — 40.0K weekly downloads
- [aws-elasticsearch-connector](https://npm.io/package/aws-elasticsearch-connector.md) — 37.4K weekly downloads

## Recent versions

- 0.6.4 (latest) — 2026-09-02
- 0.6.3 — 2026-08-27
- 0.6.2 — 2026-08-26
- 0.6.1 — 2026-08-24
- 0.6.0 — 2026-08-24
- 0.5.3 — 2026-08-20
- 0.5.2 — 2026-08-17
- 0.5.1 — 2026-08-17
- 0.5.0 — 2026-07-10
- 0.3.5 — 2026-06-30
- 0.3.4 — 2026-06-26
- 0.3.3 — 2026-06-17
- 0.3.2 — 2026-06-16
- 0.3.1 — 2026-06-16
- 0.3.0 — 2026-06-13
- … 2 more at https://npm.io/package/@bitget-ai/getagent-skill/versions

## README

# GetAgent Skill

> Author, backtest, and ship algorithmic crypto trading strategies on Bitget — through your AI coding agent.

[![npm version](https://img.shields.io/npm/v/@bitget-ai/getagent-skill.svg)](https://www.npmjs.com/package/@bitget-ai/getagent-skill)

GetAgent is Bitget's managed platform for AI-authored quantitative trading
strategies (Playbooks). This Agent Skill teaches your AI coding agent —
Claude Code, Cursor, or Codex — the full end-to-end GetAgent workflow:
writing strategy code in Python, validating it locally, uploading to the
managed sandbox, running historical backtests, publishing accepted
versions, and opening subscriptions.

## Quick Start

```bash
npx @bitget-ai/getagent-skill install --client claude
```

Then open Claude Code and ask:

> Build me a momentum strategy on BTC perp using EMA crossover and run a 30-day backtest.

The agent scaffolds a Playbook package, writes the strategy code, validates
it locally, uploads it to GetAgent Cloud, runs the backtest in the managed
sandbox, and shows you results — all without leaving the chat.

For other agents:

```bash
npx @bitget-ai/getagent-skill install --client cursor   # installs to ~/.cursor/skills/getagent
npx @bitget-ai/getagent-skill install --client codex    # installs to ~/.codex/skills/getagent
npx @bitget-ai/getagent-skill install --client all      # all three
```

The installer checks npm for a newer `@bitget-ai/getagent-skill` release in
interactive terminals. If an update is available, it asks whether to upgrade
before installing. To upgrade manually:

```bash
npx @bitget-ai/getagent-skill upgrade --client all
```

Set `GETAGENT_SKILL_NO_UPDATE_CHECK=1` or pass `--no-update-check` to skip the
automatic update check.

## How It Works

GetAgent splits authoring from execution:

- **Local (your machine, via this skill)** — write strategy Python, validate
  package structure, call the Playbook control-plane API through your agent.
- **Managed sandbox (GetAgent Cloud)** — the real `getagent.data`,
  `getagent.trade`, `getagent.llm`, and `getagent.backtest` modules execute
  with live market data and brokered exchange access.

You write code against the documented `getagent.*` API. When your agent
uploads the Playbook, GetAgent provisions a matching sandbox image and runs
the code there, not on your laptop. API keys, market data licensing, and
execution risk all stay inside the managed boundary.

A typical Playbook entry point looks like:

```python
from getagent import backtest, data, runtime

def run() -> None:
    # kline drops the currently-forming candle by default (closed_only=True),
    # so the last bar is always closed and stable.
    bars = data.crypto.futures.kline(symbol="BTCUSDT", interval="1h", limit=1000)
    frame = backtest.prepare_frame(bars)
    # ... your strategy emits signals via runtime ...
    runtime.emit_signal(action="buy", symbol="BTCUSDT", confidence=0.8)
```

A complete reference strategy lives in
[`skills/getagent/examples/btc-ema-cross-demo/`](skills/getagent/examples/btc-ema-cross-demo/).

## What's In The Skill

- **`SKILL.md`** — agent instructions, conversation templates, control flow
- **`references/`** — package schema, API reference, sandbox runtime, and authoring docs
- **`scripts/validate.py`** — static package validator (runs locally before upload)
- **`examples/`** — runnable example Playbooks

## Requirements

- **Node.js 18+** to install the skill via npm
- **Python 3.11+** for local static validation
- A **GetAgent Cloud** account and API credentials — your agent will guide
  authentication on first use

## Versioning

This package follows [Semantic Versioning](https://semver.org/):

- **Patch** (`v0.1.x`) — bug fixes, doc updates, reference regen with no API change
- **Minor** (`v0.x.0`) — additive: new endpoints, new examples, new authoring surfaces
- **Major** (`vX.0.0`) — breaking changes to the documented authoring API

If the skill documents an API, the sandbox image GetAgent Cloud provisions
for your Playbook contains that API.

## License

Proprietary. See [`package.json`](package.json).

## Support

- Issues: https://github.com/Bitget-AI/getagent-skill/issues
- Skill content: open `~/.claude/skills/getagent/SKILL.md` (or the matching
  path for cursor/codex) after install

---
_Source: https://npm.io/package/@bitget-ai/getagent-skill · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._