skills/swarm-orchestrator/SKILL.md
Orchestrate multi-bot trading swarms on Pump.fun with persona-driven agents
npx skillsauth add x402agent/solana-clawd skills/swarm-orchestratorInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Manage multi-bot trading swarms with agent personas, epistemological memory, and cross-bot event routing.
TELEGRAM_BOT_TOKEN for Telegram gateway (optional)HELIUS_RPC_URL configured# Start the swarm orchestrator
npm run swarm
# Start SolanaOS agent orchestrator
npm run claw
npm run claw:dev # with hot reload
| Role | Description | Auto-Actions |
|------|-------------|-------------|
| sniper | Snipe new token launches | Monitor → Buy on launch |
| monitor | On-chain event watcher | Observe → Alert |
| fee-claimer | Claim creator fees | Check → Claim automatically |
| analyst | Price/curve analysis | Observe → Report |
| momentum | Momentum-based trading | RSI+EMA → Execute |
| graduation | Target near-graduation tokens | Monitor progress → Buy |
| market-maker | Provide liquidity | Buy/sell oscillation |
| launcher | Create new tokens | Build → Launch |
| channel-feed | Telegram channel updates | Events → Post |
| outsider | Call tracking + leaderboards | Track → Score |
Every agent can be born with one of 43+ DeFi personas:
# Via Telegram
/spawn analyst --persona whale-watcher
/spawn sniper --persona alpha-leak-detector
/personas # Browse all personas
/personas trading # Filter by category
| Category | Count | Examples | |----------|-------|---------| | 🪙 Crypto | 6 | Whale Watcher, Alpha Detector | | 🏦 DeFi | 14 | Yield Farmer, Flash Loan Analyst | | 📈 Trading | 5 | Pump SDK Expert, MEV Researcher | | 🔒 Security | 6 | Smart Contract Auditor | | 📚 Education | 2 | DeFi Mentor |
All bots communicate through a pub/sub event bus:
| Event | Source | Description |
|-------|--------|-------------|
| token:launch | websocket-server | New token detected |
| token:graduation | monitor | Token completed bonding curve |
| trade:buy / trade:sell | swarm-bot | Trade executed |
| alert:whale | monitor | Large transaction detected |
| fee:claim | fee-claimer | Fee claimed successfully |
| call:new | outsiders-bot | New call registered |
Each agent gets its own ClawVault with 3-tier epistemological memory:
/memory <agent-id> # View agent's memory
/agents # List agents with memory stats
/health # Collective memory overview
| Command | Description |
|---------|-------------|
| /spawn <role> [--persona <id>] | Spawn agent |
| /stop <id> | Stop an agent |
| /agents | List active agents |
| /personas [query] | Browse personas |
| /memory <id> | View agent memory |
| /health | Swarm health dashboard |
| /price <mint> | Token price |
| /quote <mint> <sol> | Buy/sell quote |
| /curve <mint> | Bonding curve state |
| /events | Recent event stream |
The bot manager handles lifecycle for sub-bots:
import { BotManager, EventBus } from "nanosolana";
const eventBus = new EventBus(5000);
const manager = new BotManager(eventBus);
await manager.start("telegram-bot");
await manager.start("swarm-bot");
manager.startHealthChecks();
// Route events
eventBus.on("alert:whale", (event) => {
console.log("Whale detected:", event.data);
});
development
Formally verify programs by writing Lean 4 proofs. Trigger this skill whenever the user wants to formally verify code, generate Lean 4 proofs, prove properties about algorithms or smart contracts, verify invariants, convert program logic into formal specifications, or anything involving Lean 4 and formal verification. Also trigger when the user mentions "qedgen", "lean proof", "formal proof", "verify my code", "prove correctness", "formal verification", or wants mathematical guarantees about their implementation.
tools
End-to-end Solana development playbook (Jan 2026). Prefer Solana Foundation framework-kit (@solana/client + @solana/react-hooks) for React/Next.js UI. Prefer @solana/kit for all new client/RPC/transaction code. When legacy dependencies require web3.js, isolate it behind @solana/web3-compat (or @solana/web3.js as a true legacy fallback). Covers wallet-standard-first connection (incl. ConnectorKit), Anchor/Pinocchio programs, Codama-based client generation, LiteSVM/Mollusk/Surfpool testing, and security checklists.
tools
Buy and sell tokens on Pump.fun bonding curves and AMM pools
development
Launch new tokens on Pump.fun directly via the Pump SDK