From 6703847e2ca6aba1c62c6a15b332f8ce42f2f694 Mon Sep 17 00:00:00 2001 From: Nick Koutrelakos Date: Wed, 1 Apr 2026 09:50:58 -0700 Subject: [PATCH 1/3] [new-plugin] uniswap-liquidity-planner v0.2.0 --- submissions/uniswap-liquidity-planner/LICENSE | 21 +++++++ .../uniswap-liquidity-planner/README.md | 24 +++++++ .../uniswap-liquidity-planner/plugin.yaml | 24 +++++++ .../skills/uniswap-liquidity-planner/SKILL.md | 63 +++++++++++++++++++ 4 files changed, 132 insertions(+) create mode 100644 submissions/uniswap-liquidity-planner/LICENSE create mode 100644 submissions/uniswap-liquidity-planner/README.md create mode 100644 submissions/uniswap-liquidity-planner/plugin.yaml create mode 100644 submissions/uniswap-liquidity-planner/skills/uniswap-liquidity-planner/SKILL.md diff --git a/submissions/uniswap-liquidity-planner/LICENSE b/submissions/uniswap-liquidity-planner/LICENSE new file mode 100644 index 0000000..fb60be1 --- /dev/null +++ b/submissions/uniswap-liquidity-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-liquidity-planner/README.md b/submissions/uniswap-liquidity-planner/README.md new file mode 100644 index 0000000..fd12acb --- /dev/null +++ b/submissions/uniswap-liquidity-planner/README.md @@ -0,0 +1,24 @@ +# uniswap-liquidity-planner + +Plan and generate deep links for creating liquidity positions on Uniswap v2, v3, and v4 + +## 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/liquidity-planner/`](https://github.com/uniswap/uniswap-ai/tree/main/packages/plugins/uniswap-driver/skills/liquidity-planner). + +### What It Does + +- Plans concentrated liquidity positions with price range selection +- Generates deep links to create positions in the Uniswap web interface +- Supports Uniswap v2, v3, and v4 pool types + +### Related Skills + +- **uniswap-swap-planner**: Plan token swaps alongside liquidity provision +- **uniswap-viem-integration**: Foundational EVM blockchain integration + +## License + +MIT diff --git a/submissions/uniswap-liquidity-planner/plugin.yaml b/submissions/uniswap-liquidity-planner/plugin.yaml new file mode 100644 index 0000000..4eebc5e --- /dev/null +++ b/submissions/uniswap-liquidity-planner/plugin.yaml @@ -0,0 +1,24 @@ +schema_version: 1 +name: uniswap-liquidity-planner +version: "0.2.0" +description: "Plan and generate deep links for creating liquidity positions on Uniswap v2, v3, and v4" +author: + name: "Uniswap Labs" + github: "wkoutre" +license: MIT +category: defi-protocol +tags: + - uniswap + - liquidity + - defi + - lp-position + - concentrated-liquidity + - deep-links + - ethereum + +components: + skill: + dir: skills/uniswap-liquidity-planner + +api_calls: + - "trade-api.gateway.uniswap.org" diff --git a/submissions/uniswap-liquidity-planner/skills/uniswap-liquidity-planner/SKILL.md b/submissions/uniswap-liquidity-planner/skills/uniswap-liquidity-planner/SKILL.md new file mode 100644 index 0000000..eccaedb --- /dev/null +++ b/submissions/uniswap-liquidity-planner/skills/uniswap-liquidity-planner/SKILL.md @@ -0,0 +1,63 @@ +--- +name: uniswap-liquidity-planner +description: "Plan and generate deep links for creating liquidity positions on Uniswap v2, v3, and v4" +version: "0.2.0" +author: "Uniswap Labs" +tags: + - uniswap + - liquidity + - lp-position +--- + +# Uniswap Liquidity Planner + +Plan and generate deep links for creating liquidity positions on Uniswap v2, v3, and v4. + +## Overview + +This skill helps AI agents plan concentrated liquidity positions by guiding through pool selection, fee tier choices, price range strategies, and generating Uniswap web interface deep links to create the position. + +## Pre-flight Checks + +1. Know the token pair for the liquidity position +2. Know the target chain +3. Understand concentrated liquidity concepts (price ranges, fee tiers) +4. A web browser to open the generated deep links + +## Commands + +### Plan a Liquidity Position + +1. Identify the token pair and chain +2. Select the pool version (v2 full-range, v3/v4 concentrated) +3. Choose fee tier (1bp, 5bp, 30bp, 100bp) +4. Define price range (narrow for higher fees, wide for less impermanent loss) +5. Generate the deep link: `https://app.uniswap.org/add///?chain=` + +### Pool Version Guide + +| Version | Range Type | Best For | +|---------|-----------|----------| +| v2 | Full range | Simple, passive LPing | +| v3 | Concentrated | Active management, higher capital efficiency | +| v4 | Concentrated + hooks | Advanced strategies with custom logic | + +## Full Skill + +For the complete planning logic with all deep link parameters and range strategies: + +``` +npx skills add Uniswap/uniswap-ai +``` + +## Error Handling + +| Error | Cause | Resolution | +|-------|-------|------------| +| Pool not found | No pool exists for this pair/fee | Try a different fee tier or check token addresses | +| Invalid range | Min price >= max price | Ensure min < max and both are positive | + +## Skill Routing + +- For token swaps instead of liquidity -> use `uniswap-swap-planner` +- For viem/wagmi blockchain setup -> use `uniswap-viem-integration` From 35cd33194edfbe8206033b360910c539702d0fc9 Mon Sep 17 00:00:00 2001 From: Nick Koutrelakos Date: Wed, 1 Apr 2026 09:55:39 -0700 Subject: [PATCH 2/3] simplify SKILL.md to minimal stub pointing to canonical source --- .../skills/uniswap-liquidity-planner/SKILL.md | 52 ++----------------- 1 file changed, 4 insertions(+), 48 deletions(-) diff --git a/submissions/uniswap-liquidity-planner/skills/uniswap-liquidity-planner/SKILL.md b/submissions/uniswap-liquidity-planner/skills/uniswap-liquidity-planner/SKILL.md index eccaedb..0427e72 100644 --- a/submissions/uniswap-liquidity-planner/skills/uniswap-liquidity-planner/SKILL.md +++ b/submissions/uniswap-liquidity-planner/skills/uniswap-liquidity-planner/SKILL.md @@ -5,59 +5,15 @@ version: "0.2.0" author: "Uniswap Labs" tags: - uniswap - - liquidity - - lp-position + - defi --- -# Uniswap Liquidity Planner +# uniswap-liquidity-planner -Plan and generate deep links for creating liquidity positions on Uniswap v2, v3, and v4. - -## Overview - -This skill helps AI agents plan concentrated liquidity positions by guiding through pool selection, fee tier choices, price range strategies, and generating Uniswap web interface deep links to create the position. - -## Pre-flight Checks - -1. Know the token pair for the liquidity position -2. Know the target chain -3. Understand concentrated liquidity concepts (price ranges, fee tiers) -4. A web browser to open the generated deep links - -## Commands - -### Plan a Liquidity Position - -1. Identify the token pair and chain -2. Select the pool version (v2 full-range, v3/v4 concentrated) -3. Choose fee tier (1bp, 5bp, 30bp, 100bp) -4. Define price range (narrow for higher fees, wide for less impermanent loss) -5. Generate the deep link: `https://app.uniswap.org/add///?chain=` - -### Pool Version Guide - -| Version | Range Type | Best For | -|---------|-----------|----------| -| v2 | Full range | Simple, passive LPing | -| v3 | Concentrated | Active management, higher capital efficiency | -| v4 | Concentrated + hooks | Advanced strategies with custom logic | - -## Full Skill - -For the complete planning logic with all deep link parameters and range strategies: +This skill is maintained by Uniswap Labs. Install the full version: ``` npx skills add Uniswap/uniswap-ai ``` -## Error Handling - -| Error | Cause | Resolution | -|-------|-------|------------| -| Pool not found | No pool exists for this pair/fee | Try a different fee tier or check token addresses | -| Invalid range | Min price >= max price | Ensure min < max and both are positive | - -## Skill Routing - -- For token swaps instead of liquidity -> use `uniswap-swap-planner` -- For viem/wagmi blockchain setup -> use `uniswap-viem-integration` +Source: [uniswap-ai/packages/plugins/uniswap-driver/skills/liquidity-planner](https://github.com/uniswap/uniswap-ai/tree/main/packages/plugins/uniswap-driver/skills/liquidity-planner) From 9d8a0b11a21334b137d50ddf346eb12b4cf1cf09 Mon Sep 17 00:00:00 2001 From: Nick Koutrelakos Date: Wed, 1 Apr 2026 10:01:50 -0700 Subject: [PATCH 3/3] add per-plugin install command to stub --- .../skills/uniswap-liquidity-planner/SKILL.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/submissions/uniswap-liquidity-planner/skills/uniswap-liquidity-planner/SKILL.md b/submissions/uniswap-liquidity-planner/skills/uniswap-liquidity-planner/SKILL.md index 0427e72..f7aa7d8 100644 --- a/submissions/uniswap-liquidity-planner/skills/uniswap-liquidity-planner/SKILL.md +++ b/submissions/uniswap-liquidity-planner/skills/uniswap-liquidity-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/liquidity-planner](https://github.com/uniswap/uniswap-ai/tree/main/packages/plugins/uniswap-driver/skills/liquidity-planner)