skills/okx-agent-chat/SKILL.md
Routing stub — any a2a-agent-chat envelope / agent-task system message is handled by `okx-agent-task`. For missing or uninitialized OKX A2A communication runtime/plugin, read `skills/okx-agent-chat/ensure-okx-a2a-communication-ready.md`.
npx skillsauth add okx/onchainos-skills okx-agent-chatInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
🛑 This is a routing stub, not a flow. Any message you landed here for is part of the agent task system (User ↔ ASP ↔ Evaluator).
Read
skills/okx-agent-task/SKILL.mdnow — that file has the routing table, role files (user-sub-playbook.md/asp.md/evaluator.md), and the full state-machine handling.Do not try to handle the message from this directory — there are no flows here.
This directory does own one bootstrap helper: ensure-okx-a2a-communication-ready.md.
Read and execute that helper when the communication environment appears unavailable or uninitialized, including these cases:
okx-a2a is missing, or the non-beta @okxweb3/a2a-node package has not been checked against latest.okx-a2a daemon start, switch-runtime, agent refresh, setup, session create, session send, xmtp-send, or user notify fails with a communication/runtime/plugin initialization error.Do not duplicate the install commands here. The helper owns the Node.js check, okx-a2a install/update policy, daemon start/restart policy, runtime switch, agent communication refresh, and final okx-a2a setup --json contract.
You likely matched on one of these inbound shapes:
msgType: "a2a-agent-chat" envelope with a non-empty jobId{agentId, message: {source: "system", event, jobId, ...}} chain-event notificationFor all of them, the correct entry is skills/okx-agent-task/SKILL.md. After reading SKILL.md:
sender.role (a2a-agent-chat) or query agent get --agent-ids <agentId> (system envelope) to figure out your own roleuser-sub-playbook.md / asp.md / evaluator.md accordinglyInternal helpers:
ensure-okx-a2a-communication-ready.md — ensure OKX A2A plugin install and communication initialization through okx-a2a: install or update to @okxweb3/a2a-node@latest unless the current package is beta, ensure okx-a2a daemon is running, avoid restarting an already-running daemon when the package did not change, run okx-a2a switch-runtime --json, run okx-a2a agent refresh --json, then run okx-a2a setup --json.file-attachment.md — file attachment payload format referenceThese do not define task-system flow. For flow, always defer to okx-agent-task/SKILL.md; for communication readiness or missing-plugin recovery, use ensure-okx-a2a-communication-ready.md.
testing
OKX-aggregated DeFi (no specific DApp named) — product discovery, deposit/withdraw/claim execution, AND positions viewing. **If the user names ANY third-party protocol/DApp (Aave, Lido, PancakeSwap, Uniswap, Curve, Compound, Morpho, Pendle, Kamino, Raydium, Hyperliquid, Polymarket, …), route to okx-dapp-discovery — NOT here, even for 'show my Aave positions'.** INVEST triggers: 'invest in DeFi', 'earn yield', 'find best APY', 'deposit/stake for yield', 'search DeFi products', 'redeem/withdraw position', 'claim DeFi rewards', 'borrow against asset', 'repay loan', 'add/remove CLMM liquidity', 'APY/TVL history', 'depth chart', yield farming, lending, staking, liquidity pools. PORTFOLIO triggers: 'check my DeFi positions', 'view DeFi holdings/portfolio', 'my staking/lending positions', 'DeFi balance', 'DeFi 持仓', '我的DeFi资产'. Do NOT use for: DEX swaps (okx-agentic-wallet), token prices (okx-dex-market), wallet token balances (okx-agentic-wallet).
testing
ERC-8004 Agent identity: 注册/更新/上架/下架/搜索agent, register/update/activate/deactivate/search — User/ASP/Evaluator(买家/卖家/仲裁者); 我的agent/ASP, 找做X的ASP/agent有什么服务/endpoint怎么填/查口碑/传头像. + Task Marketplace: 发布/创建任务/接单/协商/验收/deliver/dispute/仲裁/拒绝/stake/unstake/change provider/change budget/修改卖家/修改预算/我的任务/my tasks/what am I working on/我的订阅/订阅列表/订阅详情/my subscriptions/what am I subscribed to/AI服务订阅(view AI-service subscriptions, buyer & ASP)/关闭/取消任务/决策列表/decision list/指定服务商/browse marketplace. + task watch: 监听任务进展/历史消息/未读消息/未决策/outstanding decisions. + okx-a2a missing/uninitialized. Match by meaning. MUST ACTIVATE on inbound envelopes: (1) {agentId, message:{source:"system", event, jobId,...}} system event; (2) {msgType:"a2a-agent-chat", jobId, sender:{role},...} agent-to-agent task chat (sender.role = COUNTERPARTY, not you); (3) literal "Read the okx-ai skill" (or legacy "Read the okx-agent-task skill") in the envelope.
testing
Onchain OS onboarding & guide hub — the single entry for first-time, 'what is this / how do I use it', OKX.AI, and customer-support intents; classifies the intent and routes to the right sub-flow via its Intent Routing table. Covers: (1) Onchain OS onboarding + welcome banner — 'what is onchainos', 'what is onchain os', 'what can it do', 'what can onchainos do', 'what does onchainos do', 'how do I use this', 'how do I play', 'how to use onchainos', 'how to play onchainos', 'how does onchainos work', 'how do I start', 'getting started', 'tutorial', 'onboarding', 'first time', 'I just installed', 'now what', 'what do I do now', 'where do I start', 'who are you', 'what are you', 'introduce onchainos', 'tell me about onchainos', 'I'm new'; (2) OKX.AI intro & role-registration routing (the Agent economic system — roles User / ASP / Evaluator) — 'what is OKX.AI', 'OKX.AI 是什么', 'how to use OKX.AI', 'OKX.AI 快速开始', and any spelling / spacing / casing / typo variant (OKXAI, okx ai, okx-ai, lowercase okx.ai, 啥是okxai); (3) customer support / Help Center — 'contact support', 'talk to a human', 'customer service', 'file a complaint', 'give feedback', 'report a bug / system error', 'help center', 'FAQ', 'user guide', 'something is broken'. NOT for: direct on-chain actions (swap / wallet / balance / token) or Agent task lifecycle (publish / accept / deliver / dispute) — those have their own skills.
testing
List OKX Agentic Wallet exclusive trading competitions, register users for contests, track participation and leaderboard rankings, and claim won rewards. Use when users want to list available trading competitions or trading cups, view competition rules / prize pool / total prizes, register or sign up or enroll or join a contest, check the leaderboard (who is winning) or their own rank (am I in the prize zone, what is my place), ask did I win or query participation / claim status, claim won rewards or prizes from completed competitions, see which wallet account they registered with, or submit Telegram / WeChat / Email / Twitter contact for prize delivery to top-tier winners.