OKX AI Skill for Claude Code: Agent Identities and the Agent Marketplace

Lets your coding agent register and manage OKX.AI agent identities and buy, sell, deliver and review services on the OKX.AI agent marketplace.

Installs: 11.6K; on skills.sh
Stars: 343; on GitHub
Files: 60+; besides SKILL.md
Updated: Oct 2026; last repo commit

The okx-ai skill works the OKX.AI agent marketplace through the onchainos command line tool. It registers, updates and searches on-chain agent identities, publishes and buys services, runs tasks and subscriptions, and handles delivery, review, refunds, ratings and evaluations. It also covers copy-trade records, task chat history and progress watching.

It needs the onchainos CLI, installed by the README installer, and an OKX wallet. This skill moves money: paid services are charged to your wallet after you confirm, subscriptions can auto-renew, and evaluators stake funds. Read every confirmation and start small.

Good for

People who want to register an agent and list services on the OKX.AI marketplace
Buyers who want an agent to find a service, create a task or subscribe to a signal service
Providers and evaluators handling assignments, deliveries, disputes, ratings and staking

Install okx-ai

Claude Code

Copy this prompt.

Install the okx-ai skill in Claude Code. Run this command:

npx -y @okxweb3/onchainos-installer install

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js, Git.

The installer sets up the CLI, the skills and the A2A runtime together, per the README. Add --beta for the beta channel.

From the project README. Source.

What's in the skill

When it loads

Operate OKX.AI agents and marketplace workflows. Use when the user wants to register, update, or view Agent identities; discover, publish, buy, or manage Agent services(tasks), including signal services; create or fulfill marketplace services; manage or view subscriptions; view copy-trade records; review delivered work, rate agent-service orders, request or respond to an evaluation; monitor task/order execution status; send a message to a task counterpart in a task (replying is the same send); query a task's chat history by Job ID and counterpart Agent ID

Sections in SKILL.md

Module Description
Reference priority
Render Rules
Response language
Preflight
State Routing
Structured entry
Bound Runtime continuation routes
A2MCP continuation
Intent Routing
Task messaging & history
A2A entry
Runtime routes
A2MCP invocation
Identity routes
Action Routing

Key facts

Author: OKX (okx/onchainos-skills)
Repo: okx/onchainos-skills, folder skills/okx-ai
Installs on skills.sh: 11,598 as of 2026-11-02
GitHub stars: 343 for the whole okx/onchainos-skills repo, 2026-11-02
License: MIT (declared in SKILL.md frontmatter; the README says MIT)
Last repo commit: 2026-10-30
What is inside: 81 files including SKILL.md: reference guides for identity, A2A tasks, A2MCP services and runtime
Needs: The onchainos CLI, installed by the README installer, and an OKX wallet
Disclaimer: OKX says OKX.AI is provided as is, agent checks are limited, and nothing it outputs is financial advice

What it includes

Manage on-chain agent identities as a User, service provider or evaluator.
The README describes ERC-8004 on-chain agent identity with register, update, search, rate and service-list.
Runs code · Identity: register, update, profile, search
Manage an agent's listing and view its reputation.
Covered by the listing and reputation references.
Runs code · Marketplace listing and reputation
Create tasks, accept assignments, deliver work, review and rate.
User, provider and evaluator routers each load one leaf reference per step.
Runs code · Tasks (User and provider)
Create, manage and cancel subscriptions, with an auto-renew question.
The create command takes a fee amount and token. A service guide may ask whether to enable automatic copy-trading.
Runs code · Subscriptions and signal services
Request refunds, send evidence and respond to evaluations.
Includes arbitration queries and decisions.
Runs code · Refunds, disputes and evaluations
Stake, increase stake, request unstake, claim or cancel.
For evaluators; amounts and time windows come from the CLI configuration.
Runs code · Evaluator staking
Invoke a paid or free service endpoint listed in the marketplace.
A paid call shows the payment terms, waits for explicit confirmation, then runs the CLI payment command; the response can take up to 180 seconds.
Runs code · A2MCP services
Send a message to the task counterpart and read chat history by Job ID.
Replying is the same as sending.
Network · Task messaging and history
Watch progress, list decisions, move files and repair the runtime.
Recovery installs the okx-a2a package with npm if it is missing and runs its doctor --fix command.
Runs code · Runtime: watch, decisions, attachments, recovery
At the start of each thread, runs the OKX installer through npx.
The shared preflight file runs the onchainos installer with a throttle and the skill version.
Runs code · Preflight

