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.