[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M78BE80ESYVK8TT3SCSABV82":3,"skill-same:01M78BE80ESYVK8TT3SCSABV82":66},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":29,"commitSha":30,"skillDirectory":31,"forksCount":14,"repositoryHtmlUrl":32,"repositoryHomepageUrl":33,"ownerHtmlUrl":34,"ownerBlogUrl":35,"ownerDescription":36,"updatedAt":37,"install":38,"resources":51},"01M78BE80ESYVK8TT3SCSABV82","swap-planner",null,"This skill should be used when the user asks to \"swap tokens\", \"trade ETH for USDC\", \"exchange tokens on Uniswap\", \"buy tokens\", \"sell tokens\", \"convert ETH to stablecoins\", \"find memecoins\", \"discover tokens\", \"research tokens\", \"tokens to buy\", \"find tokens to swap\", \"what should I buy\", or mentions swapping, trading, researching, discovering, buying, or exchanging tokens on any Uniswap-supported chain. Supports both known token swaps and token discovery workflows (discovery uses keyword search and web search — there is no live \"trending\" feed). Generates deep links to execute swaps in the Uniswap interface.","Solizardking\u002Fskillhub-main","Solizardking","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F108096810?v=4","01M786KDB10AYV042N0F9BD5B5","Clawd","01M786NYYXSZK1D05WM8JQPC48",0,"MIT","https:\u002F\u002Fgithub.com\u002FSolizardking\u002Fskillhub-main\u002Fblob\u002Fmain\u002Fpublic\u002Fapi\u002Fskills\u002Fswap-planner\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: swap-planner\ndescription: This skill should be used when the user asks to \"swap tokens\", \"trade ETH for USDC\", \"exchange tokens on Uniswap\", \"buy tokens\", \"sell tokens\", \"convert ETH to stablecoins\", \"find memecoins\", \"discover tokens\", \"research tokens\", \"tokens to buy\", \"find tokens to swap\", \"what should I buy\", or mentions swapping, trading, researching, discovering, buying, or exchanging tokens on any Uniswap-supported chain. Supports both known token swaps and token discovery workflows (discovery uses keyword search and web search — there is no live \"trending\" feed). Generates deep links to execute swaps in the Uniswap interface.\nallowed-tools: Read, Glob, Grep, Bash(curl:*), Bash(jq:*), Bash(cast:*), Bash(xdg-open:*), Bash(open:*), WebFetch, WebSearch, Task(subagent_type:Explore), AskUserQuestion\nmodel: sonnet\nlicense: MIT\nmetadata:\n  author: uniswap\n  version: '0.2.1'\n---\n\n# Swap Planning\n\nPlan and generate deep links for token swaps on Uniswap across all supported chains.\n\n> **Runtime Compatibility:** This skill uses `AskUserQuestion` for interactive prompts. If `AskUserQuestion` is not available in your runtime, collect the same parameters through natural language conversation instead.\n\n## Overview\n\nPlan token swaps by:\n\n1. Gathering swap intent (tokens, amounts, chain)\n2. Verifying token contracts on-chain\n3. Researching tokens via web search when needed\n4. Generating a deep link that opens in the Uniswap interface with parameters pre-filled\n\nThe generated link opens Uniswap with all parameters ready for execution.\n\n> **Note:** Browser opening (`xdg-open`\u002F`open`) may fail in SSH, containerized, or headless environments. Always display the URL prominently so users can copy and access it manually if needed.\n\n> **File Access:** This skill has read-only filesystem access. Never read files outside the current project directory unless explicitly requested by the user.\n\n## Workflow\n\n### Step 0: Token Discovery (When Needed)\n\nIf the user wants to **discover** tokens rather than swap a known token (e.g., \"find me a memecoin\", \"what's trending on Base\"), help them explore before proceeding to the swap.\n\n#### Option A: Search by Keyword\n\nDexScreener search works best with specific terms:\n\n```bash\n# Search for tokens by name\u002Fcategory (e.g., \"degen\", \"pepe\", \"ai agent\")\ncurl -s \"https:\u002F\u002Fapi.dexscreener.com\u002Flatest\u002Fdex\u002Fsearch?q=degen\" | \\\n  jq '[.pairs[] | select(.chainId == \"base\" and .dexId == \"uniswap\")] |\n    sort_by(-.volume.h24) | .[0:5] | map({\n      token: .baseToken.symbol,\n      address: .baseToken.address,\n      price: .priceUsd,\n      volume24h: .volume.h24,\n      liquidity: .liquidity.usd\n    })'\n```\n\n**Good search terms:** `degen`, `pepe`, `ai`, `agent`, `meme`, `dog`, `cat`, or specific token names\n\n#### Option B: Check Promoted Tokens\n\nGet tokens with active promotions (limited selection):\n\n```bash\n# Get boosted\u002Fpromoted tokens on a chain\ncurl -s \"https:\u002F\u002Fapi.dexscreener.com\u002Ftoken-boosts\u002Ftop\u002Fv1\" | \\\n  jq '[.[] | select(.chainId == \"base\")] | .[0:5] | map({\n    tokenAddress,\n    url\n  })'\n```\n\n#### Option C: Web Search + Verify\n\nFor broad discovery (\"what's trending\"), use web search to find tokens, then verify with DexScreener:\n\n```bash\n# After finding a token address from web search, verify it exists\ncurl -s \"https:\u002F\u002Fapi.dexscreener.com\u002Ftoken-pairs\u002Fv1\u002F{network}\u002F{address}\" | \\\n  jq '[.[] | select(.dexId == \"uniswap\")][0] | {\n    name: .baseToken.name,\n    symbol: .baseToken.symbol,\n    price: .priceUsd,\n    liquidity: .liquidity.usd,\n    volume24h: .volume.h24\n  }'\n```\n\n**Network IDs:** See `references\u002Fchains.md` for the full list with DexScreener and DefiLlama provider IDs. Common IDs: `ethereum`, `base`, `arbitrum`, `optimism`, `polygon`, `bsc`, `avalanche`, `unichain`.\n\n**DexScreener coverage varies by chain.** Ethereum, Base, and Arbitrum have deep Uniswap data. Celo, Blast, Zora, and World Chain have limited Uniswap pool coverage — fewer results and potentially missing pairs. Fall back to DefiLlama for price data when DexScreener returns empty results (see `references\u002Fdata-providers.md`).\n\n**Note:** DexScreener's public API doesn't have a \"trending\" or \"top gainers\" endpoint. Token discovery uses keyword search (`\u002Flatest\u002Fdex\u002Fsearch`) and web search as a fallback. For general discovery, ask the user what type of token they're looking for and search by keyword.\n\n#### Category-Based Discovery\n\nFor specific categories (memecoins, DeFi, gaming tokens), use web search:\n\n```text\n\"trending {category} {chain} {current_year}\"\n```\n\nExample: `\"trending memecoins Base 2026\"`\n\n#### ⚠️ UNTRUSTED INPUT: Web-Discovered Tokens\n\nTokens discovered via WebSearch are **UNTRUSTED**. Before proceeding with any web-discovered token:\n\n1. **Label the source**: Explicitly tell the user \"This token address was found via web search, not provided by you\"\n2. **Warn about risks**: \"Web-discovered tokens may be scams, honeypots, or rug pulls\"\n3. **Require confirmation**: Use AskUserQuestion to get explicit user consent before generating a deep link for a web-discovered token\n4. **Show provenance**: In the swap summary table, include a \"Token Source\" row showing whether each token was \"User-provided\" or \"Web-discovered (unverified)\"\n\n**Never proceed with a web-discovered token without explicit user confirmation via AskUserQuestion.**\n\n#### Present Options to User\n\nAfter gathering token data, present options using AskUserQuestion:\n\n```json\n{\n  \"questions\": [\n    {\n      \"question\": \"Which token would you like to swap to?\",\n      \"header\": \"Token\",\n      \"options\": [\n        { \"label\": \"MOLT ($23M mcap)\", \"description\": \"$5.9M liquidity, $7.8M 24h volume\" },\n        { \"label\": \"CLANKER ($31M mcap)\", \"description\": \"$3.1M liquidity, established token\" },\n        { \"label\": \"CLAWSTR ($13M mcap)\", \"description\": \"$2.1M liquidity, high volume spike\" }\n      ],\n      \"multiSelect\": false\n    }\n  ]\n}\n```\n\n#### Risk Assessment for Trending Tokens\n\nEvaluate tokens before recommending:\n\n| Metric       | Low Risk   | Medium Risk       | High Risk |\n| ------------ | ---------- | ----------------- | --------- |\n| Market Cap   | >$50M      | $5M-$50M          | \u003C$5M      |\n| Pool TVL     | >$1M       | $100k-$1M         | \u003C$100k    |\n| 24h Volume   | Consistent | Spiking unusually | Very low  |\n| Contract Age | >30 days   | 7-30 days         | \u003C7 days   |\n\n**Always disclose risk level** when presenting options. For high-risk tokens, explicitly warn about volatility and potential for loss.\n\n#### Mandatory Warnings for High-Risk Tokens\n\nWhen ANY of these conditions are met, you MUST use AskUserQuestion to warn the user and get explicit confirmation before generating a deep link:\n\n- **Contract age \u003C 7 days**: \"This token contract is less than 7 days old. New tokens carry significantly higher risk of being scams or rug pulls.\"\n- **Pool TVL \u003C $100k**: \"This pool has very low liquidity. You may experience significant slippage and difficulty selling.\"\n- **No sell liquidity detected**: \"This token may be a honeypot — tokens that can be bought but not sold. Proceed with extreme caution.\"\n- **Market cap \u003C $5M**: \"This is a micro-cap token with high volatility. Only invest what you can afford to lose entirely.\"\n\nDo NOT generate a deep link for high-risk tokens without explicit user acknowledgment via AskUserQuestion.\n\n---\n\n### Step 1: Gather Swap Intent\n\nExtract from the user's request:\n\n| Parameter    | Required                | Example                   |\n| ------------ | ----------------------- | ------------------------- |\n| Input token  | Yes                     | ETH, USDC, token address  |\n| Output token | Yes                     | USDC, WBTC, token address |\n| Amount       | Yes                     | 1.5 ETH, $500 worth       |\n| Chain        | Yes (default: Ethereum) | Base, Arbitrum, etc.      |\n\n**If any required parameter is missing, use AskUserQuestion with structured options:**\n\nFor missing chain:\n\n```json\n{\n  \"questions\": [\n    {\n      \"question\": \"Which chain do you want to swap on?\",\n      \"header\": \"Chain\",\n      \"options\": [\n        { \"label\": \"Base (Recommended)\", \"description\": \"Low gas fees, fast transactions\" },\n        { \"label\": \"Ethereum\", \"description\": \"Main network, higher gas\" },\n        { \"label\": \"Arbitrum\", \"description\": \"Low fees, Ethereum L2\" },\n        { \"label\": \"Optimism\", \"description\": \"Low fees, Ethereum L2\" }\n      ],\n      \"multiSelect\": false\n    }\n  ]\n}\n```\n\nFor missing output token (when input is ETH):\n\n```json\n{\n  \"questions\": [\n    {\n      \"question\": \"What token do you want to receive?\",\n      \"header\": \"Output\",\n      \"options\": [\n        { \"label\": \"USDC\", \"description\": \"USD stablecoin\" },\n        { \"label\": \"USDT\", \"description\": \"Tether stablecoin\" },\n        { \"label\": \"DAI\", \"description\": \"Decentralized stablecoin\" },\n        { \"label\": \"WBTC\", \"description\": \"Wrapped Bitcoin\" }\n      ],\n      \"multiSelect\": false\n    }\n  ]\n}\n```\n\nFor missing amount:\n\n```json\n{\n  \"questions\": [\n    {\n      \"question\": \"How much do you want to swap?\",\n      \"header\": \"Amount\",\n      \"options\": [\n        { \"label\": \"0.1 ETH\", \"description\": \"~$320\" },\n        { \"label\": \"0.5 ETH\", \"description\": \"~$1,600\" },\n        { \"label\": \"1 ETH\", \"description\": \"~$3,200\" },\n        { \"label\": \"Custom amount\", \"description\": \"Enter specific amount\" }\n      ],\n      \"multiSelect\": false\n    }\n  ]\n}\n```\n\nAlways use forms instead of plain text questions for better UX.\n\n### Step 2: Resolve Token Addresses\n\nFor token symbols, resolve to addresses using known tokens or web search:\n\n**Native tokens**: Use `NATIVE` as the address parameter.\n\n**Common tokens by chain** - see `..\u002F..\u002Freferences\u002Fchains.md` for full list:\n\n| Token | Ethereum                                     | Base                                         | Arbitrum                                     |\n| ----- | -------------------------------------------- | -------------------------------------------- | -------------------------------------------- |\n| USDC  | `0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48` | `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913` | `0xaf88d065e77c8cC2239327C5EDb3A432268e5831` |\n| WETH  | `0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2` | `0x4200000000000000000000000000000000000006` | `0x82aF49447D8a07e3bd95BD0d56f35241523fBab1` |\n| WBTC  | `0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599` | N\u002FA                                          | `0x2f2a2543B76A4166549F7aaB2e75Bef0aefC5B0f` |\n\nFor unknown tokens, use web search to find the contract address, then verify on-chain.\n\n### Step 3: Verify Token Contracts (Basic)\n\n**Input Validation (Required Before Any Shell Command):**\n\nBefore interpolating user-provided values into any shell command, validate all inputs:\n\n- **Token addresses** MUST match: `^0x[a-fA-F0-9]{40}$`\n- **Chain\u002Fnetwork names** MUST be from the allowed list in `..\u002F..\u002Freferences\u002Fchains.md`\n- **Amounts** MUST be valid decimal numbers (match: `^[0-9]+\\.?[0-9]*$`)\n- **Reject** any input containing shell metacharacters (`;`, `|`, `$`, `` ` ``, `&`, `(`, `)`, `>`, `\u003C`, `\\`, `'`, `\"`, newlines)\n\nVerify token contracts exist on-chain using curl (RPC call):\n\n```bash\n# Check if address is a contract using eth_getCode\n# IMPORTANT: Validate token_address matches ^0x[a-fA-F0-9]{40}$ before use\ncurl -s -X POST \"$rpc_url\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d \"$(jq -n --arg addr \"$token_address\" '{\"jsonrpc\":\"2.0\",\"method\":\"eth_getCode\",\"params\":[$addr,\"latest\"],\"id\":1}')\" \\\n  | jq -r '.result'\n```\n\nIf the result is `0x` or empty, the address is not a valid contract.\n\n**Alternative with cast** (optional, requires [Foundry](https:\u002F\u002Fbook.getfoundry.sh\u002F)):\n\n```bash\n# Validate token_address matches ^0x[a-fA-F0-9]{40}$ before use\ncast code \"$token_address\" --rpc-url \"$rpc_url\"\n```\n\n**Note:** The curl\u002FRPC method above is preferred for broader compatibility. Only use `cast` if already available in the environment. This skill ONLY uses `cast code` for contract verification. Do not use any other cast subcommands. The PreToolUse hook in `.claude\u002Fhooks\u002Fvalidate-forge-cast.sh` enforces this programmatically.\n\n**RPC URLs by chain** - see `..\u002F..\u002Freferences\u002Fchains.md` for full list.\n\n### Step 4: Research (If Needed)\n\nFor unfamiliar tokens, use web search to research:\n\n- Token legitimacy and project info\n- Recent news or security concerns\n- Liquidity availability on Uniswap\n\nInclude relevant findings in the summary.\n\n### Step 5: Fetch Price Data\n\nBefore generating the deep link, fetch current prices to estimate swap output. See `references\u002Fdata-providers.md` for full API details.\n\n**Quick price lookup with DexScreener:**\n\n```bash\n# Get token price and pool liquidity\ncurl -s \"https:\u002F\u002Fapi.dexscreener.com\u002Ftoken-pairs\u002Fv1\u002F{network}\u002F{address}\" | \\\n  jq '[.[] | select(.dexId == \"uniswap\")][0] | {\n    price: .priceUsd,\n    liquidity: .liquidity.usd,\n    volume24h: .volume.h24\n  }'\n```\n\n**Network IDs:** `ethereum`, `base`, `arbitrum`, `optimism`, `polygon`, `bsc`, `avalanche`, `unichain`\n\n**Liquidity warnings:**\n\n| Pool TVL    | Risk Level | Action                        |\n| ----------- | ---------- | ----------------------------- |\n| > $1M       | Low        | Proceed normally              |\n| $100k - $1M | Medium     | Note potential slippage       |\n| \u003C $100k     | High       | Warn user about slippage risk |\n\nIf API is unavailable, fall back to DefiLlama or web search for price estimates.\n\n### Step 6: Generate Deep Link\n\nConstruct the Uniswap swap URL:\n\n```text\nhttps:\u002F\u002Fapp.uniswap.org\u002Fswap?chain={chain}&inputCurrency={input}&outputCurrency={output}&value={amount}&field=INPUT\n```\n\n**URL Parameters:**\n\n| Parameter        | Description                  | Values                                                                                                                       |\n| ---------------- | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| `chain`          | Network name                 | `ethereum`, `base`, `arbitrum`, `optimism`, `polygon`, `bnb`, `avalanche`, `celo`, `blast`, `zora`, `unichain`, `worldchain` |\n| `inputCurrency`  | Input token                  | Address or `NATIVE`                                                                                                          |\n| `outputCurrency` | Output token                 | Address or `NATIVE`                                                                                                          |\n| `value`          | Amount                       | Decimal number (e.g., `1.5`)                                                                                                 |\n| `field`          | Which field value applies to | `INPUT` or `OUTPUT`                                                                                                          |\n\n### Step 7: Present Output and Open Browser\n\nFormat the response with:\n\n1. **Summary** of the swap parameters\n2. **Deep link** URL (displayed for reference)\n3. **Notes** about risks or considerations\n4. **Open the browser** automatically using system command\n\n**Example output format:**\n\n```markdown\n## Swap Summary\n\n| Parameter        | Value                      |\n| ---------------- | -------------------------- |\n| From             | 1 ETH                      |\n| To               | USDC                       |\n| Chain            | Base                       |\n| Current Rate     | ~3,200 USDC per ETH        |\n| Estimated Output | ~3,200 USDC                |\n| Pool Liquidity   | $15.2M (Low slippage risk) |\n\n### Notes\n\n- Final amount depends on current market price\n- Default slippage is 0.5% - adjust in Uniswap if needed\n- Review all details in Uniswap before confirming\n\nOpening Uniswap in your browser...\n```\n\n**After displaying the summary, open the URL in the browser:**\n\n```bash\n# Linux\nxdg-open \"https:\u002F\u002Fapp.uniswap.org\u002Fswap?chain=base&inputCurrency=NATIVE&outputCurrency=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&value=1&field=INPUT\"\n\n# macOS\nopen \"https:\u002F\u002Fapp.uniswap.org\u002Fswap?...\"\n```\n\n**Environment limitations:** Browser opening may fail in remote SSH, containerized, or headless environments. If `xdg-open`\u002F`open` fails, display the full URL prominently so users can copy and paste it manually:\n\n```markdown\n**[Click here to open in Uniswap](https:\u002F\u002Fapp.uniswap.org\u002Fswap?...)**\n\nOr copy this URL: `https:\u002F\u002Fapp.uniswap.org\u002Fswap?...`\n```\n\nAlways present the summary and URL so users can review and execute.\n\n## Important Considerations\n\n### Slippage\n\nThe deep link uses Uniswap's default slippage (0.5%). For volatile tokens or large trades, advise users to adjust slippage in the interface.\n\n### Gas Estimation\n\nGas costs vary by chain and network congestion. Base and Arbitrum typically have lower gas than Ethereum mainnet.\n\n### Token Verification\n\nAlways verify token contracts before generating links. Scam tokens often use similar names to legitimate tokens.\n\n### Price Impact\n\nFor large trades, warn users about potential price impact. Suggest splitting into smaller trades if impact would be significant.\n\n## Supported Chains\n\nAll chains supported by the Uniswap interface:\n\n- Ethereum Mainnet (`ethereum`)\n- Base (`base`)\n- Arbitrum One (`arbitrum`)\n- Optimism (`optimism`)\n- Polygon (`polygon`)\n- BNB Chain (`bnb`)\n- Avalanche (`avalanche`)\n- Celo (`celo`)\n- Blast (`blast`)\n- Zora (`zora`)\n- World Chain (`worldchain`)\n- Unichain (`unichain`)\n\n## Additional Resources\n\n### Reference Files\n\n- **`..\u002F..\u002Freferences\u002Fchains.md`** - Chain IDs, RPC URLs, native tokens, common token addresses\n- **`references\u002Fdata-providers.md`** - DexScreener and DefiLlama APIs for prices and liquidity\n\n### Examples\n\nCommon swap scenarios:\n\n- ETH → USDC on Ethereum\n- ETH → USDC on Base (lower gas)\n- USDC → WBTC on Arbitrum\n","# Swap Planning\n\nPlan and generate deep links for token swaps on Uniswap across all supported chains.\n\n> **Runtime Compatibility:** This skill uses `AskUserQuestion` for interactive prompts. If `AskUserQuestion` is not available in your runtime, collect the same parameters through natural language conversation instead.\n\n## Overview\n\nPlan token swaps by:\n\n1. Gathering swap intent (tokens, amounts, chain)\n2. Verifying token contracts on-chain\n3. Researching tokens via web search when needed\n4. Generating a deep link that opens in the Uniswap interface with parameters pre-filled\n\nThe generated link opens Uniswap with all parameters ready for execution.\n\n> **Note:** Browser opening (`xdg-open`\u002F`open`) may fail in SSH, containerized, or headless environments. Always display the URL prominently so users can copy and access it manually if needed.\n\n> **File Access:** This skill has read-only filesystem access. Never read files outside the current project directory unless explicitly requested by the user.\n\n## Workflow\n\n### Step 0: Token Discovery (When Needed)\n\nIf the user wants to **discover** tokens rather than swap a known token (e.g., \"find me a memecoin\", \"what's trending on Base\"), help them explore before proceeding to the swap.\n\n#### Option A: Search by Keyword\n\nDexScreener search works best with specific terms:\n\n```bash\n# Search for tokens by name\u002Fcategory (e.g., \"degen\", \"pepe\", \"ai agent\")\ncurl -s \"https:\u002F\u002Fapi.dexscreener.com\u002Flatest\u002Fdex\u002Fsearch?q=degen\" | \\\n  jq '[.pairs[] | select(.chainId == \"base\" and .dexId == \"uniswap\")] |\n    sort_by(-.volume.h24) | .[0:5] | map({\n      token: .baseToken.symbol,\n      address: .baseToken.address,\n      price: .priceUsd,\n      volume24h: .volume.h24,\n      liquidity: .liquidity.usd\n    })'\n```\n\n**Good search terms:** `degen`, `pepe`, `ai`, `agent`, `meme`, `dog`, `cat`, or specific token names\n\n#### Option B: Check Promoted Tokens\n\nGet tokens with active promotions (limited selection):\n\n```bash\n# Get boosted\u002Fpromoted tokens on a chain\ncurl -s \"https:\u002F\u002Fapi.dexscreener.com\u002Ftoken-boosts\u002Ftop\u002Fv1\" | \\\n  jq '[.[] | select(.chainId == \"base\")] | .[0:5] | map({\n    tokenAddress,\n    url\n  })'\n```\n\n#### Option C: Web Search + Verify\n\nFor broad discovery (\"what's trending\"), use web search to find tokens, then verify with DexScreener:\n\n```bash\n# After finding a token address from web search, verify it exists\ncurl -s \"https:\u002F\u002Fapi.dexscreener.com\u002Ftoken-pairs\u002Fv1\u002F{network}\u002F{address}\" | \\\n  jq '[.[] | select(.dexId == \"uniswap\")][0] | {\n    name: .baseToken.name,\n    symbol: .baseToken.symbol,\n    price: .priceUsd,\n    liquidity: .liquidity.usd,\n    volume24h: .volume.h24\n  }'\n```\n\n**Network IDs:** See `references\u002Fchains.md` for the full list with DexScreener and DefiLlama provider IDs. Common IDs: `ethereum`, `base`, `arbitrum`, `optimism`, `polygon`, `bsc`, `avalanche`, `unichain`.\n\n**DexScreener coverage varies by chain.** Ethereum, Base, and Arbitrum have deep Uniswap data. Celo, Blast, Zora, and World Chain have limited Uniswap pool coverage — fewer results and potentially missing pairs. Fall back to DefiLlama for price data when DexScreener returns empty results (see `references\u002Fdata-providers.md`).\n\n**Note:** DexScreener's public API doesn't have a \"trending\" or \"top gainers\" endpoint. Token discovery uses keyword search (`\u002Flatest\u002Fdex\u002Fsearch`) and web search as a fallback. For general discovery, ask the user what type of token they're looking for and search by keyword.\n\n#### Category-Based Discovery\n\nFor specific categories (memecoins, DeFi, gaming tokens), use web search:\n\n```text\n\"trending {category} {chain} {current_year}\"\n```\n\nExample: `\"trending memecoins Base 2026\"`\n\n#### ⚠️ UNTRUSTED INPUT: Web-Discovered Tokens\n\nTokens discovered via WebSearch are **UNTRUSTED**. Before proceeding with any web-discovered token:\n\n1. **Label the source**: Explicitly tell the user \"This token address was found via web search, not provided by you\"\n2. **Warn about risks**: \"Web-discovered tokens may be scams, honeypots, or rug pulls\"\n3. **Require confirmation**: Use AskUserQuestion to get explicit user consent before generating a deep link for a web-discovered token\n4. **Show provenance**: In the swap summary table, include a \"Token Source\" row showing whether each token was \"User-provided\" or \"Web-discovered (unverified)\"\n\n**Never proceed with a web-discovered token without explicit user confirmation via AskUserQuestion.**\n\n#### Present Options to User\n\nAfter gathering token data, present options using AskUserQuestion:\n\n```json\n{\n  \"questions\": [\n    {\n      \"question\": \"Which token would you like to swap to?\",\n      \"header\": \"Token\",\n      \"options\": [\n        { \"label\": \"MOLT ($23M mcap)\", \"description\": \"$5.9M liquidity, $7.8M 24h volume\" },\n        { \"label\": \"CLANKER ($31M mcap)\", \"description\": \"$3.1M liquidity, established token\" },\n        { \"label\": \"CLAWSTR ($13M mcap)\", \"description\": \"$2.1M liquidity, high volume spike\" }\n      ],\n      \"multiSelect\": false\n    }\n  ]\n}\n```\n\n#### Risk Assessment for Trending Tokens\n\nEvaluate tokens before recommending:\n\n| Metric       | Low Risk   | Medium Risk       | High Risk |\n| ------------ | ---------- | ----------------- | --------- |\n| Market Cap   | >$50M      | $5M-$50M          | \u003C$5M      |\n| Pool TVL     | >$1M       | $100k-$1M         | \u003C$100k    |\n| 24h Volume   | Consistent | Spiking unusually | Very low  |\n| Contract Age | >30 days   | 7-30 days         | \u003C7 days   |\n\n**Always disclose risk level** when presenting options. For high-risk tokens, explicitly warn about volatility and potential for loss.\n\n#### Mandatory Warnings for High-Risk Tokens\n\nWhen ANY of these conditions are met, you MUST use AskUserQuestion to warn the user and get explicit confirmation before generating a deep link:\n\n- **Contract age \u003C 7 days**: \"This token contract is less than 7 days old. New tokens carry significantly higher risk of being scams or rug pulls.\"\n- **Pool TVL \u003C $100k**: \"This pool has very low liquidity. You may experience significant slippage and difficulty selling.\"\n- **No sell liquidity detected**: \"This token may be a honeypot — tokens that can be bought but not sold. Proceed with extreme caution.\"\n- **Market cap \u003C $5M**: \"This is a micro-cap token with high volatility. Only invest what you can afford to lose entirely.\"\n\nDo NOT generate a deep link for high-risk tokens without explicit user acknowledgment via AskUserQuestion.\n\n---\n\n### Step 1: Gather Swap Intent\n\nExtract from the user's request:\n\n| Parameter    | Required                | Example                   |\n| ------------ | ----------------------- | ------------------------- |\n| Input token  | Yes                     | ETH, USDC, token address  |\n| Output token | Yes                     | USDC, WBTC, token address |\n| Amount       | Yes                     | 1.5 ETH, $500 worth       |\n| Chain        | Yes (default: Ethereum) | Base, Arbitrum, etc.      |\n\n**If any required parameter is missing, use AskUserQuestion with structured options:**\n\nFor missing chain:\n\n```json\n{\n  \"questions\": [\n    {\n      \"question\": \"Which chain do you want to swap on?\",\n      \"header\": \"Chain\",\n      \"options\": [\n        { \"label\": \"Base (Recommended)\", \"description\": \"Low gas fees, fast transactions\" },\n        { \"label\": \"Ethereum\", \"description\": \"Main network, higher gas\" },\n        { \"label\": \"Arbitrum\", \"description\": \"Low fees, Ethereum L2\" },\n        { \"label\": \"Optimism\", \"description\": \"Low fees, Ethereum L2\" }\n      ],\n      \"multiSelect\": false\n    }\n  ]\n}\n```\n\nFor missing output token (when input is ETH):\n\n```json\n{\n  \"questions\": [\n    {\n      \"question\": \"What token do you want to receive?\",\n      \"header\": \"Output\",\n      \"options\": [\n        { \"label\": \"USDC\", \"description\": \"USD stablecoin\" },\n        { \"label\": \"USDT\", \"description\": \"Tether stablecoin\" },\n        { \"label\": \"DAI\", \"description\": \"Decentralized stablecoin\" },\n        { \"label\": \"WBTC\", \"description\": \"Wrapped Bitcoin\" }\n      ],\n      \"multiSelect\": false\n    }\n  ]\n}\n```\n\nFor missing amount:\n\n```json\n{\n  \"questions\": [\n    {\n      \"question\": \"How much do you want to swap?\",\n      \"header\": \"Amount\",\n      \"options\": [\n        { \"label\": \"0.1 ETH\", \"description\": \"~$320\" },\n        { \"label\": \"0.5 ETH\", \"description\": \"~$1,600\" },\n        { \"label\": \"1 ETH\", \"description\": \"~$3,200\" },\n        { \"label\": \"Custom amount\", \"description\": \"Enter specific amount\" }\n      ],\n      \"multiSelect\": false\n    }\n  ]\n}\n```\n\nAlways use forms instead of plain text questions for better UX.\n\n### Step 2: Resolve Token Addresses\n\nFor token symbols, resolve to addresses using known tokens or web search:\n\n**Native tokens**: Use `NATIVE` as the address parameter.\n\n**Common tokens by chain** - see `..\u002F..\u002Freferences\u002Fchains.md` for full list:\n\n| Token | Ethereum                                     | Base                                         | Arbitrum                                     |\n| ----- | -------------------------------------------- | -------------------------------------------- | -------------------------------------------- |\n| USDC  | `0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48` | `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913` | `0xaf88d065e77c8cC2239327C5EDb3A432268e5831` |\n| WETH  | `0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2` | `0x4200000000000000000000000000000000000006` | `0x82aF49447D8a07e3bd95BD0d56f35241523fBab1` |\n| WBTC  | `0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599` | N\u002FA                                          | `0x2f2a2543B76A4166549F7aaB2e75Bef0aefC5B0f` |\n\nFor unknown tokens, use web search to find the contract address, then verify on-chain.\n\n### Step 3: Verify Token Contracts (Basic)\n\n**Input Validation (Required Before Any Shell Command):**\n\nBefore interpolating user-provided values into any shell command, validate all inputs:\n\n- **Token addresses** MUST match: `^0x[a-fA-F0-9]{40}$`\n- **Chain\u002Fnetwork names** MUST be from the allowed list in `..\u002F..\u002Freferences\u002Fchains.md`\n- **Amounts** MUST be valid decimal numbers (match: `^[0-9]+\\.?[0-9]*$`)\n- **Reject** any input containing shell metacharacters (`;`, `|`, `$`, `` ` ``, `&`, `(`, `)`, `>`, `\u003C`, `\\`, `'`, `\"`, newlines)\n\nVerify token contracts exist on-chain using curl (RPC call):\n\n```bash\n# Check if address is a contract using eth_getCode\n# IMPORTANT: Validate token_address matches ^0x[a-fA-F0-9]{40}$ before use\ncurl -s -X POST \"$rpc_url\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d \"$(jq -n --arg addr \"$token_address\" '{\"jsonrpc\":\"2.0\",\"method\":\"eth_getCode\",\"params\":[$addr,\"latest\"],\"id\":1}')\" \\\n  | jq -r '.result'\n```\n\nIf the result is `0x` or empty, the address is not a valid contract.\n\n**Alternative with cast** (optional, requires [Foundry](https:\u002F\u002Fbook.getfoundry.sh\u002F)):\n\n```bash\n# Validate token_address matches ^0x[a-fA-F0-9]{40}$ before use\ncast code \"$token_address\" --rpc-url \"$rpc_url\"\n```\n\n**Note:** The curl\u002FRPC method above is preferred for broader compatibility. Only use `cast` if already available in the environment. This skill ONLY uses `cast code` for contract verification. Do not use any other cast subcommands. The PreToolUse hook in `.claude\u002Fhooks\u002Fvalidate-forge-cast.sh` enforces this programmatically.\n\n**RPC URLs by chain** - see `..\u002F..\u002Freferences\u002Fchains.md` for full list.\n\n### Step 4: Research (If Needed)\n\nFor unfamiliar tokens, use web search to research:\n\n- Token legitimacy and project info\n- Recent news or security concerns\n- Liquidity availability on Uniswap\n\nInclude relevant findings in the summary.\n\n### Step 5: Fetch Price Data\n\nBefore generating the deep link, fetch current prices to estimate swap output. See `references\u002Fdata-providers.md` for full API details.\n\n**Quick price lookup with DexScreener:**\n\n```bash\n# Get token price and pool liquidity\ncurl -s \"https:\u002F\u002Fapi.dexscreener.com\u002Ftoken-pairs\u002Fv1\u002F{network}\u002F{address}\" | \\\n  jq '[.[] | select(.dexId == \"uniswap\")][0] | {\n    price: .priceUsd,\n    liquidity: .liquidity.usd,\n    volume24h: .volume.h24\n  }'\n```\n\n**Network IDs:** `ethereum`, `base`, `arbitrum`, `optimism`, `polygon`, `bsc`, `avalanche`, `unichain`\n\n**Liquidity warnings:**\n\n| Pool TVL    | Risk Level | Action                        |\n| ----------- | ---------- | ----------------------------- |\n| > $1M       | Low        | Proceed normally              |\n| $100k - $1M | Medium     | Note potential slippage       |\n| \u003C $100k     | High       | Warn user about slippage risk |\n\nIf API is unavailable, fall back to DefiLlama or web search for price estimates.\n\n### Step 6: Generate Deep Link\n\nConstruct the Uniswap swap URL:\n\n```text\nhttps:\u002F\u002Fapp.uniswap.org\u002Fswap?chain={chain}&inputCurrency={input}&outputCurrency={output}&value={amount}&field=INPUT\n```\n\n**URL Parameters:**\n\n| Parameter        | Description                  | Values                                                                                                                       |\n| ---------------- | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| `chain`          | Network name                 | `ethereum`, `base`, `arbitrum`, `optimism`, `polygon`, `bnb`, `avalanche`, `celo`, `blast`, `zora`, `unichain`, `worldchain` |\n| `inputCurrency`  | Input token                  | Address or `NATIVE`                                                                                                          |\n| `outputCurrency` | Output token                 | Address or `NATIVE`                                                                                                          |\n| `value`          | Amount                       | Decimal number (e.g., `1.5`)                                                                                                 |\n| `field`          | Which field value applies to | `INPUT` or `OUTPUT`                                                                                                          |\n\n### Step 7: Present Output and Open Browser\n\nFormat the response with:\n\n1. **Summary** of the swap parameters\n2. **Deep link** URL (displayed for reference)\n3. **Notes** about risks or considerations\n4. **Open the browser** automatically using system command\n\n**Example output format:**\n\n```markdown\n## Swap Summary\n\n| Parameter        | Value                      |\n| ---------------- | -------------------------- |\n| From             | 1 ETH                      |\n| To               | USDC                       |\n| Chain            | Base                       |\n| Current Rate     | ~3,200 USDC per ETH        |\n| Estimated Output | ~3,200 USDC                |\n| Pool Liquidity   | $15.2M (Low slippage risk) |\n\n### Notes\n\n- Final amount depends on current market price\n- Default slippage is 0.5% - adjust in Uniswap if needed\n- Review all details in Uniswap before confirming\n\nOpening Uniswap in your browser...\n```\n\n**After displaying the summary, open the URL in the browser:**\n\n```bash\n# Linux\nxdg-open \"https:\u002F\u002Fapp.uniswap.org\u002Fswap?chain=base&inputCurrency=NATIVE&outputCurrency=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&value=1&field=INPUT\"\n\n# macOS\nopen \"https:\u002F\u002Fapp.uniswap.org\u002Fswap?...\"\n```\n\n**Environment limitations:** Browser opening may fail in remote SSH, containerized, or headless environments. If `xdg-open`\u002F`open` fails, display the full URL prominently so users can copy and paste it manually:\n\n```markdown\n**[Click here to open in Uniswap](https:\u002F\u002Fapp.uniswap.org\u002Fswap?...)**\n\nOr copy this URL: `https:\u002F\u002Fapp.uniswap.org\u002Fswap?...`\n```\n\nAlways present the summary and URL so users can review and execute.\n\n## Important Considerations\n\n### Slippage\n\nThe deep link uses Uniswap's default slippage (0.5%). For volatile tokens or large trades, advise users to adjust slippage in the interface.\n\n### Gas Estimation\n\nGas costs vary by chain and network congestion. Base and Arbitrum typically have lower gas than Ethereum mainnet.\n\n### Token Verification\n\nAlways verify token contracts before generating links. Scam tokens often use similar names to legitimate tokens.\n\n### Price Impact\n\nFor large trades, warn users about potential price impact. Suggest splitting into smaller trades if impact would be significant.\n\n## Supported Chains\n\nAll chains supported by the Uniswap interface:\n\n- Ethereum Mainnet (`ethereum`)\n- Base (`base`)\n- Arbitrum One (`arbitrum`)\n- Optimism (`optimism`)\n- Polygon (`polygon`)\n- BNB Chain (`bnb`)\n- Avalanche (`avalanche`)\n- Celo (`celo`)\n- Blast (`blast`)\n- Zora (`zora`)\n- World Chain (`worldchain`)\n- Unichain (`unichain`)\n\n## Additional Resources\n\n### Reference Files\n\n- **`..\u002F..\u002Freferences\u002Fchains.md`** - Chain IDs, RPC URLs, native tokens, common token addresses\n- **`references\u002Fdata-providers.md`** - DexScreener and DefiLlama APIs for prices and liquidity\n\n### Examples\n\nCommon swap scenarios:\n\n- ETH → USDC on Ethereum\n- ETH → USDC on Base (lower gas)\n- USDC → WBTC on Arbitrum\n",{"name":5,"model":24,"license":15,"metadata":25,"description":7,"allowed-tools":28},"sonnet",{"author":26,"version":27},"uniswap","0.2.1","Read, Glob, Grep, Bash(curl:*), Bash(jq:*), Bash(cast:*), Bash(xdg-open:*), Bash(open:*), WebFetch, WebSearch, Task(subagent_type:Explore), AskUserQuestion","main","be3de0244dc1a57e323d8160787ebb40fb64930e","public\u002Fapi\u002Fskills\u002Fswap-planner","https:\u002F\u002Fgithub.com\u002FSolizardking\u002Fskillhub-main","https:\u002F\u002Fskills.x402.wtf","https:\u002F\u002Fgithub.com\u002FSolizardking","https:\u002F\u002Fmusebook.trade","Got a mile high and never came down","2026-10-08 23:20:13",{"source":8,"skillName":5,"commands":39,"prompt":49,"zipAvailable":50},[40,43,46],{"tool":41,"command":42},"npx","npx skills add Solizardking\u002Fskillhub-main --skill swap-planner",{"tool":44,"command":45},"bunx","bunx skills add Solizardking\u002Fskillhub-main --skill swap-planner",{"tool":47,"command":48},"pnpm","pnpm dlx skills add Solizardking\u002Fskillhub-main --skill swap-planner","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FSolizardking\u002Fskillhub-main\u002Fblob\u002Fmain\u002Fpublic\u002Fapi\u002Fskills\u002Fswap-planner\u002FSKILL.md",true,[52,58,62],{"path":53,"resourceType":54,"resourceTypeDesc":55,"sizeBytes":56,"sourceHtmlUrl":57},"metadata.json","REFERENCE","参考文档",806,"https:\u002F\u002Fgithub.com\u002FSolizardking\u002Fskillhub-main\u002Fblob\u002Fmain\u002Fpublic\u002Fapi\u002Fskills\u002Fswap-planner\u002Fmetadata.json",{"path":59,"resourceType":54,"resourceTypeDesc":55,"sizeBytes":60,"sourceHtmlUrl":61},"references\u002Fdata-providers.md",6125,"https:\u002F\u002Fgithub.com\u002FSolizardking\u002Fskillhub-main\u002Fblob\u002Fmain\u002Fpublic\u002Fapi\u002Fskills\u002Fswap-planner\u002Freferences\u002Fdata-providers.md",{"path":63,"resourceType":54,"resourceTypeDesc":55,"sizeBytes":64,"sourceHtmlUrl":65},"verification.json",1652,"https:\u002F\u002Fgithub.com\u002FSolizardking\u002Fskillhub-main\u002Fblob\u002Fmain\u002Fpublic\u002Fapi\u002Fskills\u002Fswap-planner\u002Fverification.json",[67,74,81,88,95,103],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":19},"01M78E0TGCAMNPS207BA3G07S7","zkrouter","Self-hosted OpenAI-compatible LLM router — smart tier-based routing, ZK-stamped routing decisions, mode overrides, free OpenRouter at install via the Birth bot. Save 60-80% on inference costs by routing to the cheapest capable model across 12+ OpenRouter models.","https:\u002F\u002Fgithub.com\u002FSolizardking\u002Fskillhub-main\u002Fblob\u002Fmain\u002Fskills\u002Fzkrouter\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":19},"01M78E0R1Z8BDT6EDTHY17MTNB","zk","For custom ZK Solana programs and privacy-preserving applications to prevent double spending. Guide to integrate rent-free nullifier PDAs for double-spend prevention.","https:\u002F\u002Fgithub.com\u002FSolizardking\u002Fskillhub-main\u002Fblob\u002Fmain\u002Fskills\u002Fzk\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M78E0P3ZTZ1YWF8MD5MM23QE","zk-omni-messaging","Zero-knowledge omnichain messaging between Robinhood Chain and Solana using CheshireZkOmniMessenger (msgType 4) with nullifier anti-replay and the zk-omni-relayer service.","https:\u002F\u002Fgithub.com\u002FSolizardking\u002Fskillhub-main\u002Fblob\u002Fmain\u002Fskills\u002Fzk-omni-messaging\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M78E0JXZ2PNB1896VXAGDBWD","zerion-wallet-data","Use when the user asks to check a wallet's portfolio, token balances, DeFi positions, PnL, transaction history, or NFTs. Provides interpreted on-chain data across 40+ EVM chains and Solana via x402 pay-per-request or API key — no raw RPC decoding needed.","https:\u002F\u002Fgithub.com\u002FSolizardking\u002Fskillhub-main\u002Fblob\u002Fmain\u002Fskills\u002Fzerion-wallet-data\u002FSKILL.md",[],[],{"skillNo":96,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":99,"sourceHtmlUrl":100,"categories":101,"keywords":102,"publishedAt":19},"01M78E0G14FH9GRRTQYMKD5E59","youtube-clipper","YouTube 视频智能剪辑工具。下载视频和字幕，AI 分析生成精细章节（几分钟级别）， 用户选择片段后自动剪辑、翻译字幕为中英双语、烧录字幕到视频，并生成总结文案。 使用场景：当用户需要剪辑 YouTube 视频、生成短视频片段、制作双语字幕版本时。 关键词：视频剪辑、YouTube、字幕翻译、双语字幕、视频下载、clip video","https:\u002F\u002Fgithub.com\u002FSolizardking\u002Fskillhub-main\u002Fblob\u002Fmain\u002Fskills\u002Fyoutube-clipper\u002FLICENSE","https:\u002F\u002Fgithub.com\u002FSolizardking\u002Fskillhub-main\u002Fblob\u002Fmain\u002Fskills\u002Fyoutube-clipper\u002FSKILL.md",[],[],{"skillNo":104,"name":105,"nameZh":6,"description":106,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":107,"categories":108,"keywords":109,"publishedAt":19},"01M78E0C2ZYA99CFFDNB7ZMK5S","yield-optimization","Multi-chain yield optimization via yield.xyz (StakeKit). Discover 2,988+ yield opportunities across 75+ blockchains, build deposit\u002Fwithdrawal transactions with shell scripts, and sign them with a MoonPay wallet. Use when the user wants to earn yield, find the best lending or staking rate, enter\u002Fexit a position, or check portfolio balances.","https:\u002F\u002Fgithub.com\u002FSolizardking\u002Fskillhub-main\u002Fblob\u002Fmain\u002Fskills\u002Fyield-optimization\u002FSKILL.md",[],[]]