okx-cex-skill-mp

$28

• Install okx CLI:

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

• Configure API credentials (required for marketplace access):

okx config init

Installation Strategy

When the user wants to install a skill, follow this order strictly:

• **Always try okx skill add <name> first** — this downloads the skill and installs it to all detected agents (Claude Code, OpenClaw, Cursor, Windsurf, etc.) in one step.

• **Only if add fails**, fall back to manual download:

• Tell the user why add failed (network error, npx unavailable, permission issue, etc.)

• Offer okx skill download <name> --dir <path> as an alternative

• Guide the user to manually unzip and place files in their agent's skill directory

Never skip add and go straight to download unless add has already failed.

Command Reference

#

Command

Description

1

okx skill search <keyword>

Search marketplace by keyword

2

okx skill search --categories <id>

Filter skills by category

3

okx skill categories

List all available categories

4

okx skill add <name>

Download + install to all detected agents

5

okx skill download <name> [--dir <path>] [--format zip|skill]

Download package (default format: zip)

6

okx skill list

List locally installed skills

7

okx skill check <name>

Check if a newer version is available

8

okx skill remove <name>

Uninstall a skill

Add --json to any command for raw JSON output. Add --env to wrap the output as {"env", "profile", "data"}.

Commands in Detail

1. Search Skills

okx skill search grid

Output:

NAME              VERSION   DESCRIPTION

  grid-premium      1.2.0     Enhanced grid trading with technical analysis

  grid-dca          1.0.0     Grid strategy combined with DCA

2 skills found (page 1/1). Use `okx skill add <name>` to install.

Search with category filter:

okx skill search --categories trading-strategy

Pagination (response includes totalPage for total pages):

okx skill search grid --page 2 --limit 5

# Output: "3 skills found (page 2/4). Use `okx skill add <name>` to install."

2. Browse Categories

okx skill categories

Output:

ID                  NAME

  trading-strategy    Trading Strategy

  risk-management     Risk Management

  analysis            Market Analysis

3. Install a Skill

okx skill add grid-premium

Output:

Downloading grid-premium...

Installing to detected agents...

✓ Skill "grid-premium" v1.2.0 installed

What happens under the hood:

• Downloads skill zip from OKX marketplace API

• Extracts and validates the package (checks SKILL.md exists, reads metadata)

• Runs npx skills add to install to all locally detected agents

• Records the installation in ~/.okx/skills/registry.json

4. Download Only (No Install)

When add fails or the user wants the raw package:

okx skill download grid-premium --dir ~/Downloads/

Output:

✓ Downloaded grid-premium.zip

  Path: /Users/me/Downloads/grid-premium.zip

To download as .skill format (for agents that recognize the extension):

okx skill download grid-premium --dir ~/Downloads/ --format skill

The zip contains:

• SKILL.md — the skill's main instruction file

• _meta.json — metadata (name, version, title, description)

• reference/ — optional supporting documents

5. List Installed Skills

okx skill list

Output:

NAME              VERSION   INSTALLED AT

  grid-premium      1.2.0     2026-03-25 10:30:00

  dca-smart         2.1.0     2026-03-20 14:00:00

2 skills installed.

6. Check for Updates

okx skill check grid-premium

Output:

grid-premium: installed v1.0.0 → latest v1.2.0 (update available)

  Use `okx skill add grid-premium` to update.

To update, simply run okx skill add <name> again — it overwrites the previous version.

7. Remove a Skill

okx skill remove grid-premium

Output:

✓ Skill "grid-premium" removed

MCP Tools (Alternative)

When the CLI is unavailable (e.g., Claude Desktop without terminal access), the same marketplace functionality is available via MCP tools:

MCP Tool

Equivalent CLI

Description

skills_search

okx skill search

Search by keyword/category. Response includes totalPage for pagination.

skills_get_categories

okx skill categories

List categories

skills_download

okx skill download

Download package to directory (default format: .skill; pass format: "zip" for zip)

Note: MCP tools only support search and download. The full install flow (add) requires CLI access.

Error Handling

Error

Meaning

Action

70002 SKILL_DELETED

Skill has been removed from marketplace

Choose a different skill

70003 NO_APPROVED_VERSION

No approved version available

Skill is pending review, try later

70030 VERSION_NOT_APPROVED

Version not yet approved for download

Wait for review or use an older version

50111/50112/50113

Authentication error

Run okx config init to set up credentials

npx skills add fails

npx not available or network issue

Use okx skill download instead, then manually install