How do I install the Clawdex skill?

Run npx skillmds@latest add modbender/clawdex in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Clawdex safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Clawdex?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Clawdex free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Clawdex?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Clawdex by modbender — Agent Skill

Name: Clawdex
Rating: 4.2 (5 reviews)
Author: modbender

File contents

ClawDex — Solana DEX Trading Skill

Trade any Solana token through Jupiter aggregator with simulation, safety guardrails, and full JSON output.

Prerequisites

Before using this skill, ensure ClawDex is installed and configured:

which clawdex || npm install -g clawdex@latest

If not configured yet, run onboarding:

clawdex status --json

If status fails, set up with:

clawdex onboarding \
  --jupiter-api-key "$JUPITER_API_KEY" \
  --rpc "${SOLANA_RPC_URL:-https://api.mainnet-beta.solana.com}" \
  --wallet ~/.config/solana/id.json \
  --json

Commands

Check wallet balances

clawdex balances --json

Returns an array of { token, symbol, mint, balance, decimals } objects. Zero-balance accounts are included in JSON output.

Get a quote (no execution)

clawdex quote --in SOL --out USDC --amount 0.01 --json

Lightweight price check — no simulation, no wallet needed.

Simulate a swap (dry run)

clawdex swap --in SOL --out USDC --amount 0.01 --simulate-only --json

Runs full simulation on-chain without broadcasting. Does not require --yes. Use this to preview the output amount and route before committing.

Execute a swap

clawdex swap --in SOL --out USDC --amount 0.01 --yes --json

--yes is required for non-interactive execution. Without it, ClawDex exits with code 1.

Health check

clawdex status --json

Verify RPC connectivity, wallet validity, and config state.

Trading Workflow

Always follow this sequence:

Health check — clawdex status --json — abort if rpc.healthy is false
Check balances — clawdex balances --json — verify sufficient funds
Simulate — clawdex swap --simulate-only --json — preview the trade
Execute — clawdex swap --yes --json — only if simulation looks good
Verify — clawdex balances --json — confirm balances updated (may need 5s delay on public RPC)

Token Specification

Tokens can be passed by symbol or mint address:

By symbol: SOL, USDC, USDT
By mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

Exit Codes

Code	Meaning	Agent action
0	Success	Continue
1	General error	Check message
2	Config error	Run onboarding
3	Safety violation	Reduce amount or adjust limits
4	Simulation failed	Try different pair/amount
5	Send failed	Retry with backoff

Safety

Set guardrails to prevent runaway trades:

clawdex safety set max_slippage_bps=300 max_trade_sol=1 max_price_impact_bps=100

When a guardrail triggers, the JSON response includes a violations array describing what failed.

Important Rules

Always use --json for machine-parseable output
Always use --yes for real swaps (not needed for --simulate-only)
Never skip simulation unless you have a good reason — use --simulate-only first
Parse balance as a string, not a number — it preserves full decimal precision
Check exit codes — non-zero means the trade did not succeed
Wait before verifying — RPC balance reads can lag a few seconds after a swap

---name: clawdexdescription: Trade tokens on Solana using the ClawDex CLI. Use when the user asks to swap tokens, check balances, get quotes, or manage a Solana trading wallet.--- # ClawDex — Solana DEX Trading Skill Trade any Solana token through Jupiter aggregator with simulation, safety guardrails, and full JSON output. ## Prerequisites Before using this skill, ensure ClawDex is installed and configured: ```bash which clawdex || npm install -g clawdex@latest ``` If not configured yet, run onboarding: ```bash clawdex status --json ``` If status fails, set up with: ```bash clawdex onboarding \ --jupiter-api-key "$JUPITER_API_KEY" \ --rpc "${SOLANA_RPC_URL:-https://api.mainnet-beta.solana.com}" \ --wallet ~/.config/solana/id.json \ --json ``` ## Commands ### Check wallet balances ```bash clawdex balances --json ``` Returns an array of `{ token, symbol, mint, balance, decimals }` objects. Zero-balance accounts are included in JSON output. ### Get a quote (no execution) ```bash clawdex quote --in SOL --out USDC --amount 0.01 --json ``` Lightweight price check — no simulation, no wallet needed. ### Simulate a swap (dry run) ```bash clawdex swap --in SOL --out USDC --amount 0.01 --simulate-only --json ``` Runs full simulation on-chain without broadcasting. Does not require `--yes`. Use this to preview the output amount and route before committing. ### Execute a swap ```bash clawdex swap --in SOL --out USDC --amount 0.01 --yes --json ``` **`--yes` is required** for non-interactive execution. Without it, ClawDex exits with code 1. ### Health check ```bash clawdex status --json ``` Verify RPC connectivity, wallet validity, and config state. ## Trading Workflow Always follow this sequence: 1. **Health check** — `clawdex status --json` — abort if `rpc.healthy` is false 2. **Check balances** — `clawdex balances --json` — verify sufficient funds 3. **Simulate** — `clawdex swap --simulate-only --json` — preview the trade 4. **Execute** — `clawdex swap --yes --json` — only if simulation looks good 5. **Verify** — `clawdex balances --json` — confirm balances updated (may need 5s delay on public RPC) ## Token Specification Tokens can be passed by symbol or mint address: - **By symbol**: `SOL`, `USDC`, `USDT` - **By mint**: `EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v` ## Exit Codes | Code | Meaning | Agent action | |------|---------|-------------| | 0 | Success | Continue | | 1 | General error | Check message | | 2 | Config error | Run onboarding | | 3 | Safety violation | Reduce amount or adjust limits | | 4 | Simulation failed | Try different pair/amount | | 5 | Send failed | Retry with backoff | ## Safety Set guardrails to prevent runaway trades: ```bash clawdex safety set max_slippage_bps=300 max_trade_sol=1 max_price_impact_bps=100 ``` When a guardrail triggers, the JSON response includes a `violations` array describing what failed. ## Important Rules - **Always use `--json`** for machine-parseable output - **Always use `--yes`** for real swaps (not needed for `--simulate-only`) - **Never skip simulation** unless you have a good reason — use `--simulate-only` first - **Parse `balance` as a string**, not a number — it preserves full decimal precision - **Check exit codes** — non-zero means the trade did not succeed - **Wait before verifying** — RPC balance reads can lag a few seconds after a swap

Frequently asked questions

Clawdex