liquidity-planner

Generates deep links for creating Uniswap v2, v3, and v4 liquidity positions.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Creating a concentrated liquidity position on Uniswap requires researching pools, comparing fee tiers, checking TVL and APY, and choosing price ranges — a fragmented process across multiple data sources. This Skill consolidates that research and produces a pre-filled Uniswap deep link so the position opens ready to confirm. ## Core Features & Use Cases - Pool Discovery & Analytics: Queries DexScreener and DefiLlama APIs to find existing Uniswap pools, compare fee tiers, and report TVL, volume, and APY before committing capital. - Guided Range & Fee Selection: Suggests price ranges based on pair type (stablecoin, correlated, major, volatile) and presents fee tier options with live pool data. - Deep Link Generation: Builds a Uniswap positions/create URL with chain, tokens, fee, price range, and deposit amounts pre-filled, then opens it in the browser. - Use Case: A user wants to provide ETH/USDC liquidity on Base. The Skill finds the 0.30% pool, shows its $15M TVL and 12.5% APY, suggests a ±10% range around the current price, and opens Uniswap with everything pre-configured. ## Quick Start Ask the assistant to help you provide liquidity for a token pair, for example: "Create a v3 LP position for 1 ETH against USDC on Base with a ±10% range."

Frequently Asked Questions about liquidity-planner

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

FAQPage Schema
How do I create a Uniswap v3 liquidity position?

Provide the token pair, deposit amount, and chain, then the Skill fetches pool data, suggests a price range and fee tier, and generates a pre-filled Uniswap deep link. Opening the link takes you directly to the position creation flow with all parameters set.

What fee tier should I choose for a Uniswap pool?

Use 0.01% for stablecoin pairs, 0.05% for correlated assets like ETH/stETH, 0.30% for most standard pairs, and 1.00% for exotic or volatile tokens. The Skill compares live APY and TVL across available fee tiers to recommend one.

Does Uniswap v3 support all chains for liquidity positions?

V3 is available on Ethereum, Base, Arbitrum, Optimism, Polygon, and several other chains, while v2 and v4 availability varies by network. The Skill checks chain support and existing pools before suggesting a version.

How do I pick a price range for concentrated liquidity?

Range choice depends on pair volatility: stablecoins suit ±0.5-1%, major pairs like ETH/USDC suit ±10-20%, and volatile pairs suit ±30-50% or full range. Tighter ranges earn more fees but require active monitoring and carry higher impermanent loss risk.

Why does the browser fail to open the Uniswap link?

Browser opening via xdg-open or open fails in SSH, containerized, or headless environments. When this happens, the Skill displays the full URL prominently so you can copy and paste it into a browser manually.

Is it safe to use token addresses found via web search?

Web-discovered token addresses are treated as untrusted because they may be scams or honeypots. The Skill labels the source, warns about risks, and requires explicit user confirmation before generating a deep link for any web-discovered token.