swap-planner

Translate swap intents into pre-filled Uniswap deep links with validation.

223|34|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/Uniswap/uniswap-ai --skill swap-planner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: swap-planner
Source: https://github.com/Uniswap/uniswap-ai/tree/main/packages/plugins/uniswap-driver/skills/swap-planner
Command: npx skills add https://github.com/Uniswap/uniswap-ai --skill swap-planner

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Translates user swap intents into actionable Uniswap swap plans by generating pre-filled deep links, reducing manual steps and cognitive load across supported chains.

Core Features & Use Cases

  • Validate token contracts and resolve addresses for both known and discovered tokens.
  • Research tokens when needed and present liquidity-aware swap options with a single deep link.
  • Extract swap intent (input token, output token, amount, chain) and produce an executable Uniswap URL with safety guidance and fallbacks.

Quick Start

Ask the user for input token, output token, amount, and chain, then generate and present a ready-to-use 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 generate a pre-filled 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 translates this intent into an executable URL with pre-filled swap parameters, reducing manual navigation on the Uniswap interface.

What is a Uniswap swap planner and how does it handle token discovery?

A Uniswap swap planner translates user intent into actionable token swaps by validating contracts and resolving addresses. For discovered tokens, it researches contracts, verifies addresses, and presents liquidity-aware swap options with a single deep link.

Can I execute blockchain token swaps across different chains using a swap planner?

Yes, you can plan token swaps across supported blockchain chains by specifying the network in your input. The planner extracts the chain context, resolves the token contracts, and generates a valid Uniswap deep link tailored for that environment.

How do I validate token contracts and assess risks before executing a Uniswap swap?

You can validate token contracts and assess risks by using the planner's built-in verification and risk assessment features. It resolves token addresses, verifies contract validity, and provides safety guidance before generating the final swap deep link.

What happens if token address resolution fails during blockchain swap planning?

If token address resolution fails, the swap planner initiates fallback workflows to research the token. It attempts to discover the correct contract address, verifies it, and provides alternative liquidity-aware options or safety guidance to the user.