agent-skills

A collection of AI agent skills for OKX exchange operations. Each skill is a self-contained Markdown file with YAML frontmatter that tells an AI agent when to activate and how to execute tasks via the okx CLI.

Skills

Skill	Description	Auth Required
okx-cex-auth	OAuth login / API-key setup, plus install/update/remove of the okx-auth helper binary. Activated on first run or whenever a command returns 401 / session expired.	Setup
okx-cex-market	Public market data: prices, tickers, order books, candles, funding rates, open interest, instruments, stock tokens, metals/forex, and 70+ technical indicators (RSI, MACD, EMA, Bollinger, KDJ, SuperTrend, AHR999, BTC rainbow…).	No
okx-cex-trade	Order management: spot, perpetual swap, dated futures, options, event contracts. TP/SL, trailing stop, iceberg, TWAP, conditional/OCO algo orders.	Yes
okx-cex-portfolio	Account operations: balances, positions, P&L, trading fees, account config, fund transfers, position-mode switching.	Yes
okx-cex-bot	Grid bots (spot / USDT-margined / coin-margined contract) and DCA Martingale bots (Spot DCA / Contract DCA). Create, amend, stop, monitor, AI-recommended parameters.	Yes
okx-cex-earn	Simple Earn (flexible / fixed-term / lending), Flash Earn, On-chain Earn (staking / DeFi), Dual Investment (DCD / 双币赢), AutoEarn (自动赚币).	Yes
okx-cex-smartmoney	Smart-money analytics: leaderboard traders, position tracking, trade records, consensus signals, signal history.	Yes
okx-sentiment-tracker	Crypto news, coin-level sentiment analysis, trending coins, social buzz, market mood.	Yes
okx-cex-skill-mp	OKX Skills Marketplace: search, browse, install, update, remove skill packs.	Yes

Requirements

• okx CLI installed:

  npm install -g @okx_ai/okx-trade-cli

• For authenticated skills, configure credentials by either:
  • OAuth — run the okx-cex-auth skill (recommended for end users)
  • API key — write ~/.okx/config.toml directly:

    okx config init

Skill Format

Each skill is a Markdown file with a YAML frontmatter header:

---
name: skill-name
description: "Trigger description for the AI agent routing system."
license: MIT
metadata:
  author: okx
  version: "1.3.3"
  homepage: "https://www.okx.com"
  agent:
    requires:
      bins: ["okx"]
    install:
      - id: npm
        kind: node
        package: "@okx_ai/okx-trade-cli@1.3.3"
        bins: ["okx"]
        label: "Install okx CLI (npm)"
---

The description field drives agent routing — it enumerates natural-language phrases and scenarios that should trigger the skill. Skills with a references/ subdirectory use {baseDir} as a runtime-resolved path pointing to the skill's own directory.

Description length limit: Codex CLI enforces a 1024-character maximum on this field. Target ≤ 900 characters to leave headroom for future trigger additions.

Skills may share helpers via the top-level skills/_shared/ directory (e.g. preflight.md for credential / profile checks).

Usage

Skills are loaded by AI coding agents — Claude Code, Cursor, Windsurf, Codex CLI, and any Skills-Plugin-compatible client — to provide contextual instructions for CLI-based OKX operations. The agent reads the skill document at activation time and follows the command examples and operation flows described within.

Contributing

See CONTRIBUTING.md for how to add or improve skills, and REVIEWING.md for review criteria.

Security

Report security issues per SECURITY.md.

License

MIT — see LICENSE.