ONEchain Skills
Gametoken

ONEgametoken · AI Agent Skill

Inspect, swap, and pool GameTokens by sentence

Inspect token/game metadata from ONEgametoken at stg.onechain.nexus/gametoken, then quote, buy, exact-output buy, sell, deposit, and withdraw RUBYx / MGT / GHUBx / SHOUT / CROMx and other GameTokens with slippage-bounded AMM swaps and LP actions.

Open SKILL.md ↗View repo ↗

Install

Clone https://github.com/to-nexus/skill-one-gametoken into a temporary directory and run the install.sh script inside it to install the skill-one-gametoken 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_ONE locally to cap per-transaction size.

Heads-up: ONEgametoken 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 ONE and GameToken balances for the configured EOA.

🟡 Read · local signer
buy

Spend exact ONE for a GameToken with slippage bounds.

🔴 Write · signs tx
buy-exact

Buy an exact GameToken amount with max ONE input.

🔴 Write · signs tx
sell

Sell exact GameToken amount for ONE with slippage bounds.

🔴 Write · signs tx
quote-deposit

Quote token needed and expected LP tokens.

🟢 Read · no auth
deposit

Add GameToken + ONE liquidity with slippage bounds.

🔴 Write · signs tx
quote-deposit-token

Quote ONE 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 + ONE 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 ONE worth of RUBYx
→ Swap quote with price impact
Buy 1 ONE worth of RUBYx
→ Slippage-bounded swap tx
Buy exactly 10 RUBYx
→ Exact-output swap tx after quote
Sell 10 RUBYx
→ Token-to-ONE swap tx
Deposit 1 ONE into the RUBYx pool
→ Token requirement + LP deposit tx
Deposit 20 SHILTZx into its pool
→ ONE requirement + LP deposit tx
Withdraw 0.5 RUBYx LP
→ Token + ONE withdrawal tx
Show my GameToken balances
→ ONE + 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> <oneSpend> [--slippage-bps=300]PKtxExact-input ONE to token.
buy-exact<symbol> <tokenAmount> [--slippage-bps=300]PKtxExact-output token buy.
sell<symbol> <tokenAmount> [--slippage-bps=300]PKtxExact-input token to ONE.
quote-deposit<symbol> <oneAmount> [--slippage-bps=300]—readQuote liquidity deposit.
deposit<symbol> <oneAmount> [--slippage-bps=300]PKtxAdd token + ONE 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_ONE caps buy spend, buy-exact max input, sell quoted output, deposit ONE input, and withdraw quoted ONE 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 ONE input plus slippage.
›What are deposit and withdraw?
deposit adds GameToken + ONE 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