Skills#

在"能检索文档"之上，Skill 用来把知识和流程封装成稳定能力：让 Agent 不只会回答"文档怎么写"，还会做"该选哪个 endpoint、下一步怎么走、遇到错误怎么处理"。

为什么 AI Agent 需要 OnchainOS Trade Skills#

覆盖 Swap 完整链路：支持的链 → 流动性来源 → Approve → 报价 → 构造交易 → 签名 → 广播。
提供意图路由：把用户指令（"把 0.1 ETH 换成 USDC"、"帮我查 500 USDT 换 SOL 的报价"、"Arbitrum 上有哪些可用的 DEX"）映射到正确 API 与第一步动作。
AI agent 即插即用：为 AI Agent 直接封装 OKX DEX API 结构化的能力模块。每个 Skill 对应一项具体能力（如生成交易执行数据、获取报价、查询代币信息等），并定义清晰的输入/输出 schema，可无缝集成至任意 Agent 架构。

将 Skill 文件添加至 Agent 的 skill 目录，Agent 将自动加载意图路由、各链执行 Playbook、签名模式及错误处理逻辑。

npx skills add okx/onchainos-skills

将 Skills 导入到 Agent 后，Agent 可响应以下自然语言指令：

支持哪些链进行 DEX 兑换？
# 调用 dex-aggregator-supported-chains

X-layer 上支持哪些 DEX？
# 调用 dex-liquidity

在 X-layer 上，1 ETH 可以兑换多少 USDC？
# 调用 dex-quote

在兑换前我需要先授权 USDT，请生成对应的 calldata
# 调用 dex-approve-transaction

构建一笔兑换交易：100 USDT → ETH，钱包地址 0xd8dA...，滑点 0.5%
# 调用 dex-swap

在 Solana 上将 2 SOL 兑换为 USDC，钱包地址 DYw8...
# 调用 dex-solana-swap-instruction