swap-planner

Plans token swaps and generates pre-filled Uniswap deep links across supported chains.

Updated Jul 7, 2025
One-click install
npx skills add https://github.com/Catalyst-Astro/Catalyst-Blockchain-Structural-Token- --skill swap-planner-catalyst-astro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: swap-planner
Source: https://github.com/Catalyst-Astro/Catalyst-Blockchain-Structural-Token-/tree/main/.agents/skills/swap-planner
Command: npx skills add https://github.com/Catalyst-Astro/Catalyst-Blockchain-Structural-Token- --skill swap-planner-catalyst-astro

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Planning a token swap requires finding correct contract addresses, verifying tokens on-chain, checking liquidity, and manually constructing Uniswap URLs — a process prone to errors and scam tokens. This Skill automates the entire planning workflow and produces a ready-to-execute deep link. ## Core Features & Use Cases - Swap Planning: Gathers swap intent (tokens, amount, chain), resolves token addresses, verifies contracts on-chain via RPC, and generates a pre-filled Uniswap swap URL. - Token Discovery: Searches DexScreener by keyword, checks promoted tokens, and uses web search to find tokens, with mandatory risk warnings for low-liquidity or newly deployed contracts. - Price & Liquidity Checks: Fetches real-time prices and pool TVL from DexScreener with DefiLlama fallback, and warns about slippage risk on thin pools. - Use Case: A user asks to swap 1 ETH for USDC on Base. The Skill resolves both token addresses, verifies the USDC contract on-chain, fetches the current rate and pool liquidity, then opens a Uniswap link with all parameters pre-filled. ## Quick Start Ask the assistant to swap 1 ETH for USDC on Base and it will verify the tokens, check liquidity, and open a pre-filled Uniswap swap link.

Frequently Asked Questions about swap-planner

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I swap ETH for USDC on Uniswap using a deep link?

Provide the input token, output token, amount, and chain, and the Skill constructs a Uniswap URL like app.uniswap.org/swap with chain, inputCurrency, outputCurrency, and value parameters pre-filled. The link opens in your browser ready for execution.

How to find trending memecoins on Base with DexScreener?

Use the DexScreener search endpoint with a keyword like degen or pepe, filter results by chainId and dexId uniswap, then sort by 24h volume. There is no live trending feed, so discovery relies on keyword search and web search fallback.

Which chains does Uniswap swap link generation support?

Supported chains include Ethereum, Base, Arbitrum, Optimism, Polygon, BNB Chain, Avalanche, Celo, Blast, Zora, World Chain, and Unichain. The chain parameter in the deep link uses lowercase names like ethereum or base.

Does the swap planner verify token contracts before trading?

Yes, it verifies contracts on-chain using an eth_getCode RPC call via curl, or optionally cast code if Foundry is installed. All token addresses are validated against the 0x hex format before any shell command runs.

What happens if a token has low liquidity on Uniswap?

Pools under $100k TVL trigger a slippage warning, and pools under $10k are flagged as very high risk. For tokens under 7 days old or with suspected honeypot behavior, the Skill requires explicit user confirmation before generating any link.

Why does the browser not open the Uniswap link automatically?

Browser opening via xdg-open or open fails in SSH, containerized, or headless environments. In those cases the full URL is displayed prominently so you can copy and paste it manually into a browser.