CROSS Skills
Forge

CROSS Forge · AI Agent Skill

Forge tokens & trade bonding curves with one sentence

From token deployment to bonding-curve buy/sell to portfolio queries — drive the Forge Router by natural language.

Open SKILL.md ↗View repo ↗

Install

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

Heads-up: CROSS Forge 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

deploy

Deploy a new token to Forge Router and create its bonding-curve pool.

🔴 Write · signs tx
token <symbol>

Inspect a token's bonding-curve state and recent trades.

🟢 Read · no auth
tokens

List trending or newest Forge tokens.

🟢 Read · no auth
portfolio [addr]

Your (or any address's) Forge holdings and valuation.

🟢 Read · no auth
quote

Simulate a buy or sell (estimated receive + slippage).

🟢 Read · no auth
buy

Buy on the bonding curve with native CROSS.

🔴 Write · signs tx
sell

Sell your tokens back to the bonding curve.

🔴 Write · signs tx
history

Your Forge trade and deploy history.

🟢 Read · no auth

Try it · natural-language prompts

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

Show me top 5 trending Forge tokens
→ Top tokens by volume
What's the bonding-curve state of BANANA?
→ Progress, market cap, recent trades
Show my Forge portfolio
→ Per-token balance, valuation, unrealized PnL
Quote a 1 CROSS buy of BANANA
→ Estimated receive + fees
Buy 0.5 CROSS of BANANA
→ tx sent + fill result
Sell half of my BANANA bag
→ tx sent + fill result
Deploy a token named "Nexus Coin" with symbol NXC
→ Confirm then send tx
Show my last 10 Forge trades
→ Trade table

Command reference

commandargsauthmutationdescription
deploy--name <str> --symbol <str> --description <str> --image <url|path> --category game|ai_agent [--wallet <addr>]PK (or temp wallet)txDeploy a token via Forge Router.
token<symbol|address>—readSingle token state.
tokens[--sort trending|new]—readToken list.
portfolio[<addr>]—readHoldings and valuation.
quote<buy|sell> <symbol> <amount> [--slippage=1]—readTrade simulation.
buy<symbol> <crossAmount> [--slippage=1] [--confirm]PKtxBonding-curve buy.
sell<symbol> <tokenAmount|--all> [--slippage=1] [--confirm]PKtxBonding-curve sell.
history[<addr>] [--limit=20]—readTrade history.

Safety & credentials

This skill signs on-chain transactions

  • 🔴 Signs on-chain transactions.
  • Required local signer config: PRIVATE_KEY (or skip with vendor-temp mode).
  • Default fees: 100 bps (protocol) + 30 bps (creator).
  • Guard: MAX_TRADE_NOTIONAL_CROSS env var caps per-trade size.
  • On hosted agents (Claude.ai): never use your main wallet PK — use a disposable hot wallet.

Troubleshooting

›insufficient_liquidity error?
The bonding curve is near 100% progress. Check with quote first.
›Pool not visible after deploy?
Factory indexing lag of 5–30s. Re-run token <symbol>.
›Slippage exceeded?
Pass --slippage (e.g. --slippage=3).
← Back to all skills