CROSS Skills Suite

✨
AI Agent Skills for the CROSS 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 · Prediction · Forge · Bridge · Rewards · NFT · Shop · Explorer · Wave · Points · 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.

Clone https://github.com/to-nexus/cross-skills-suite into a temporary directory and run the bootstrap.sh script inside it to install every CROSS 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)	🔴 Write · tx — Limit / market buy & sell against the Gametoken orderbook.
Prediction	🔴 Write · tx — YES / NO Share trading on prediction.crossdefi.io.
Forge	🔴 Write · tx — Deploy game/AI tokens, create bonding-curve pools, trade.
NFT	🔴 Write · tx — List, buy, offer, accept on MarketplaceV1.

🌉 Bridge & Stake

Service	Card
Bridge (CrossDefi)	🔴 Write · tx — BSC ↔ CROSS ↔ Klaytn swap-bridge.
Rewards	🔴 Write · tx — Stake WCROSS, harvest reward tokens.
Stake	🔴 Write · tx — Native CROSS staking on stake.ogfcorp.com.

🎮 Game & Streamer

Service	Card
Shop	🔴 Write · tx — In-game item purchase via CROSS / BNB.
Wave	🟣 Write · JWT — Submit Shorts / TikTok videos to streamer missions.
Points	🟡 Read · auth + 🔴 Write · tx — Quests, leaderboard, deposit-quest staking.

🔍 Read-only

Service	Card
Explorer	🟢 Read · no auth — CROSS 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.

buy 31 RUBYx at 0.128 CROSS
List active prediction events
Deploy a Forge token called "MyToken" symbol MTK
Buy NFT listing 321699

Bridge 1 USDT from BSC to CROSS
Stake 1.5 WCROSS in the rewards pool
Stake 100 native CROSS on cross-stake

List cross.shop games
Submit my YouTube Shorts to mission 21
Show my CROSS Points and quest progress

Look up tx 0xabcd... on crossscan
Show CROSS 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	`pairs` · `balance` · `buy` · `sell` · `market-buy` · `cancel`
cross-prediction	`list-events` · `get-event` · `get-results` · `balance` · `buy` · `sell`
cross-forge	`deploy` · `token` · `tokens` · `quote` · `buy` · `sell` · `portfolio` · `history`
cross-crossd	`pairs` · `tokens` · `quote` · `status` · `history` · `bridge`
cross-rewards	`info` · `balance` · `deposit` · `withdraw` · `harvest`
cross-nft	`collections` · `token` · `tokens` · `listing` · `offers` · `activities` · `stats` · `search` · `list` · `cancel-listing` · `buy` · `offer` · `cancel-offer` · `accept-offer`
cross-shop	`games` · `products` · `login` · `quote` · `purchase` · `orders` · `status`
cross-explorer	`stats` · `latest` · `block` · `tx` · `address` · `contract` · `token` · `search` · `parse-url`
cross-wave	`info` · `missions` · `campaigns` · `login` · `whoami` · `referral` · `submit` · `claim`
cross-points	`quests` · `quest` · `leaderboard` · `whoami` · `weekly` · `deposits` · `deposit` · `withdraw` · `auth` · `do`
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/.