$npx -y skills add okx/onchainos-skills --skill okx-agentic-walletOKX Agentic Wallet — the single skill for the user's wallet and on-chain execution. Use it whenever the user wants to operate their wallet or execute an on-chain action, including: login & accounts, balance / holdings, wallet address / deposit / receive, send / transfer, contract
| 1 | # Onchain OS Wallet |
| 2 | |
| 3 | Unified wallet skill driving the `onchainos` CLI: wallet lifecycle, Gas Station, DEX swap, cross-chain bridge, limit-order strategy, transaction gateway, public-address portfolio, security scanning, and audit log. |
| 4 | |
| 5 | ## Intent Routing |
| 6 | |
| 7 | Match the user intent to a row, then **read that row's linked file first** — it holds the flow. Read only the matched file; do not load other rows' files. Each file links its own deeper files (cli-reference, troubleshooting) at the bottom via explicit links — open those when the flow needs them; never construct a file path yourself. |
| 8 | |
| 9 | | User Intent | Reference | |
| 10 | | --- | --- | |
| 11 | | Sign in / connect / social login (Google / Apple / Email) / logout; add / switch account; login status | [wallet](references/wallet.md) | |
| 12 | | My wallet address / QR code; check my (logged-in) balance / holdings | [wallet](references/wallet.md) | |
| 13 | | Send / transfer native or ERC-20 / SPL tokens | [wallet](references/wallet.md) | |
| 14 | | Call a contract (approve / deposit / withdraw / custom function) | [wallet](references/wallet.md) | |
| 15 | | Transaction history / tx detail / order status; sign a message (personalSign / EIP-712) | [wallet](references/wallet.md) | |
| 16 | | Policy / spending limit / whitelist; export wallet / mnemonic; MEV protection for a contract-call; third-party Solana plugin write pre-flight | [wallet](references/wallet.md) | |
| 17 | | Apple-login wallet differs from the OKX Wallet App / "missing" balance; rename a wallet or account; how transaction signing works (TEE) | [account-faq](references/account-faq.md) | |
| 18 | | Pay gas with a stablecoin on Solana; enable / disable / change default gas token / status; a `send` / `contract-call` returns `gasStationUsed` or a Gas Station Confirming; Gas Station FAQ / "check order" | [gas-station](references/gas-station.md) | |
| 19 | | Swap / trade / buy / sell / convert tokens; quote; best route; calldata-only swap; liquidity sources; ERC-20 approval for a DEX | [swap](references/swap.md) | |
| 20 | | Bridge / cross-chain swap / move tokens between chains; bridge quote / fee comparison; supported bridges; track cross-chain arrival | [bridge](references/bridge.md) | |
| 21 | | Limit order: buy dip / take profit / stop loss / buy above; cancel / list / resume limit (strategy) orders | [strategy](references/strategy.md) | |
| 22 | | Broadcast a signed / raw tx; estimate gas price / gas-limit; simulate a tx; track a broadcast order | [gateway](references/gateway.md) | |
| 23 | | A given public address's balance / holdings / total value (`0xAbc…` / a Solana address) | [portfolio](references/portfolio.md) | |
| 24 | | Token / honeypot (蜜罐 / 貔貅) safety; DApp / URL phishing; tx or signature pre-check; check / list / revoke token approvals (ERC-20 / Permit2) | [security](references/security.md) | |
| 25 | | Export / locate audit log, view command history | [audit-log](references/audit-log.md) | |
| 26 | |
| 27 | --- |
| 28 | |
| 29 | ## Pre-flight Checks |
| 30 | |
| 31 | Before the first `onchainos` command this session, read and follow [_shared/preflight.md](_shared/preflight.md). |
| 32 | |
| 33 | ## Build the Command |
| 34 | |
| 35 | 1. **Read the matched row's linked file first** (per the Intent Routing table) — it carries the flow and the commands you need. Never guess subcommand, flag, or file names. |
| 36 | 2. **When you need exact flags, defaults, or return-field schemas** that the domain file doesn't spell out, run `onchainos <group> <subcommand> --help` (the CLI is the source of truth), or load that domain's `-cli-reference.md` when the flow needs it (each domain file lists its own deeper files at the bottom). Don't load it up front. |
| 37 | 3. **Confirm before any state-changing command.** Display the prompt, get an explicit affirmative, and follow the Confirming Response rule below. |
| 38 | |
| 39 | ## Chain Name Support |
| 40 | |
| 41 | `--chain` accepts numeric chain IDs and human-readable names. Resolution rules and the supported-chain matrix live in [_shared/chain-support.md](_shared/chain-support.md). If <100% confident of a chain name, run `onchainos wallet chains`. |
| 42 | |
| 43 | ## Confirming Response |
| 44 | |
| 45 | Some state-changing commands retur |