okx-activity

OKX Activity — registration & participation for OKX campaign activities

Each activity's flow, CLI reference, FAQ, and gates live in this skill's references/ behind an

<activity>-*.md prefix. This SKILL.md routes only — no templates, no CLI flags, no per-activity

copy — so adding an activity never changes the rules of an existing one.

Pre-flight Checks

Before your first onchainos command, read ../okx-agentic-wallet/_shared/preflight.md once. If it does not exist, read _shared/preflight.md instead.

BLOCKING — it runs before the first onchainos command of the session, for every activity, a

read-only listing call included.

Intent Routing

| User Intent | Activity | Reference |

|---|---|---|

| Register, sign up, join, enter, or participate in the hackathon, in any language | OKX.AI Trading Hackathon | [hackathon-core.md](references/hackathon-core.md), then [hackathon-registration.md](references/hackathon-registration.md) |

| Hackathon entry requirements or eligibility, in any language — not mid-registration | OKX.AI Trading Hackathon | [hackathon-core.md](references/hackathon-core.md), then [hackathon-faq.md](references/hackathon-faq.md) |

**Before producing ANY user-facing message about an activity, that activity's *-core.md must be

loaded (BLOCKING**). It carries that activity's gates, output rules, and send-gate — the flow and

FAQ files do not repeat them, so opening a -registration.md / -faq.md first is not a

shortcut, it is a skipped gate. Do not improvise a flow, template, or eligibility answer from this

file, from memory, or from the CLI's --help output alone.

If the request names an activity with no row above (no reference file exists for it), say that

activity isn't supported by this skill yet — never adapt another activity's flow to it, and never

guess a CLI subcommand for it.

Command Index

This skill drives onchainos <activity> subcommands (hackathon → onchainos hackathon). **Learn

exact syntax from the CLI, not from memory:** run onchainos hackathon --help for the subcommand

list, and onchainos hackathon <subcommand> --help for a subcommand's flags. Full parameter tables,

return-field schemas, and worked examples live in

[hackathon-registration.md](references/hackathon-registration.md).

Wrong-skill guard

An activity here enters the subject that activity defines (hackathon → an existing Trading ASP

agent). competition join (okx-growth-competition) signs the wallet account up for a standard

trading competition. Different systems, different subjects — NEVER: substitute one for the other,

because the two register different things and neither call can be undone.

If one request carries signals for both (e.g. names "hackathon" and "competition" or "cup"),

ask which the user means before running any command.

Security

• Every activity registration is irreversible — there is no list, update, status, or undo

subcommand. MUST: hold an explicit confirm reply from the user before submitting; never answer

the confirmation prompt on their behalf, and never treat a one-shot request that already named the

subject as having pre-answered it. The full gate lives in the activity's -registration.md.

• NEVER: log, print, or pass the JWT in a flag — it is injected by the client layer from the

keychain, so leaking it would let an attacker act as the user. Activity flows create no new secrets.

• MUST: mask user identifiers (OKX UID and the like) when echoing the executed command

(--uid <hidden>) — they are never returned by the CLI and never pasted raw into the conversation.

• NEVER: identify an activity by its internal activity id, in any format — name it. The CLI does

not return that id; do not source it from anywhere else.

• Creating an agent identity is never part of an activity flow — that is okx-ai. This skill only

enters subjects that already exist.

Global Notes

• Reply in the user's language. Every template in this skill's references is authored in English

as a structure guide — translate it before sending, keeping the layout and fields unchanged and

every URL byte-for-byte, still a link.

• Each activity's -core.md owns its own gates, Output Rules, and Pre-Delivery Checklist; those are

additional to this file, never a substitute for it.

Adding an activity (maintainers)

1. Add references/<activity>-core.md — its gates, reading order, output rules, and pre-delivery

checklist — plus references/<activity>-*.md for the flow and FAQ.

1. Add one Intent Routing row per user intent that activity serves, each a complete markdown link.
2. Extend this file's description with the new activity's triggers.