okx-activity

okx/onchainos-skills

What is okx-activity?

This skill handles registration and participation for the OKX.AI Trading Hackathon. Use it when users want to sign up, join, or enter the hackathon, or when they ask about entry requirements and eligibility.

Routes hackathon registration requests to the correct workflow
Explains hackathon entry requirements and eligibility criteria
Registers an existing Trading ASP agent for hackathon participation
Requires explicit user confirmation before submitting any irreversible registration
Masks sensitive user identifiers in command output for security
Supports requests in any language

How to install okx-activity

npx skills add https://github.com/okx/onchainos-skills --skill okx-activity

Prerequisites

An existing Trading ASP agent (the skill registers existing agents, never creates new ones)
Completion of pre-flight checks in okx-agentic-wallet/_shared/preflight.md or _shared/preflight.md

Claude Code

Cursor

Windsurf

Cline

How to use okx-activity

1.Run the pre-flight checks from the referenced preflight.md file
2.Identify whether you want to register for the hackathon or check eligibility requirements
3.Run `onchainos hackathon --help` to see available subcommands
4.For registration: run the appropriate registration subcommand and provide explicit confirmation when prompted
5.For eligibility questions: run the appropriate FAQ or information subcommand
6.Review the masked command output (user identifiers will be hidden)

Use cases

Good for

A user asks to register their Trading ASP for the OKX.AI Trading Hackathon
A user inquires about who is eligible to participate in the hackathon
A user wants to know the entry requirements before signing up
A user requests to join the hackathon competition with their existing agent

Who it's for

Trading ASP agent owners
Hackathon participants
Users interested in OKX.AI competitions

okx-activity FAQ

Can this skill create a new Trading ASP agent?

No. This skill only registers existing Trading ASP agents for the hackathon. To create a new agent, use the okx-ai skill instead.

Is hackathon registration reversible?

No. Every activity registration is irreversible — there is no undo, update, or status subcommand. You must provide explicit confirmation before registration is submitted.

What is the difference between this skill and okx-growth-competition?

This skill registers a Trading ASP agent for the OKX.AI Trading Hackathon. The okx-growth-competition skill registers a wallet account for a standard trading competition. They are different systems and register different subjects.

What languages does this skill support?

The skill triggers on registration and eligibility requests in any language and will reply in the user's language.

Why are my user identifiers masked in the command output?

User identifiers like OKX UID are masked for security — they are sensitive and should never be logged or displayed in plain text.

Full instructions (SKILL.md)

Source of truth, from okx/onchainos-skills.

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, then hackathon-registration.md
Hackathon entry requirements or eligibility, in any language — not mid-registration	OKX.AI Trading Hackathon	hackathon-core.md, then 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.

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)

Add references/<activity>-core.md — its gates, reading order, output rules, and pre-delivery checklist — plus references/<activity>-*.md for the flow and FAQ.
Add one Intent Routing row per user intent that activity serves, each a complete markdown link.
Extend this file's description with the new activity's triggers.