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.