agent-skills
Plug-and-play AI agent skills for OKX — letting any LLM agent trade, manage portfolios, query live market data, and run grid/DCA bots through a single okx CLI, no API wiring required.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/okx/agent-skills with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/okx/agent-skills'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/okx-agent-skills)HTML
<a href="/listings/okx-agent-skills"><img src="/api/listings/okx-agent-skills/badge.svg" alt="findsafeskills safety rating" /></a>Install
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 77 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # 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`](https://www.npmjs.com/package/@okx_ai/okx-trade-cli) CLI.
- ## Skills
- | Skill | Description | Auth Required |
- |-------|-------------|:-------------:|
- | [`okx-cex-auth`](skills/okx-cex-auth/SKILL.md) | 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`](skills/okx-cex-market/SKILL.md) | 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`](skills/okx-cex-trade/SKILL.md) | Order management: spot, perpetual swap, dated futures, options, event contracts. TP/SL, trailing stop, iceberg, TWAP, conditional/OCO algo orders. | Yes |
- | [`okx-cex-portfolio`](skills/okx-cex-portfolio/SKILL.md) | Account operations: balances, positions, P&L, trading fees, account config, fund transfers, position-mode switching. | Yes |
- | [`okx-cex-bot`](skills/okx-cex-bot/SKILL.md) | 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`](skills/okx-cex-earn/SKILL.md) | Simple Earn (flexible / fixed-term / lending), Flash Earn, On-chain Earn (staking / DeFi), Dual Investment (DCD / 双币赢), AutoEarn (自动赚币). | Yes |
- | [`okx-cex-smartmoney`](skills/okx-cex-smartmoney/SKILL.md) | Smart-money analytics: leaderboard traders, position tracking, trade records, consensus signals, signal history. | Yes |
- | [`okx-sentiment-tracker`](skills/okx-sentiment-tracker/SKILL.md) | Crypto news, coin-level sentiment analysis, trending coins, social buzz, market mood. | Yes |
- | [`okx-cex-skill-mp`](skills/okx-cex-skill-mp/SKILL.md) | OKX Skills Marketplace: search, browse, install, update, remove skill packs. | Yes |
- ## Requirements
- - [`okx` CLI](https://www.npmjs.com/package/@okx_ai/okx-trade-cli) installed:
- ```bash
- 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:
- ```bash
- okx config init
- ```
- ## Skill Format
- Each skill is a Markdown file with a YAML frontmatter header:
- ```yaml
- ---
- 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/`](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](CONTRIBUTING.md) for how to add or improve skills, and [REVIEWING.md](REVIEWING.md) for review criteria.
- ## Security
- Report security issues per [SECURITY.md](SECURITY.md).
- ## License
- MIT — see [LICENSE](LICENSE).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.