Help us improve
Share bugs, ideas, or general feedback.
From onchainos-skills
Routes users from open-ended onboarding questions into concrete Onchain OS workflows (Polymarket, DeFi APY, smart-money signals, new-token screening, daily on-chain brief) via a welcome banner and Quick-start menu.
npx claudepluginhub okx/onchainos-skills --plugin onchainos-skillsHow this skill is triggered — by the user, by Claude, or both
Slash command
/onchainos-skills:okx-how-to-playThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
The first-time / "I don't know what to do" entry point. Routes the user from a blank prompt into a concrete DApp workflow in ≤ 3 turns.
Executes on-chain DEX swaps, wallet portfolio queries, gas estimation, and transaction broadcasting on EVM/Solana chains via OKX Web3 API. Use for token swaps, balance checks, or tx broadcast on Ethereum, Solana, Base, BSC, Arbitrum, Polygon, etc.
Routes users to OKX.AI customer support and Help Center with a fixed walkthrough for contacting a human agent or filing a complaint.
Walks through every MoonPay CLI capability via 7 missions: identity, token research, portfolio check, swap, fiat buy, message signing, and virtual accounts.
Share bugs, ideas, or general feedback.
The first-time / "I don't know what to do" entry point. Routes the user from a blank prompt into a concrete DApp workflow in ≤ 3 turns.
Tagged blocks indicate rule severity (higher wins on conflict):
<NEVER> — Absolute prohibition.<MUST> — Mandatory step. Skipping breaks the flow.<SHOULD> — Best practice.Negative examples (use the matching skill instead, not this one):
okx-agentic-wallet / okx-wallet-portfoliookx-dex-swapokx-dex-marketokx-agentic-wallet (but login as a reply to the welcome banner is handled inside this skill — see Login Method Choice)okx-dex-token
Most user-facing copy in this flow is split into two parts:
"login") MUST translate with their sentence. Leaving an English quoted word inside otherwise-translated Chinese / Japanese / etc. prose is a translation bug — the quotes do NOT make the word a literal trigger.{placeholders}, 1–N, code identifiers / commands / URLs, markdown structure.This applies to: Welcome Banner, Login Method Choice, and API Key Login Step 1 heads-up.
**Bridging is mandatory.** End the free zone with a transitional half-sentence (e.g. "let me drop the menu" / "here's where to start ↓") — never with a hard period followed by an unrelated fixed-zone line. Self-check before emitting: read the free-zone tail + first fixed-zone line as a single unit; if they feel like two separate posts pasted together, rewrite the free-zone tail.onchainos wallet status
loggedIn: false → render the logged-out Welcome Banner.loggedIn: true → render the logged-in Welcome Banner.Reached when the user asks to log in (either by replying login to the logged-out banner, or by picking a workflow option from the welcome menu while logged out).
Free zone (1–5 sentences, agent's own words): answer whatever the user actually asked / acknowledged. If they came from a workflow pick, briefly explain that login unlocks that workflow. Then segue naturally into the fixed-zone choice below.
Fixed zone — render the template below in the user's language:
Welcome to Agentic Wallet — the Onchain OS wallet built for agents. Pick a login method:
1. 📧 Email (recommended — 30 seconds)
2. 🔑 API Key (already an OKX developer? Fastest path)
Reply 1 or 2 ↓
If the user replies 1 or "email" → Email Login.
If the user replies 2 or "API Key" → API Key Login.
Handled by okx-agentic-wallet skill's Authentication section. Steps:
onchainos wallet login <email> --locale <locale>onchainos wallet verify <code>Two steps total: (1) one-time heads-up so the user knows what env vars to set and where to get them, (2) run onchainos wallet login once they confirm.
Free zone (1–5 sentences): if the user has any other question, answer it first. Then segue naturally into the heads-up.
Fixed zone — render the template below in the user's language:
You'll need to set three API Key environment variables before logging in:
1. `OKX_API_KEY` — API Key
2. `OKX_SECRET_KEY` — Secret Key
3. `OKX_PASSPHRASE` — Passphrase
You can find these at https://web3.okx.com/onchainos/dev-portal.
**Attention ⚠️:** Do not paste credentials into the chat — follow the dev-portal instructions and set them locally.
Then stop and wait for the user to confirm they're ready (e.g. "done / ok / ready").
Once the user confirms, run:
onchainos wallet login
On success → Post-login routing below. On login failure, surface the error and ask the user to verify their env vars (do NOT re-show the heads-up — they already saw it).
- Do NOT accept API Key / Secret / Passphrase inline in chat. If the user pastes credentials in chat: do NOT echo, do NOT use the values, ask them to delete the message + rotate the keys + set the env vars locally instead. - Do NOT walk the user through generating keys, opening URLs, creating `.env` files, editing `.gitignore`, or any other multi-step setup. The heads-up is one-shot — they handle their own local setup. - Do NOT ask the user to paste the browser URL or any callback back to the CLI. The dev-portal is read-only.After login completes successfully:
~/.onchainos/workflows/<file>.md) and follow it. Do NOT re-render the welcome banner.login (or equivalent) to the logged-out banner: render the logged-in Welcome Banner so they see their addresses + balance.If the user types something other than a numbered pick or login, answer in the free zone, then route to the matching skill / workflow:
| Intent | Route to |
|---|---|
| meme sniping / pump.fun / new launches | okx-dex-trenches |
| follow smart money / KOL / whale | okx-dex-signal (or load smart-money-signals.md) |
| bridge / cross-chain / move tokens between chains | okx-dex-bridge |
| yield / earn / stake / DeFi | okx-defi-invest |
| is this token safe / approvals | okx-security |
| swap / buy / sell | okx-dex-swap |
| my holdings / portfolio | okx-wallet-portfolio |
| trading competition / join contest / competition rank | okx-growth-competition |
| login (free-form, not as a banner reply) | this skill's Login Method Choice |
| named DApp + action verb (Aave / Hyperliquid / etc.) | okx-dapp-discovery |
loggedIn: false renders the logged-out variant (no addresses, with "login" hint); loggedIn: true renders the logged-in variant (addresses + balance, no hint).okx-dapp-discovery, which handles plugin install + load. Don't try to load web3-polymarket directly.~/.onchainos/workflows/; in this repo's source they're under workflows/.