From d815dc868c06414ecf12da68dd5ea47622bfa66a Mon Sep 17 00:00:00 2001 From: Nick Koutrelakos Date: Wed, 1 Apr 2026 09:50:55 -0700 Subject: [PATCH 1/3] [new-plugin] uniswap-swap-planner v0.2.1 --- submissions/uniswap-swap-planner/LICENSE | 21 ++++++ submissions/uniswap-swap-planner/README.md | 24 +++++++ submissions/uniswap-swap-planner/plugin.yaml | 24 +++++++ .../skills/uniswap-swap-planner/SKILL.md | 64 +++++++++++++++++++ 4 files changed, 133 insertions(+) create mode 100644 submissions/uniswap-swap-planner/LICENSE create mode 100644 submissions/uniswap-swap-planner/README.md create mode 100644 submissions/uniswap-swap-planner/plugin.yaml create mode 100644 submissions/uniswap-swap-planner/skills/uniswap-swap-planner/SKILL.md diff --git a/submissions/uniswap-swap-planner/LICENSE b/submissions/uniswap-swap-planner/LICENSE new file mode 100644 index 0000000..fb60be1 --- /dev/null +++ b/submissions/uniswap-swap-planner/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2026 Uniswap Labs + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/submissions/uniswap-swap-planner/README.md b/submissions/uniswap-swap-planner/README.md new file mode 100644 index 0000000..3ec307d --- /dev/null +++ b/submissions/uniswap-swap-planner/README.md @@ -0,0 +1,24 @@ +# uniswap-swap-planner + +Plan token swaps and generate Uniswap deep links across all supported chains, with token discovery and research workflows + +## Source + +This skill is maintained by Uniswap Labs in the [uniswap-ai](https://github.com/uniswap/uniswap-ai) monorepo. + +The canonical source is at [`packages/plugins/uniswap-driver/skills/swap-planner/`](https://github.com/uniswap/uniswap-ai/tree/main/packages/plugins/uniswap-driver/skills/swap-planner). + +### What It Does + +- Plans token swaps on any Uniswap-supported chain +- Generates deep links to execute swaps in the Uniswap web interface +- Supports token discovery workflows via keyword and web search + +### Related Skills + +- **uniswap-swap-integration**: Build swap functionality into your own application +- **uniswap-liquidity-planner**: Plan liquidity positions alongside swaps + +## License + +MIT diff --git a/submissions/uniswap-swap-planner/plugin.yaml b/submissions/uniswap-swap-planner/plugin.yaml new file mode 100644 index 0000000..1c14c03 --- /dev/null +++ b/submissions/uniswap-swap-planner/plugin.yaml @@ -0,0 +1,24 @@ +schema_version: 1 +name: uniswap-swap-planner +version: "0.2.1" +description: "Plan token swaps and generate Uniswap deep links across all supported chains, with token discovery and research workflows" +author: + name: "Uniswap Labs" + github: "wkoutre" +license: MIT +category: defi-protocol +tags: + - uniswap + - swap + - defi + - token-discovery + - deep-links + - ethereum + - multichain + +components: + skill: + dir: skills/uniswap-swap-planner + +api_calls: + - "trade-api.gateway.uniswap.org" diff --git a/submissions/uniswap-swap-planner/skills/uniswap-swap-planner/SKILL.md b/submissions/uniswap-swap-planner/skills/uniswap-swap-planner/SKILL.md new file mode 100644 index 0000000..fece989 --- /dev/null +++ b/submissions/uniswap-swap-planner/skills/uniswap-swap-planner/SKILL.md @@ -0,0 +1,64 @@ +--- +name: uniswap-swap-planner +description: "Plan token swaps and generate Uniswap deep links across all supported chains" +version: "0.2.1" +author: "Uniswap Labs" +tags: + - uniswap + - swap + - deep-links +--- + +# Uniswap Swap Planner + +Plan and generate deep links for token swaps on Uniswap across all supported chains. + +## Overview + +This skill helps AI agents plan token swaps by resolving token addresses, selecting the right chain, and generating Uniswap web interface deep links. It supports both known token swaps and exploratory token discovery workflows. + +## Pre-flight Checks + +1. Know the input and output token symbols or addresses +2. Know which chain to swap on (or let the skill recommend one) +3. A web browser to open the generated deep links + +## Commands + +### Plan a Known Swap + +When the user specifies both tokens: + +1. Resolve token contract addresses on the target chain +2. Validate the pair has liquidity on Uniswap +3. Generate the deep link: `https://app.uniswap.org/swap?inputCurrency=&outputCurrency=&chain=` + +### Token Discovery + +When the user asks "what should I buy" or wants to discover tokens: + +1. Use keyword search and web search to find relevant tokens +2. Present options with contract addresses and chain info +3. Generate swap deep links for the user-selected tokens + +**Note:** There is no live "trending" feed. Discovery uses search-based workflows. + +## Full Skill + +For the complete planning logic with multi-chain support, token resolution, and all deep link parameters: + +``` +npx skills add Uniswap/uniswap-ai +``` + +## Error Handling + +| Error | Cause | Resolution | +|-------|-------|------------| +| Token not found | Invalid symbol or wrong chain | Verify token exists on the target chain | +| No liquidity | Pool does not exist | Try a different chain or route through a stablecoin | + +## Skill Routing + +- For building swap functionality into an app -> use `uniswap-swap-integration` +- For liquidity provision planning -> use `uniswap-liquidity-planner` From e2fd83328b99ee3bd73d928f97d394aac4cf783e Mon Sep 17 00:00:00 2001 From: Nick Koutrelakos Date: Wed, 1 Apr 2026 09:55:37 -0700 Subject: [PATCH 2/3] simplify SKILL.md to minimal stub pointing to canonical source --- .../skills/uniswap-swap-planner/SKILL.md | 53 ++----------------- 1 file changed, 4 insertions(+), 49 deletions(-) diff --git a/submissions/uniswap-swap-planner/skills/uniswap-swap-planner/SKILL.md b/submissions/uniswap-swap-planner/skills/uniswap-swap-planner/SKILL.md index fece989..246398b 100644 --- a/submissions/uniswap-swap-planner/skills/uniswap-swap-planner/SKILL.md +++ b/submissions/uniswap-swap-planner/skills/uniswap-swap-planner/SKILL.md @@ -5,60 +5,15 @@ version: "0.2.1" author: "Uniswap Labs" tags: - uniswap - - swap - - deep-links + - defi --- -# Uniswap Swap Planner +# uniswap-swap-planner -Plan and generate deep links for token swaps on Uniswap across all supported chains. - -## Overview - -This skill helps AI agents plan token swaps by resolving token addresses, selecting the right chain, and generating Uniswap web interface deep links. It supports both known token swaps and exploratory token discovery workflows. - -## Pre-flight Checks - -1. Know the input and output token symbols or addresses -2. Know which chain to swap on (or let the skill recommend one) -3. A web browser to open the generated deep links - -## Commands - -### Plan a Known Swap - -When the user specifies both tokens: - -1. Resolve token contract addresses on the target chain -2. Validate the pair has liquidity on Uniswap -3. Generate the deep link: `https://app.uniswap.org/swap?inputCurrency=&outputCurrency=&chain=` - -### Token Discovery - -When the user asks "what should I buy" or wants to discover tokens: - -1. Use keyword search and web search to find relevant tokens -2. Present options with contract addresses and chain info -3. Generate swap deep links for the user-selected tokens - -**Note:** There is no live "trending" feed. Discovery uses search-based workflows. - -## Full Skill - -For the complete planning logic with multi-chain support, token resolution, and all deep link parameters: +This skill is maintained by Uniswap Labs. Install the full version: ``` npx skills add Uniswap/uniswap-ai ``` -## Error Handling - -| Error | Cause | Resolution | -|-------|-------|------------| -| Token not found | Invalid symbol or wrong chain | Verify token exists on the target chain | -| No liquidity | Pool does not exist | Try a different chain or route through a stablecoin | - -## Skill Routing - -- For building swap functionality into an app -> use `uniswap-swap-integration` -- For liquidity provision planning -> use `uniswap-liquidity-planner` +Source: [uniswap-ai/packages/plugins/uniswap-driver/skills/swap-planner](https://github.com/uniswap/uniswap-ai/tree/main/packages/plugins/uniswap-driver/skills/swap-planner) From 7cb78a8201f33a6061e32211a34a46c1e8fbbfe0 Mon Sep 17 00:00:00 2001 From: Nick Koutrelakos Date: Wed, 1 Apr 2026 10:01:48 -0700 Subject: [PATCH 3/3] add per-plugin install command to stub --- .../skills/uniswap-swap-planner/SKILL.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/submissions/uniswap-swap-planner/skills/uniswap-swap-planner/SKILL.md b/submissions/uniswap-swap-planner/skills/uniswap-swap-planner/SKILL.md index 246398b..2bca789 100644 --- a/submissions/uniswap-swap-planner/skills/uniswap-swap-planner/SKILL.md +++ b/submissions/uniswap-swap-planner/skills/uniswap-swap-planner/SKILL.md @@ -16,4 +16,10 @@ This skill is maintained by Uniswap Labs. Install the full version: npx skills add Uniswap/uniswap-ai ``` +Or install just this plugin: + +``` +claude plugin add @uniswap/uniswap-driver +``` + Source: [uniswap-ai/packages/plugins/uniswap-driver/skills/swap-planner](https://github.com/uniswap/uniswap-ai/tree/main/packages/plugins/uniswap-driver/skills/swap-planner)