How do I install the Token Swap skill?

Run npx skillmds@latest add majiayu000/token-swap 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.

What does the Token Swap skill do?

Execute token swaps on Uniswap/PancakeSwap across multiple EVM chains. It is listed under Integrations & APIs on SkillMD.

Is Token Swap safe to use?

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

Which AI agents work with Token Swap?

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 Token Swap free to use?

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

Who published Token Swap?

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

Token Swap by majiayu000 — Agent Skill

Name: Token Swap
Rating: 4.2 (5 reviews)
Author: majiayu000

File contents

Token Swap Skill

Execute token swaps on Uniswap (V2/V3) and PancakeSwap (V2/V3) across multiple EVM chains.

Overview

Swap tokens using dedicated DEX tools that automatically compare V2 and V3 quotes to find the best price. Uses the active wallet for signing transactions.

Supported DEXes

BSC: PancakeSwap V2 + V3
Ethereum: Uniswap V2 + V3
Polygon: QuickSwap V2 + Uniswap V3
Arbitrum: Uniswap V2 + V3
Optimism: Uniswap V3
Base: Uniswap V3

Tools Used

swap_get_quote - Get best swap quote across V2/V3 with estimated output and price impact
swap_execute - Execute the swap (auto-approves token spending if needed)
swap_check_allowance - Check if token is already approved for the router
swap_supported_dexes - List available DEXes and fee tiers for a network
get_erc20_token_info - Look up token name, symbol, decimals by contract address

Workflow

User requests a swap → call swap_get_quote with tokenIn, tokenOut, amountIn
Present quote: input amount, estimated output, minimum output, slippage, DEX name, version
If price impact is high or slippage > 1%, warn the user
Ask user for explicit confirmation before proceeding
Call swap_execute with same parameters

Security Rules

ALWAYS show the swap quote before executing
ALWAYS warn if estimated output seems low (possible low liquidity)
NEVER execute swaps without explicit user confirmation
Default slippage: 0.5% — warn if user sets above 3%
For large swaps, suggest splitting into multiple smaller trades
Run security-check on the target token before executing a swap to detect honeypots and high taxes

V3 Fee Tiers

When using V3, the fee tier affects which liquidity pool is used:

0.01% (100) — stablecoin pairs
0.05% (500) — stable/common pairs
0.3% (3000) — most common, default
1% (10000) — exotic pairs

The tool auto-selects the best fee tier by default.

Example Interactions

User: "Swap 1 BNB for USDT on BSC" → Call swap_get_quote with tokenIn="native", tokenOut="0x55d398326f99059fF775485246999027B3197955", amountIn="1" → Show: "PancakeSwap V3: 1 BNB → ~590.23 USDT (min: 587.28 USDT, 0.5% slippage)" → After confirmation: call swap_execute

User: "What would I get for swapping 100 USDT to ETH on Ethereum?" → Call swap_get_quote only, display result without executing

User: "What DEXes work on Arbitrum?" → Call swap_supported_dexes with network="arbitrum"

---name: token-swapdescription: Execute token swaps on Uniswap/PancakeSwap across multiple EVM chains.--- # Token Swap Skill Execute token swaps on Uniswap (V2/V3) and PancakeSwap (V2/V3) across multiple EVM chains. ## Overview Swap tokens using dedicated DEX tools that automatically compare V2 and V3 quotes to find the best price. Uses the active wallet for signing transactions. ## Supported DEXes - **BSC**: PancakeSwap V2 + V3 - **Ethereum**: Uniswap V2 + V3 - **Polygon**: QuickSwap V2 + Uniswap V3 - **Arbitrum**: Uniswap V2 + V3 - **Optimism**: Uniswap V3 - **Base**: Uniswap V3 ## Tools Used - `swap_get_quote` - Get best swap quote across V2/V3 with estimated output and price impact - `swap_execute` - Execute the swap (auto-approves token spending if needed) - `swap_check_allowance` - Check if token is already approved for the router - `swap_supported_dexes` - List available DEXes and fee tiers for a network - `get_erc20_token_info` - Look up token name, symbol, decimals by contract address ## Workflow 1. User requests a swap → call `swap_get_quote` with tokenIn, tokenOut, amountIn 2. Present quote: input amount, estimated output, minimum output, slippage, DEX name, version 3. If price impact is high or slippage > 1%, warn the user 4. Ask user for explicit confirmation before proceeding 5. Call `swap_execute` with same parameters ## Security Rules - ALWAYS show the swap quote before executing - ALWAYS warn if estimated output seems low (possible low liquidity) - NEVER execute swaps without explicit user confirmation - Default slippage: 0.5% — warn if user sets above 3% - For large swaps, suggest splitting into multiple smaller trades - Run `security-check` on the target token before executing a swap to detect honeypots and high taxes ## V3 Fee Tiers When using V3, the fee tier affects which liquidity pool is used: - 0.01% (100) — stablecoin pairs - 0.05% (500) — stable/common pairs - 0.3% (3000) — most common, default - 1% (10000) — exotic pairs The tool auto-selects the best fee tier by default. ## Example Interactions User: "Swap 1 BNB for USDT on BSC" → Call `swap_get_quote` with tokenIn="native", tokenOut="0x55d398326f99059fF775485246999027B3197955", amountIn="1" → Show: "PancakeSwap V3: 1 BNB → ~590.23 USDT (min: 587.28 USDT, 0.5% slippage)" → After confirmation: call `swap_execute` User: "What would I get for swapping 100 USDT to ETH on Ethereum?" → Call `swap_get_quote` only, display result without executing User: "What DEXes work on Arbitrum?" → Call `swap_supported_dexes` with network="arbitrum"

Frequently asked questions

Token Swap