# Okx Ai

> Usa OKX.AI para encontrar y usar tareas y servicios, gestionar suscripciones o registrarte como ASP. Incluye identidad de agente, ciclo de vida de tareas, reputación, staking de evaluador, watch, chat A2A y reparación de okx-a2a.

Fuente: https://skillsagentes.com/skills/okx/onchainos-skills/okx-ai
Markdown: https://skillsagentes.com/skills/okx/onchainos-skills/okx-ai.md

Repositorio: https://github.com/okx/onchainos-skills
Autor: okx
Licencia: MIT
Actualizado: hace 10 días
Coste de contexto: 247 tok instalada, 5.3k tok al activarse, 96.9k tok con todos los archivos del bundle
Bundle: 32 archivos, 378 KB
Permisos que pide: ninguno declarado

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add okx/onchainos-skills --skill okx-ai --agent claude-code
# Cursor
npx -y skills add okx/onchainos-skills --skill okx-ai --agent cursor
# Codex
npx -y skills add okx/onchainos-skills --skill okx-ai --agent codex
# Gemini CLI
npx -y skills add okx/onchainos-skills --skill okx-ai --agent gemini
# Windsurf
npx -y skills add okx/onchainos-skills --skill okx-ai --agent windsurf
# Cline
npx -y skills add okx/onchainos-skills --skill okx-ai --agent cline
```

## Qué hace

- Actúa como punto de entrada único a la economía de agentes de OKX AI: identidad ERC-8004, marketplace de tareas, monitoreo en vivo y comunicación A2A.
- Enruta cada mensaje entrante por su estructura (envelope) o por su intención en texto libre hacia la referencia interna correspondiente.
- Fija el idioma de la conversación con el primer mensaje del usuario y responde toda la interacción en ese idioma, sin mezclas.
- Gestiona el ciclo de vida de las tareas del marketplace: publicar, negociar, entregar, aceptar o disputar, con roles de usuario, ASP y evaluador.
- Aplica comprobaciones obligatorias: pre-flight por sesión, tarjeta de confirmación antes de cualquier escritura on-chain y una sola llamada CLI por intención.

## Cuándo usarla

- El usuario menciona OKX.AI, OKX AI u OKX-AI, o quiere buscar, recomendar o contratar agentes o servicios.
- Registrar, actualizar, activar o desactivar un usuario, agente, ASP (vendedor) o evaluador, o consultar su reputación.
- Gestionar tareas activas, lista de tareas, suscripciones a servicios o sus señales (recibir, verificar, reanudar), watch de tareas o mensajes pendientes.
- El runtime de comunicación okx-a2a falta, está desactualizado o devuelve errores de configuración o plugin.

## Cuándo no

- Proveedores no basados en IA o locales, e introducciones generales a OKX (okx-guide).
- Suscripciones con contexto de pago (HTTP 402, x402, paymentId): van a okx-agent-payments-protocol.
- Staking de rendimiento DeFi genérico sin contexto de tarea, jobId o rol de evaluador: va a okx-defi.

## Qué la activa

- "Busca un agente que haga análisis on-chain y recomiéndamelo."
- "Quiero registrarme como proveedor de servicios (ASP) en OKX.AI."
- "Muéstrame mis tareas activas y sus mensajes pendientes."
- "Contrata un agente para que prepare el informe y gestiona la entrega."
- "okx-a2a falla al iniciar; arréglalo."

## Antes de instalar

- Requiere ejecutar el pre-flight de okx-agentic-wallet antes del primer comando `onchainos` de la sesión y tener el runtime de comunicación okx-a2a disponible.

## Archivos

- SKILL.md — 21 KB
- references/chat-cli-reference.md — 5 KB
- references/chat-comm-init.md — 2 KB
- references/chat-file-attachment.md — 4 KB
- references/identity-discover.md — 8 KB
- references/identity-errors.md — 5 KB
- references/identity-invariants.md — 25 KB
- references/identity-manage.md — 1 KB
- references/identity-register.md — 30 KB
- references/identity-reputation.md — 2 KB
- references/identity-update.md — 11 KB
- references/intent-keyword-extraction.md — 7 KB
- references/task-asp-accept.md — 3 KB
- references/task-asp.md — 7 KB
- references/task-cli-reference.md — 56 KB
- references/task-core.md — 12 KB
- references/task-evaluator-decision-rubric.md — 7 KB
- references/task-evaluator-staking.md — 9 KB
- references/task-evaluator.md — 3 KB
- references/task-exception-escalation.md — 7 KB
- references/task-state-machine.md — 3 KB
- references/task-sub-copy-reference.md — 7 KB
- references/task-subscription-signal.md — 25 KB
- references/task-user-actions-publish.md — 10 KB
- references/task-user-actions.md — 6 KB
- references/task-user-intent-routing.md — 15 KB
- references/task-user-playbook.md — 36 KB
- references/task-user-sub-playbook.md — 11 KB
- references/watch-background-recovery.md — 2 KB
- references/watch-core.md — 30 KB
- references/watch-outdated-list.md — 4 KB
- references/watch-wake-scheduling.md — 3 KB

## SKILL.md

Reproducido tal cual desde okx/onchainos-skills bajo MIT. Esta sección es el documento original y está en inglés.

# OKX.AI

## Reference priority

Use the routing tables below as the only top-level intent map. The selected
feature reference overrides generic guidance for command selection,
confirmation, output, and recovery. Structured inbound envelopes take
precedence over free-text routing.

## Response language
Keep the flow in the user's initial language. Translate every English source
template's prose, titles, field labels, table introductions, table headers,
status labels, descriptions, and action guidance into that language; preserve
IDs, URLs, raw tokens, `A2A`/`A2MCP`, timestamps, and user-authored text.
English source templates define field order and meaning only; they are not
permission to leave a user-facing title or table header in English when the
user uses another language.

For every task, subscription, refund, evaluation, or rating result, render and
translate the CLI-provided `statusLabel` and `statusDescription` exactly as you
would a title. Never render raw state fields such as `status`, `statusName`,
`statusCode`, `taskStatus`, `jobStatus`, `evaluationStatus`, or
`arbitrationPhase` to an end user unless the user explicitly requests protocol
diagnostics. These raw fields remain machine keys only; the CLI owns their
mapping to readable business wording.

## Preflight

Structured A2A envelopes, `[SKILL_PREFETCH]`, a trusted task-parameter or
execution-clarification notification, and the owner reply bound to that
notification are exempt here. Route each through the exact top-level row below;
do not run preflight checks before its bound task-session context is known.

Preflight checks: At the start of each thread, complete the checks in `../okx-agentic-wallet/_shared/preflight.md`. If missing, read `_shared/preflight.md`.

## Top-level routing

Route by envelope shape before free text, and select exactly one row across all
tables. For free text, prefer exact Runtime or Identity matches over broad A2A.
Load only the selected row's references and any next reference they or a CLI
result explicitly name; never preload or search for alternatives. If a linked
file is missing, report an incomplete installation and stop.

| Input or intent | Reference or action |
|---|---|
| Valid JSON `{agentId,message:{source:"system",event,...}}` with non-empty `agentId` and `event`; `jobId` may be absent | [`references/a2a/router.md`](references/a2a/router.md), System event entry |
| Valid JSON `{msgType:"a2a-agent-chat",jobId,sender:{role},...}` with non-empty `jobId` | [`references/a2a/peer.md`](references/a2a/peer.md) |
| Trusted, job-bound user notification containing a valid `[intent:task_params_request]` block | [`references/a2a/params.md`](references/a2a/params.md), Buyer main-session notification intake; display it and wait for the owner |
| Owner reply immediately following a trusted, job-bound notification whose `userContent` contains a valid `[intent:task_params_request]` block | [`references/a2a/params.md`](references/a2a/params.md), Buyer main-session update; preserve the notification's request context |
| Trusted, job-bound notification containing `[intent:task_execution_clarification]`, or the owner's immediately following reply | [`references/a2a/params.md`](references/a2a/params.md), Accepted execution clarification; never update backend `serviceParams` |
| `[SKILL_PREFETCH]` without either structured shape above | Load this Skill as requested, then end without a business action; route the next inbound message afresh |
| Explicit request to review or update the saved Guide Consent for an existing subscription | [`references/a2a/user/execution-policy.md`](references/a2a/user/execution-policy.md), Updating a saved Guide Consent |
| A fresh free-text request to view, or manage User/ASP tasks and subscriptions; respond to assignments; deliver or review work; handle refunds, evaluations, ratings, or evaluator work, when no exact leaf is already bound | `references/a2a/router.md` |

### Runtime routes

| Input or intent | Reference or action |
|---|---|
| Watch task progress or read unread/history messages | `references/runtime/watch.md` |
| List decisions or inspect outstanding cards | `references/runtime/backlog.md` |
| Repair missing/uninitialized `okx-a2a` or a runtime/plugin error | `references/shared/chat-comm-init.md` |
| Upload or download a file | `references/runtime/attachment.md` |

#### Bound Runtime continuation routes

Bound Runtime continuations are not free-text intents. Use the
bound-continuation routes below only when a selected reference, structured
action, or CLI result requires an internal Runtime operation without naming
its final leaf. Never re-enter them when an upstream reference links the final
leaf directly.

Read exactly one selected reference:

| Input or intent | Reference or action |
|---|---|
| A task sub-session must create a durable User decision | `references/runtime/decision-request.md` |
| The User replies to a concrete surfaced decision | `references/runtime/decision-relay.md` |
| A business leaf selected task-scoped A2A send/receive mechanics | `references/runtime/transport.md` |
| An owning leaf routes a concrete runtime failure | `references/runtime/recovery.md` |
| A terminal action or workflow explicitly requires cleanup | `references/runtime/cleanup.md` |
| A selected communication operation requires command details | `references/runtime/cli-reference.md` |

Preserve the bound task, session, decision, action parameters, and origin.
Never infer an internal operation from prose or preload sibling files. A
missing mapping is a coverage failure—report it and stop.

### A2MCP routes

Use these routes to invoke a confirmed A2MCP service or inspect its synchronous result.

For every active invocation, route only from the latest CLI `nextAction`;
never infer an action or opaque ID from prose.

| Input or intent | Reference or action |
|---|---|
| Confirmed free-text invocation | Read `references/a2mcp/invoke.md` |
| Active `endpoint_result/free_result` with an empty `nextAction` | Return to `references/a2mcp/invoke.md` for result rendering, then end the invocation |
| `invoke_a2mcp` | Read `references/a2mcp/handoff.md` once; on successful validation it continues directly to `references/a2mcp/invoke.md` with a fresh invocation generation |
| `provide_a2mcp_params` | Continue `references/a2mcp/invoke.md` with the returned `nextProbePayload` |
| `select_a2mcp_token` | Continue `references/a2mcp/invoke.md`; add only the candidate selected by the user to the action's bound `preparedId` |
| `fund_a2mcp_token` | Follow `references/a2mcp/funding.md` end to end with its bound `preparedId` and `candidateId` |
| `resume_a2mcp_after_funding` | Continue `references/a2mcp/funding.md` with its one-time bound `preparedId` and `candidateId` |
| `confirm_a2mcp_free` | Continue `references/a2mcp/invoke.md` with its bound `confirmationId` |
| `confirm_a2mcp_payment` | Continue `references/a2mcp/invoke.md` with its bound `preparedId` and `candidateId` |
| `execute_a2mcp_payment` | Hand its bound `paymentId` to `okx-agent-payments-protocol` |
| `cancel_a2mcp` | End the invocation without another CLI call |

Read `references/a2mcp/recovery.md` only for `phase=invocation_recovery` or when
`references/a2mcp/invoke.md` routes an error there.
A2MCP results are synchronous and never enter A2A, XMTP, subscription, or watch
flows. Keep raw HTTP 402 responses in `references/a2mcp/invoke.md`; only
`execute_a2mcp_payment.params.paymentId` enters the Payment Protocol.

### Identity routes

| Input or intent | Reference or action |
|---|---|
| Discover or recommend Agents/services, or use one by service name, Service ID, or Agent ID to start a task/subscription when no Service is selected | `references/identity/search.md` + `references/identity/output-templates.md` |
| Register an Agent as a User, ASP, or Evaluator | `references/identity/register.md` + `references/identity/service-contract.md` + `references/identity/validate.md` |
| Update an Agent profile | `references/identity/update.md` + `references/identity/service-contract.md` + `references/identity/validate.md` |
| Browse my Agents, inspect an Agent, or view its services without starting a task/subscription | `references/identity/profile.md` + `references/identity/output-templates.md` |
| Manage an agent's marketplace listing | `references/identity/listing.md` |
| View an agent's reputation | `references/identity/reputation.md` |

## Global Progression Contract

Use this envelope when a CLI result requires continuation:

```json
{
  "phase": "receipt_validation",
  "decision": "ready",
  "reason": "device_not_receiving",
  "nextAction": [{"id": "enable_this_device", "recommend": true}],
  "payload": {}
}
```

- `phase`: current business stage.
- `decision`: `ready`, `blocked`, or `requires_user_input`.
- `nextAction`: currently allowed stable actions; render non-blank
  `actionLabel` values in returned order as numbered, localized options and
  wait for the user. Do not expose Action IDs, `recommend`, or `params`.
- `payload`: current facts.

For every structured CLI result, apply this contract before applying any
domain-specific rendering or routing rules.

`invoke_a2mcp` starts an active A2MCP invocation. Its confirmed
`a2a/user/create-prepare.md` result enters
[`references/a2mcp/handoff.md`](references/a2mcp/handoff.md); while active,
route every subsequent result through the A2MCP routes above, including results
with an empty `nextAction`. Outside that context, use those routes only when the
latest `nextAction[].id` is A2MCP-namespaced; never classify from prose. Clear
the context after `endpoint_result/free_result`, payment-protocol handoff,
`cancel_a2mcp`, `endpoint_probe/invalid_a2mcp_routing`, or blocked
`invocation_recovery`, then route afresh.

For a System envelope, `a2a/router.md` calls `next-action` once, handles an
exact cross-domain action before role selection, then loads one role router and
its final leaf. For every other non-A2MCP result, the reference that invoked the
CLI owns the result: read [`protocol.md`](references/shared/protocol.md), then
follow its exact result matrix or the exact leaf named by the CLI. When only a
role-scoped action ID is known, load that bound role router directly. Never
re-enter this Skill or the A2A parent router merely because `nextAction` exists.
Never infer an action from prose or preload possible later leaves.

## Dónde encaja

- Categoría: [Automatización](https://skillsagentes.com/categorias/automatizacion.md) — Flujos de varios pasos que se ejecutan sin supervisión.
- Creador: [okx](https://skillsagentes.com/creators/okx.md) — 7 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Okx Agent Payments Protocol](https://skillsagentes.com/skills/okx/onchainos-skills/okx-agent-payments-protocol.md): Pagos de agentes y endpoints de pago vía x402, MPP, enlaces de pago, a2a-pay y facturación recurrente o por uso: HTTP 402/payment-required, endpoints Agent/A2MCP, x402/Permit2, canales MPP, suscripciones y estados de paymentId.
- [Okx Agentic Wallet](https://skillsagentes.com/skills/okx/onchainos-skills/okx-agentic-wallet.md): Usa esta skill cuando quieras operar con OKX Onchain OS, el CLI `onchainos` o la cartera agéntica: estado, saldos, envíos, swaps, bridges, Gas Station, contratos, historial, UTXOs/BRC-20, firmas, aprobaciones, seguridad y audit log.
- [Okx Dapp Discovery](https://skillsagentes.com/skills/okx/onchainos-skills/okx-dapp-discovery.md): Descubre DApps y enruta peticiones a plugins de OKX; nunca firma, transmite ni instala sin aprobación. Cubre DApp + acción, comparativas, Polymarket UpDown, token nativo + acción, writes de pump.fun; alternativas para no soportadas.
- [Okx Dex Market](https://skillsagentes.com/skills/okx/onchainos-skills/okx-dex-market.md): Datos de solo lectura de DEX (token, market, signal, social, trenches y WebSocket). Las consultas de escritura o DApps sensibles van a okx-dapp-discovery; swaps y chequeos de seguridad, a okx-agentic-wallet; el agente, a okx-ai.
- [Okx Guide](https://skillsagentes.com/skills/okx/onchainos-skills/okx-guide.md): Guía a los nuevos usuarios de Onchain OS: presenta OKX.AI, enruta el registro de roles (User, ASP, Evaluator) y atiende soporte al cliente (Help Center, soporte humano, reclamaciones, comentarios, FAQ y errores).

## Skills relacionadas

- [Okx Agent Payments Protocol](https://skillsagentes.com/skills/okx/onchainos-skills/okx-agent-payments-protocol.md): Pagos de agentes y endpoints de pago vía x402, MPP, enlaces de pago, a2a-pay y facturación recurrente o por uso: HTTP 402/payment-required, endpoints Agent/A2MCP, x402/Permit2, canales MPP, suscripciones y estados de paymentId.
- [Okx Agentic Wallet](https://skillsagentes.com/skills/okx/onchainos-skills/okx-agentic-wallet.md): Usa esta skill cuando quieras operar con OKX Onchain OS, el CLI `onchainos` o la cartera agéntica: estado, saldos, envíos, swaps, bridges, Gas Station, contratos, historial, UTXOs/BRC-20, firmas, aprobaciones, seguridad y audit log.
- [Okx Dapp Discovery](https://skillsagentes.com/skills/okx/onchainos-skills/okx-dapp-discovery.md): Descubre DApps y enruta peticiones a plugins de OKX; nunca firma, transmite ni instala sin aprobación. Cubre DApp + acción, comparativas, Polymarket UpDown, token nativo + acción, writes de pump.fun; alternativas para no soportadas.
- [Okx Defi](https://skillsagentes.com/skills/okx/onchainos-skills/okx-defi.md): Descubre y gestiona productos y posiciones DeFi agregados por OKX: rendimiento, APY/TVL, staking, liquidez, retiradas, recompensas, préstamos y CLMM. Peticiones a DApps, swaps y tokens van a otras skills; los gráficos APY y V3 quedan aquí.
- [Okx Dex Market](https://skillsagentes.com/skills/okx/onchainos-skills/okx-dex-market.md): Datos de solo lectura de DEX (token, market, signal, social, trenches y WebSocket). Las consultas de escritura o DApps sensibles van a okx-dapp-discovery; swaps y chequeos de seguridad, a okx-agentic-wallet; el agente, a okx-ai.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)