CROSS Skills
Gametoken

CROSS GameToken · AI Agent Skill

Inspect, swap, and pool GameTokens by sentence

Inspect token/game metadata, quote, buy, exact-output buy, sell, deposit, and withdraw RUBYx / MGT / GHUBx / SHOUT / CROMx and other GameTokens on CROSS Chain with slippage-bounded AMM swaps and LP actions.

Open SKILL.md ↗View repo ↗

Install

Clone https://github.com/to-nexus/skill-cross-dex-trade into a temporary directory and run the install.sh script inside it to install the skill-cross-dex-trade skill into my Claude Code environment. Tell me the result in one line when you're done.
  1. For personal testing, keep local signer config in the skill .env before write commands.
  2. For team, hosted-agent, or production funds, prefer Vault/KMS/HSM-backed signing.
  3. Set MAX_TRADE_CROSS locally to cap per-transaction size.

Heads-up: CROSS DEX runs on local agent runtimes only — see the Where it runs section for the supported list. Hosted chat environments cannot execute this skill.

Where it runs

Supported

Claude Code (CLI)OpenClawCursor Composer / Background AgentCodex CLIAiderGooseGemini CLIOpenInterpreter

Not supported

Claude.ai (web)ChatGPT (web)Gemini (web)GitHub Copilot Chat (web)

What you can do

tokens

List GameTokens with metadata, game, and price stats.

🟢 Read · no auth
token-info

Show token/game details, market stats, swaps, liquidity events, and candles.

🟢 Read · no auth
pairs

List AMM pairs and reserves.

🟢 Read · no auth
quote

Quote buy, buy-exact, or sell without signing.

🟢 Read · no auth
balance

Show CROSS and GameToken balances for the configured EOA.

🟡 Read · local signer
buy

Spend exact CROSS for a GameToken with slippage bounds.

🔴 Write · signs tx
buy-exact

Buy an exact GameToken amount with max CROSS input.

🔴 Write · signs tx
sell

Sell exact GameToken amount for CROSS with slippage bounds.

🔴 Write · signs tx
quote-deposit

Quote token needed and expected LP tokens.

🟢 Read · no auth
deposit

Add GameToken + CROSS liquidity with slippage bounds.

🔴 Write · signs tx
quote-deposit-token

Quote CROSS needed and expected LP tokens from a token amount.

🟢 Read · no auth
deposit-token

Add liquidity from a GameToken amount with slippage bounds.

🔴 Write · signs tx
quote-withdraw

Quote token + CROSS outputs for LP removal.

🟢 Read · no auth
withdraw

Remove liquidity with LP tokens.

🔴 Write · signs tx

Try it · natural-language prompts

Copy any of these into your agent — they map 1-to-1 onto a skill command.

List GameTokens
→ Token table with game and price stats
Show SHILTZx token info
→ Game, market, recent swaps, and candle data
Quote 1 CROSS worth of RUBYx
→ Swap quote with price impact
Buy 1 CROSS worth of RUBYx
→ Slippage-bounded swap tx
Buy exactly 10 RUBYx
→ Exact-output swap tx after quote
Sell 10 RUBYx
→ Token-to-CROSS swap tx
Deposit 1 CROSS into the RUBYx pool
→ Token requirement + LP deposit tx
Deposit 20 SHILTZx into its pool
→ CROSS requirement + LP deposit tx
Withdraw 0.5 RUBYx LP
→ Token + CROSS withdrawal tx
Show my GameToken balances
→ CROSS + token balances

Command reference

commandargsauthmutationdescription
tokens[--query=TEXT] [--limit=N]—readList GameTokens.
token-info<symbol|all> [--history=N] [--candles=N] [--tick=1h]—readInspect token and game info.
pairs——readList AMM pairs.
quote<buy|sell|buy-exact> <symbol> <amount>—readQuote a swap.
balance—PKreadWallet balances.
buy<symbol> <crossSpend> [--slippage-bps=300]PKtxExact-input CROSS to token.
buy-exact<symbol> <tokenAmount> [--slippage-bps=300]PKtxExact-output token buy.
sell<symbol> <tokenAmount> [--slippage-bps=300]PKtxExact-input token to CROSS.
quote-deposit<symbol> <crossAmount> [--slippage-bps=300]—readQuote liquidity deposit.
deposit<symbol> <crossAmount> [--slippage-bps=300]PKtxAdd token + CROSS liquidity.
quote-deposit-token<symbol> <tokenAmount> [--slippage-bps=300]—readQuote token-based deposit.
deposit-token<symbol> <tokenAmount> [--slippage-bps=300]PKtxAdd liquidity from token amount.
quote-withdraw<symbol> <lpAmount|all> [--slippage-bps=300]—readQuote liquidity withdrawal.
withdraw<symbol> <lpAmount|all> [--slippage-bps=300]PKtxRemove liquidity.

Safety & credentials

This skill signs on-chain transactions

  • Required credential — PRIVATE_KEY in local .env or a hosted-agent secret manager.
  • Where it lives — your local machine, or the secret manager of your hosted agent.
  • Guard env vars — MAX_TRADE_CROSS caps buy spend, buy-exact max input, sell quoted output, deposit CROSS input, and withdraw quoted CROSS output.
  • Slippage bound — default --slippage-bps=300; values above 5000 bps are refused.
  • Hosted agents (Claude.ai, etc.) — never paste your main-wallet PK. Use a disposable hot wallet.

Troubleshooting

›Can I place a limit order?
No. This skill now uses the GameToken swap router. Use quote and slippage bounds instead.
›What does buy-exact do?
It buys an exact token amount and sends up to the quoted CROSS input plus slippage.
›What are deposit and withdraw?
deposit adds GameToken + CROSS liquidity to the AMM pool. withdraw removes liquidity by burning LP tokens.
›How do I verify the migration?
Run npm test in the skill folder. It checks API reads, quote modes, deposit/withdraw quote math, and router calldata selectors without signing.
›PRIVATE_KEY missing?
Read-only commands (tokens, pairs, quote) work without a key. Write commands and balance require it.
← Back to all skills