How do I install the Clawdex skill?

Run npx skillmds@latest add dvcrn/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?

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

Clawdex by dvcrn — Agent Skill

Name: Clawdex
Rating: 4.666666666666667 (3 reviews)
Author: dvcrn

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 SkillTrade any Solana token through Jupiter aggregator with simulation, safety guardrails, and full JSON output.## PrerequisitesBefore using this skill, ensure ClawDex is installed and configured:```bashwhich clawdex || npm install -g clawdex@latest```If not configured yet, run onboarding:```bashclawdex status --json```If status fails, set up with:```bashclawdex 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```bashclawdex 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)```bashclawdex quote --in SOL --out USDC --amount 0.01 --json```Lightweight price check — no simulation, no wallet needed.### Simulate a swap (dry run)```bashclawdex 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```bashclawdex 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```bashclawdex status --json```Verify RPC connectivity, wallet validity, and config state.## Trading WorkflowAlways follow this sequence:1. **Health check** — `clawdex status --json` — abort if `rpc.healthy` is false2. **Check balances** — `clawdex balances --json` — verify sufficient funds3. **Simulate** — `clawdex swap --simulate-only --json` — preview the trade4. **Execute** — `clawdex swap --yes --json` — only if simulation looks good5. **Verify** — `clawdex balances --json` — confirm balances updated (may need 5s delay on public RPC)## Token SpecificationTokens 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 |## SafetySet guardrails to prevent runaway trades:```bashclawdex 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