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

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.

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.
2. Add one Intent Routing row per user intent that activity serves, each a complete markdown link.
3. Extend this file's description with the new activity's triggers.