swap-planner

Generate Uniswap deep-link swap plans from validated token inputs.

3|Updated Mar 22, 2026
One-click install
npx skills add https://github.com/0xharryriddle/codex-field-kit --skill swap-planner-0xharryriddle
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: swap-planner
Source: https://github.com/0xharryriddle/codex-field-kit/tree/main/archive/upstream/chasebuild-agent-skills/web3/skills/swap-planner
Command: npx skills add https://github.com/0xharryriddle/codex-field-kit --skill swap-planner-0xharryriddle

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Plan and execute cross-chain token swaps by translating user intents into a structured plan and an execution-ready Uniswap deep link. It helps users discover tokens, verify contracts, fetch live price data, and generate swap URLs across supported chains with minimal manual effort.

Core Features & Use Cases

  • Token discovery and intent parsing: identify user swap desires (input token, output token, amount, chain) and determine whether to search for new tokens or swap known ones.
  • Contract verification and price checks: validate token contracts on-chain and fetch live pricing and liquidity data to estimate output and risk.
  • Deep link generation: construct a Uniswap URL with chain, input/output tokens, and amount, ready for user to open.
  • Missing-input handling: guide users with structured prompts to fill any gaps (chain, amount, tokens) before execution.
  • Risk prompts and confirmations: warn about high-risk tokens and require user confirmation before proceeding with a swap.

Quick Start

Ask me to swap 1 ETH for USDC on Base to generate a Uniswap deep link and open it in your browser.

Frequently Asked Questions about swap-planner

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

FAQPage Schema
How do I generate a Uniswap deep link for a token swap?

To generate a Uniswap deep link, provide the input token, output token, amount, and chain. The swap planner validates these inputs and constructs a shareable Uniswap swap URL ready for execution.

How does cross-chain token swap planning work for DeFi protocols?

Cross-chain token swap planning identifies your intent, verifies token contracts on-chain, fetches live pricing and liquidity data, and produces a structured execution plan with a deep link across Uniswap-supported networks.

Can I execute a token swap if I only know the token names but not the chain?

Yes, you can execute a token swap knowing only token names. The planner defaults to Ethereum, discovers tokens, and uses interactive prompting to guide you in selecting the correct chain and filling missing inputs.

What happens if I provide incomplete token swap details to the swap planner?

If you provide incomplete token swap details, the planner uses structured prompts to guide you. It ensures all required parameters like chain, amount, and tokens are filled before generating the Uniswap deep link.

Does the swap planner verify token contracts and check liquidity before generating a deep link?

Yes, the swap planner verifies token contracts and checks liquidity. It fetches live pricing data, assesses risk, and warns about high-risk tokens, requiring your confirmation before proceeding with the swap.

What is the best way to plan a token swap on Base using Uniswap?

The best way to plan a token swap on Base is to specify the input token, output token, amount, and Base as the chain. The planner validates the inputs and generates a direct Uniswap deep link for your browser.