/okx-activity

name: okx-activity
description: "Register for the OKX.AI Trading Hackathon or explain its entry requirements and eligibility. Trigger on requests in any language to register, sign up, join, enter, or participate in the hackathon. Registers an existing Trading ASP; never creates one."
license: MIT
metadata:
  author: okx
  version: "4.4.10"
  homepage: "https://web3.okx.com"

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. 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.