---
updatedAt: 2026-08-07T01:37:50.000Z
agentTools:
projectIndex: https://docs.onechain.nexus/llms.txt
---
# ONE Skills Suite
Send your AI agent to the ONE Chain ecosystem. Eleven services — DEX, Prediction, Forge, Bridge, Rewards, NFT, Shop, Explorer, Wave, Points, Stake — driven by one natural-language sentence
### **AI Agent Skills for the ONE Chain ecosystem.**
Drop a single sentence in any language into your AI agent. The agent installs the skill, signs the transaction, and reports back in one line. No commands to memorize, no manual contract calls.
### **What's included**
Eleven services in one suite — [DEX](https://docs.onechain.nexus/docs/skill-cross-dex-trade) · [Prediction](https://docs.onechain.nexus/docs/skill-cross-prediction) · [Forge](https://docs.onechain.nexus/docs/skill-cross-forge) · [Bridge](https://docs.onechain.nexus/docs/skill-cross-crossd) · [Rewards](https://docs.onechain.nexus/docs/skill-cross-rewards) · [NFT](https://docs.onechain.nexus/docs/skill-cross-nft) · [Shop](https://docs.onechain.nexus/docs/skill-cross-shop) · [Explorer](https://docs.onechain.nexus/docs/skill-cross-explorer) · [Wave](https://docs.onechain.nexus/docs/skill-cross-wave) · [Points](https://docs.onechain.nexus/docs/skill-cross-points) · [Stake](https://docs.onechain.nexus/docs/skill-cross-stake). Pick a service page for its full feature list and prompts.
***
## 1. Install
The block below is a **natural-language prompt to paste into your AI agent** — not a terminal command. Your agent reads the intent and runs `git clone` + `bash bootstrap.sh` for you.
```text Paste-into-agent prompt
Clone https://github.com/to-nexus/cross-skills-suite into a temporary directory and run the bootstrap.sh script inside it to install every ONE skill into my environment. Tell me which skills succeeded and which failed in one line each.
```
### **Bash execution required.**
The suite installs Node packages and runs `viem`. Environments without shell access — Claude.ai (web), ChatGPT (web), Gemini (web) — cannot run it. See §2 for the supported list.
**What just happened.** Your agent cloned the suite repo, read `services.list`, cloned every per-service repo into `~/cross-skills/`, and ran each repo's `install.sh` so the skill is symlinked into `~/.claude/skills/`. Idempotent — safe to re-run any time.
### Want only one service?
Open that service's page and copy its single-skill install prompt instead.
***
## 2. Where it runs
### **Anywhere your AI agent has Bash access.**
### ✅ Supported · CLI agents with Bash access
| Agent | Notes |
| -------------------------------------- | ------------------------------------------------------------------- |
| **Claude Code (CLI)** | Anthropic's official CLI. Reference environment. |
| **OpenClaw** | SOUL.md-based dispatcher; integrates via `~/.openclaw/workspaces/`. |
| **Cursor Composer / Background Agent** | IDE-embedded shell + code actions. |
| **Codex CLI** | OpenAI's CLI. |
| **Aider** | Open-source pair-programming CLI. |
| **Goose** | Block's terminal AI agent. |
| **Gemini CLI** | Google's CLI tool. |
| **OpenInterpreter** | Local code-execution AI. |
| **Other** | Any Bash-capable CLI AI agent. |
### ❌ Not supported · Browser / hosted only
Claude.ai (web) · ChatGPT (web) · Gemini (web) · GitHub Copilot Chat (web) · any browser-only agent.
These environments cannot execute `viem` or `npm` dependencies. Even if you paste the SKILL.md as context, the agent will only produce meta responses like "this skill does X" — the actual transactions and queries never run.
***
## 3. What you can do
### 💱 Trade & Markets
| Service | Card |
| ------------------------------------------ | -------------------------------------------------------------------------- |
| [**DEX (Gametoken)**](https://docs.onechain.nexus/docs/cross-dex-trade) | 🔴 Write · tx — Limit / market buy & sell against the Gametoken orderbook. |
| [**Prediction**](https://docs.onechain.nexus/docs/cross-prediction) | 🔴 Write · tx — YES / NO Share trading on prediction.crossdefi.io. |
| [**Forge**](https://docs.onechain.nexus/docs/cross-forge) | 🔴 Write · tx — Deploy game/AI tokens, create bonding-curve pools, trade. |
| [**NFT**](https://docs.onechain.nexus/docs/cross-nft) | 🔴 Write · tx — List, buy, offer, accept on MarketplaceV1. |
### 🌉 Bridge & Stake
| Service | Card |
| --------------------------------------- | ---------------------------------------------------------- |
| [**Bridge (ONEUSD)**](https://docs.onechain.nexus/docs/cross-crossd) | 🔴 Write · tx — BSC ↔ ONE ↔ Klaytn swap-bridge. |
| [**Rewards**](https://docs.onechain.nexus/docs/cross-rewards) | 🔴 Write · tx — Stake WCROSS, harvest reward tokens. |
| [**Stake**](https://docs.onechain.nexus/docs/cross-stake) | 🔴 Write · tx — Native CROSS staking on stake.ogfcorp.com. |
### 🎮 Game & Streamer
| Service | Card |
| ------------------------------ | ---------------------------------------------------------------------------- |
| [**Shop**](https://docs.onechain.nexus/docs/cross-shop) | 🔴 Write · tx — In-game item purchase via CROSS / BNB. |
| [**Wave**](https://docs.onechain.nexus/docs/cross-wave) | 🟣 Write · JWT — Submit Shorts / TikTok videos to streamer missions. |
| [**Points**](https://docs.onechain.nexus/docs/cross-points) | 🟡 Read · auth + 🔴 Write · tx — Quests, leaderboard, deposit-quest staking. |
### 🔍 Read-only
| Service | Card |
| ---------------------------------- | ------------------------------------------------------------- |
| [**Explorer**](https://docs.onechain.nexus/docs/cross-explorer) | 🟢 Read · no auth — ONE Chain blocks, txs, addresses, tokens. |
### **Auth bands.**
🟢 Read · no auth — 🟡 Read · auth required — 🔴 Write · signs on-chain tx — 🟣 Write · off-chain auth (JWT / OAuth)
***
## 4. Try it
Paste any line below into your AI agent. The agent picks the right skill, fills in your wallet, and prompts you to confirm before signing anything.
```text Trade
buy 31 RUBYx at 0.128 CROSS
List active prediction events
Deploy a Forge token called "MyToken" symbol MTK
Buy NFT listing 321699
```
```text Bridge & Stake
Bridge 1 USDT from BSC to ONE
Stake 1.5 WCROSS in the rewards pool
Stake 100 native CROSS on cross-stake
```
```text Game & Streamer
List cross.shop games
Submit my YouTube Shorts to mission 21
Show my ONE Points and quest progress
```
```text Read
Look up tx 0xabcd... on crossscan
Show ONE NFT collections trending this week
Show current BILL balance and active shares
```
For a fuller list per service, open that service's page.
***
## 5. Command reference
Each service exposes its own subcommand surface. Open a service page for its full table. Quick links:
| Service | Subcommands |
| ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [cross-dex-trade](https://docs.onechain.nexus/docs/cross-dex-trade) | `pairs` · `balance` · `buy` · `sell` · `market-buy` · `cancel` |
| [cross-prediction](https://docs.onechain.nexus/docs/cross-prediction) | `list-events` · `get-event` · `get-results` · `balance` · `buy` · `sell` |
| [cross-forge](https://docs.onechain.nexus/docs/cross-forge) | `deploy` · `token` · `tokens` · `quote` · `buy` · `sell` · `portfolio` · `history` |
| [cross-crossd](https://docs.onechain.nexus/docs/cross-crossd) | `pairs` · `tokens` · `quote` · `status` · `history` · `bridge` |
| [cross-rewards](https://docs.onechain.nexus/docs/cross-rewards) | `info` · `balance` · `deposit` · `withdraw` · `harvest` |
| [cross-nft](https://docs.onechain.nexus/docs/cross-nft) | `collections` · `token` · `tokens` · `listing` · `offers` · `activities` · `stats` · `search` · `list` · `cancel-listing` · `buy` · `offer` · `cancel-offer` · `accept-offer` |
| [cross-shop](https://docs.onechain.nexus/docs/cross-shop) | `games` · `products` · `login` · `quote` · `purchase` · `orders` · `status` |
| [cross-explorer](https://docs.onechain.nexus/docs/cross-explorer) | `stats` · `latest` · `block` · `tx` · `address` · `contract` · `token` · `search` · `parse-url` |
| [cross-wave](https://docs.onechain.nexus/docs/cross-wave) | `info` · `missions` · `campaigns` · `login` · `whoami` · `referral` · `submit` · `claim` |
| [cross-points](https://docs.onechain.nexus/docs/cross-points) | `quests` · `quest` · `leaderboard` · `whoami` · `weekly` · `deposits` · `deposit` · `withdraw` · `auth` · `do` |
| [cross-stake](https://docs.onechain.nexus/docs/cross-stake) | `network-stats` · `validators` · `my-delegation` · `rewards` · `history` · `delegate` · `undelegate` · `withdraw` · `claim-rewards` |
***
## 6. Safety & credentials
### **Every write skill signs real on-chain transactions.**
| Rail | What it does |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| **Chain-id check** | All RPC clients verify `eth_chainId == 612055` (or the bridge source chain id) before any signed tx. Mismatch → hard abort. |
| **Per-trade cap** | `MAX_TRADE_CROSS` / `MAX_TRADE_BILL` / `MAX_STAKE_NOTIONAL` / `MAX_PURCHASE_NOTIONAL` etc. Aborts above the cap. |
| **Confirmation prompt** | Trades above `CONFIRM_THRESHOLD` (default `1` in the trade asset) require explicit `--confirm`. |
| **Native gas pre-flight** | `MIN_GAS_NATIVE` (default `0.001`). Aborts before signing if the wallet is short. |
| **Secrets stay local** | `PRIVATE_KEY` / `PIN` / JWT never appear in the agent transcript, in `argv`, or in logs. `.env` / `.auth/` / `.session/` are gitignored. |
### **Hosted-agent tip.**
If you ever feed a `PRIVATE_KEY` to an agent, use a **disposable wallet** with only as much CROSS as you plan to spend that session. Never paste your main wallet's key into a hosted environment.
***
## 7. Troubleshooting
The install prompt didn't do anything — my agent just printed text.
Your agent doesn't have Bash execution. Open this page in Claude Code, OpenClaw, Cursor, or another CLI agent with shell access. Browser-only agents like Claude.ai / ChatGPT web cannot install or run these skills.
I'm getting wrong\_chain.
Your RPC URL is pointing at a different chain. Open the skill's `.env` and set `CROSS_RPC_URL=https://mainnet.crosstoken.io:22001/` (or remove the override entirely).
The agent says awaiting\_confirm.
You asked for a trade above `CONFIRM_THRESHOLD` (default 1 in the trade asset). Re-issue the request with explicit confirmation (e.g. "buy 31 RUBYx at 0.128 — confirmed").
insufficient\_gas on what looks like a small trade.
The skill requires `MIN_GAS_NATIVE` (default 0.001) on top of the trade amount, so the tx doesn't run out of gas mid-flight. Top up CROSS or set `MIN_GAS_NATIVE=0` if you know the gas envelope.
How do I update to a newer version?
Re-run the install prompt above. Both `bootstrap.sh` and per-skill `install.sh` are idempotent — they pull latest and re-link.
How do I uninstall?
Delete the symlinks: `rm -rf ~/.claude/skills/cross-*` and (optionally) the working copies: `rm -rf ~/cross-skills/`.