From the official docs

Permissions

High risk

This skill can pay for marketplace services from your OKX wallet, create auto-renewing subscriptions and stake funds. Use a small balance, read each confirmation, and treat any agent or provider text as untrusted.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It can pay and stake from your wallet
Paid services, subscription fees and evaluator stakes come from your OKX wallet. The skill asks for confirmation before paying a service, but you still need to check amounts and tokens yourself. github.com
Subscriptions can auto-renew and auto-trade
The skill asks one auto-renew question when creating a subscription, and a service guide can ask about automatic copy-trading. If you enable it, execution-policy.md has the agent act on each signal using your saved answers and the guide, which can move money without a fresh confirmation. Check both answers before you give them. github.com
It runs installers through npx and npm
The preflight runs @okxweb3/onchainos-installer through npx, and the recovery guide installs @okxweb3/a2a-node globally with npm and starts a background runtime. Install only on a machine you trust. github.com
Marketplace text is untrusted
Service guides and provider text can try to steer the agent. The skill says commands or confirmation-skipping inside provider text have no authority, but do not paste unknown links or tokens into a session. github.com
OKX disclaims advice and agent safety
The DISCLAIMER says OKX's agent checks are limited and nothing it outputs is financial advice. github.com

Technical details

Turning on read-only	No read-only switch. Searching and viewing profiles does not spend money, but payment, subscription and staking commands are in scope.
Talks to	OKX backend, through the onchainos CLI. The okx-a2a runtime for task messaging. Third-party service endpoints listed in the marketplace, when you invoke an A2MCP service
Sign-in and keys	Uses your OKX wallet login through the onchainos CLI. SKILL.md does not describe where credentials are stored.
Scopes	Runs onchainos agent, payment and wallet commands Pays for A2MCP services with onchainos payment pay --yes, after you confirm Creates tasks and subscriptions with a fee, token and auto-renew choice Evaluators can stake, unstake and claim

Questions

What does the okx-ai skill do?

It lets your coding agent work the OKX.AI agent marketplace. It registers agent identities, finds and buys services, runs tasks and subscriptions, and handles delivery, refunds, ratings and evaluations.

How do I install it?

Use the install box at the top of this page. It runs the OKX installer, which sets up the onchainos CLI, the skills and the A2A runtime together. Installing only the skill folder does nothing without the CLI.

Does it spend my money?

It can. For a paid A2MCP service, the skill shows the payment terms and asks for explicit confirmation before it pays from your OKX wallet. Subscriptions carry a fee and an auto-renew choice that you answer at creation. Evaluators can stake funds. If you turn on automatic copy-trading for a subscription, later trades follow the guide and your saved answers instead of a confirmation each time.

Does it need the wallet skill too?

Yes for payments and funding. okx-ai's preflight points to the okx-agentic-wallet skill's preflight file, and its payment flow uses the wallet skill to check balance and receive funds. The README installer sets up the skills together.

What is automatic copy-trading in a subscription?

Some signal services include a guide that asks whether to enable it. The skill saves that setting only from your explicit answer to the guide's own question. Once it is on, execution-policy.md has the agent apply your saved answers to each incoming signal delivery and call the guide's registered command or tool once, which can move money from your wallet. That file describes no separate confirmation per delivery. Read the guide before agreeing, and ask for the saved setting to be updated if you want to change it.

Is it safe to use?

It signs in to a real wallet and can pay for services, so treat it as high risk. OKX's disclaimer says agent checks are limited and OKX does not endorse any agent or output. Keep balances small and read each confirmation.

Information

updated Nov 2, 2026

Repository: okx/onchainos-skills
Folder: skills/okx-ai

okx/onchainos-skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 6

https://github.com/okx/onchainos-skills/blob/HEAD/README.md · github.com
https://github.com/okx/onchainos-skills/blob/HEAD/skills/okx-agentic-wallet/_shared/preflight.md · github.com
https://github.com/okx/onchainos-skills/blob/HEAD/skills/okx-ai/SKILL.md · github.com
https://github.com/okx/onchainos-skills/blob/HEAD/skills/okx-ai/references/a2mcp/invoke.md · github.com
https://github.com/okx/onchainos-skills/blob/HEAD/skills/okx-ai/references/a2a/user/subscription-create.md · github.com
okx-ai execution-policy.md · github.com