Uniswap Full Lp Workflow

Full LP workflow from opportunity scanning to position entry. Autonomously finds the best LP opportunity, designs a strategy, assesses risk, executes any needed swaps, enters the position, and reports portfolio impact. Use when user has capital and wants end-to-end LP management. Most complex multi-agent orchestration in the system.

Security Scan

The skill's stated purpose (automated Uniswap LP workflow) matches its instructions, but it plans to execute on‑chain swaps and open positions while declaring no credentials or installation requirements and comes from an unknown source — that mismatch is suspicious and warrants caution before use.

Purpose & Capability

Name/description align with the instructions: scanning pools, designing strategies, assessing risk, executing swaps, and adding liquidity — the allowed tools (opportunity scanner, lp-strategist, trade-executor, liquidity-manager, and Uniswap check/get-balance helpers) are appropriate for the stated purpose.

Instruction Scope

The runtime instructions intend to perform real on-chain actions (token swaps and LP entry) and to 'auto-detect' wallet token balances. The skill pauses for user confirmation before swaps/commitment, but the SKILL.md does not clearly define how wallet access/signing is obtained or restricted. The instructions could therefore cause financial actions without a clear, declared credential/consent mechanism beyond the two confirmation points.

Install Mechanism

There is no install spec inside the skill (instruction-only), which is low-risk. However, the README suggests installing via 'npx' from a GitHub URL (external repo). That installation approach would fetch remote code — if a user follows that README they should review the remote repository before running npx. The skill itself does not auto-install code on the agent.

Credentials

The skill plans to execute transactions and 'auto-detect' wallet tokens but declares no required environment variables, credentials, or config paths (primary credential: none). A workflow that signs transactions or uses a wallet normally requires explicit credential or signer access; the absence of declared credentials and of a clear signer integration raises proportionality and provenance concerns.

Persistence & Privilege

always is false and the skill does not request persistent system-level presence. disable-model-invocation is false (normal). There is no evidence it modifies other skills or global agent configuration.

What to consider before installing

This skill will scan pools and can perform real token swaps and add liquidity — actions that move your funds. Before installing or using it: 1) Verify how the agent obtains wallet signing authority (do not provide private keys directly; prefer an external signer or hardware wallet that requires manual confirmation for each tx). 2) Confirm the platform-level tools (mcp__uniswap__*) and their scopes so you know which endpoints the skill can call. 3) If you consider installing via the README's npx/GitHub method, review the remote repository code first — npx will download and run remote code. 4) Test on a small amount or a testnet and require the two explicit user confirmation points to be honored. 5) Prefer skills from a known, auditable source or request the skill author to declare required credentials and provide a link to a public repo for code review. Providing that provenance and a clear signer model would increase confidence; absent that, treat the skill as suspicious.

Full LP Workflow

Overview

This is the most complex multi-agent orchestration in the system. It turns a single intent -- "I have $20K, find me the best yield" -- into a fully researched, risk-assessed, optimally-structured LP position through a 6-agent pipeline.

Why this is 10x better than calling agents individually:

1. End-to-end automation: Manually, you'd need to scan opportunities, research pools, design a strategy, assess risk, potentially swap tokens, add liquidity, and verify -- each requiring different tools and expertise. This does it all in one command.
2. Intelligent pipeline with compound context: Each agent builds on all prior agents' findings. The lp-strategist doesn't just get a token pair -- it gets the opportunity-scanner's full analysis of why this pool is optimal. The risk-assessor evaluates the actual strategy designed by the lp-strategist, not a generic assessment.
3. Two user confirmation points: Before spending any money (swap) and before committing capital (LP entry), the skill pauses for explicit user approval. You stay in control.
4. Conditional swap step: If you don't hold the right tokens for the LP position, the skill automatically handles the token swap -- but only after showing you exactly what it plans to do.
5. Portfolio impact reporting: After entering the position, the portfolio-analyst shows you exactly how your portfolio changed, with ongoing monitoring instructions.
6. Failure recovery at every stage: If any agent fails mid-pipeline, you see what was accomplished and get recovery suggestions.

When to Use

Activate when the user says anything like:

• "I have $20K, find the best LP opportunity and enter"
• "Autonomous LP: find yield and enter position"
• "Full LP workflow with $10,000"
• "Find me the best yield and set up a position"
• "I want to LP but don't know where -- find the best option"
• "Put $5K to work in Uniswap -- find the best opportunity"
• "End-to-end LP: scan, strategize, and enter"
• "What's the best LP opportunity right now? Set it up for me"

Do NOT use when the user already knows which pool they want (use manage-liquidity instead), just wants strategy comparison without execution (use lp-strategy), or just wants to scan without entering (use scan-opportunities).

Parameters

Parameter	Required	Default	How to Extract
capital	Yes	--	Total capital to deploy: "$20,000", "10 ETH", "$5K"
chain	No	all	Target chain or "all" for cross-chain scan
riskTolerance	No	moderate	"conservative", "moderate", "aggressive"
pairPreference	No	--	Optional token pair preference: "ETH/USDC", "stablecoin pairs"
excludeTokens	No	--	Tokens to exclude: "PEPE, SHIB" (avoid memecoins, etc.)
capitalToken	No	auto-detect	What token the capital is in: "USDC", "ETH", auto-detect from wallet

If the user doesn't provide capital amount, ask for it -- never guess how much to deploy.

Workflow

                          FULL LP WORKFLOW PIPELINE
  ┌─────────────────────────────────────────────────────────────────────┐
  │                                                                     │
  │  Step 1: SCAN (opportunity-scanner)                                 │
  │  ├── Scan LP opportunities across chains                            │
  │  ├── Filter by risk tolerance and capital size                      │
  │  ├── Rank top 3-5 by risk-adjusted yield                           │
  │  └── Output: Ranked Opportunity List                                │
  │          │                                                          │
  │          ▼ USER CHOICE POINT                                        │
  │  ┌───────────────────────────────────────────────────┐              │
  │  │  Present top opportunities to user.               │              │
  │  │  User picks one OR accepts recommendation (#1).   │              │
  │  └───────────────────────────────────────────────────┘              │
  │          │                                                          │
  │          ▼                                                          │
  │                                                                     │
  │  Step 2: STRATEGIZE (lp-strategist)                                 │
  │  ├── Design optimal strategy for chosen opportunity                 │
  │  ├── Version, fee tier, range width, rebalance plan                 │
  │  ├── Conservative/moderate/optimistic APY estimates                 │
  │  └── Output: LP Strategy Recommendation                             │
  │          │                                                          │
  │          ▼                                                          │
  │                                                                     │
  │  Step 3: RISK CHECK (risk-assessor)                                 │
  │  ├── Receives: opportunity data + strategy details                  │
  │  ├── Evaluates: IL, slippage, liquidity, smart contract             │
  │  ├── Decision: APPROVE / CONDITIONAL / VETO / HARD_VETO            │
  │  └── Output: Risk Assessment Report                                 │
  │          │                                                          │
  │          ▼ CONDITIONAL GATE                                         │
  │  ┌───────────────────────────────────────────────────┐              │
  │  │  APPROVE / COND. APPROVE → Continue               │              │
  │  │  VETO / HARD_VETO → STOP with full report         │              │
  │  └───────────────────────────────────────────────────┘              │
  │          │                                                          │
  │          ▼                                                          │
  │                                                                     │
  │  Step 4: SWAP IF NEEDED (trade-executor) -- CONDITIONAL             │
  │  ├── Check wallet balances vs required tokens                       │
  │  ├── If tokens needed: calculate swap amounts                       │
  │  ├── USER CONFIRMATION #1: "Swap X for Y to prepare for LP?"       │
  │  ├── Execute swap(s) if confirmed                                   │
  │  └── Output: Swap result OR "tokens already held"                   │
  │          │                                                          │
  │          ▼                                                          │
  │                                                                     │
  │  Step 5: ENTER POSITION (liquidity-manager)                         │
  │  ├── USER CONFIRMATION #2: "Add liquidity with these params?"      │
  │  ├── Handle approvals (Permit2)                                     │
  │  ├── Add liquidity at recommended range                             │
  │  ├── Wait for transaction confirmation                              │
  │  └── Output: Position ID, amounts deposited, tick range             │
  │          │                                                          │
  │          ▼                                                          │
  │                                                                     │
  │  Step 6: CONFIRM & REPORT (portfolio-analyst)                       │
  │  ├── Verify position was created successfully                       │
  │  ├── Show portfolio impact (before vs after)                        │
  │  ├── Monitoring instructions                                        │
  │  └── Output: Portfolio Report + Next Steps                          │
  │                                                                     │
  └─────────────────────────────────────────────────────────────────────┘

Step 0: Pre-Flight

Before starting the pipeline:

1. Check safety status via mcp__uniswap__check_safety_status -- verify spending limits can accommodate the capital amount.
2. Check wallet balance via mcp__uniswap__get_agent_balance on the target chain(s) -- verify the wallet has the stated capital.
3. If either check fails, stop and inform the user before wasting agent compute.

Step 1: Scan Opportunities (opportunity-scanner)

Delegate to Task(subagent_type:opportunity-scanner) with:

Scan for LP opportunities with these parameters:
- Available capital: {capital}
- Chains: {chain or "all supported chains"}
- Risk tolerance: {riskTolerance}
- Type: "lp" (LP opportunities only)
- Minimum TVL: $50,000
- Top N: 5

Additional filters:
- Pair preference: {pairPreference or "none"}
- Exclude tokens: {excludeTokens or "none"}

Return the top 5 LP opportunities ranked by risk-adjusted yield.
Each opportunity must include fee APY, estimated IL, risk-adjusted yield,
TVL, volume, and risk rating.

Present to user with a choice:

Step 1/6: Opportunity Scan Complete

  Found 5 LP opportunities (filtered from 200+ pools):

  #  Pool                Chain    Fee APY  Est. IL  Net APY  Risk    TVL
  1  WETH/USDC 0.05%     ETH      21%      -6%      15%     MEDIUM  $332M
  2  WETH/USDC 0.05%     Base     18%      -5%      13%     MEDIUM  $45M
  3  ARB/WETH 0.30%      Arb      35%      -12%     23%     HIGH    $12M
  4  USDC/USDT 0.01%     ETH      8%       -0.1%    7.9%    LOW     $200M
  5  cbETH/WETH 0.05%    Base     12%      -3%      9%      LOW     $28M

  Recommended: #1 (WETH/USDC 0.05% on Ethereum) — best balance of yield and risk

  Which opportunity would you like to pursue? (1-5, or "1" to accept recommendation)

Wait for user selection before proceeding.

Step 2: Design Strategy (lp-strategist)

Delegate to Task(subagent_type:lp-strategist) with the chosen opportunity:

Design an optimal LP strategy for this opportunity:

Opportunity details (from opportunity-scanner):
{Full opportunity data from Step 1 for chosen pool}

LP parameters:
- Capital: {capital}
- Risk tolerance: {riskTolerance}
- Chain: {chain of chosen opportunity}

Provide:
1. Recommended version and fee tier (with rationale)
2. Optimal tick range (lower/upper prices, width %)
3. Conservative/moderate/optimistic APY and IL estimates
4. Rebalance strategy (trigger, frequency, estimated cost)
5. Comparison to the next-best alternative

Present to user:

Step 2/6: Strategy Designed

  Pool:     WETH/USDC 0.05% (V3, Ethereum)
  Range:    $1,700 - $2,300 (±15%, medium width)
  Expected: 15% net APY (moderate estimate)

  Strategy Details:
    Fee APY (moderate): 21%
    Estimated IL: -6%
    Net APY: 15%
    Rebalance: every 2-3 weeks (trigger: price within 10% of boundary)
    Rebalance cost: ~$15/rebalance on Ethereum

  Proceeding to risk assessment...

Step 3: Risk Assessment (risk-assessor)

Delegate to Task(subagent_type:risk-assessor) with compound context:

Evaluate risk for this LP strategy:

Operation: add liquidity
Token pair: {token0}/{token1}
Pool: {pool address}
Chain: {chain}
Capital: {capital}
Risk tolerance: {riskTolerance}

Strategy context (from lp-strategist):
{Full strategy recommendation from Step 2}

Opportunity context (from opportunity-scanner):
{Key metrics from Step 1: TVL, volume trend, risk rating}

Evaluate: impermanent loss risk, slippage risk (entry/exit), liquidity risk,
smart contract risk. Provide APPROVE/CONDITIONAL_APPROVE/VETO/HARD_VETO.

Conditional gate (same logic as research-and-trade):

Decision	Action
APPROVE	Present risk summary, proceed to Step 4
CONDITIONAL_APPROVE	Show conditions, ask user if they accept
VETO	STOP. Show opportunity + strategy + veto reason. Suggest fallbacks.
HARD_VETO	STOP. Show reason. Non-negotiable.

Present to user (APPROVE case):

Step 3/6: Risk Assessment Passed

  Decision: APPROVE
  Composite Risk: MEDIUM
  IL Risk: MEDIUM (8.2% annual estimate for volatile pair)
  Slippage: LOW (deep pool, entry < 0.1% impact)
  Liquidity: LOW (TVL 6,640x your position)
  Smart Contract: LOW (V3, established pool)

  Proceeding to prepare tokens...

Step 4: Swap If Needed (trade-executor) -- Conditional

Check wallet balances against required token amounts for the LP position:

1. The strategy specifies how much of each token is needed (e.g., 50/50 split for a centered range).
2. Check current wallet holdings via mcp__uniswap__get_agent_balance.
3. Calculate what swaps are needed (if any).

If no swaps needed:

Step 4/6: Token Preparation — Skipped

  You already hold sufficient WETH and USDC for this position.
  No swaps required.

If swaps needed, present and ask USER CONFIRMATION #1:

Step 4/6: Token Preparation Required

  Your position needs:
    0.5 WETH  (~$980)
    980 USDC  (~$980)

  You currently hold:
    2.0 WETH  ($3,920)
    0 USDC    ($0)

  Proposed swap:
    Sell 0.5 WETH → Buy ~980 USDC
    Estimated slippage: 0.05%
    Gas: ~$8

  Approve this swap to prepare tokens for LP? (yes/no)

Only execute the swap if the user explicitly confirms. If the user declines, stop the pipeline and present what was accomplished (scan + strategy + risk assessment).

Step 5: Enter Position (liquidity-manager)

Present the full LP entry details and ask USER CONFIRMATION #2:

Step 5/6: Ready to Add Liquidity

  Pool:     WETH/USDC 0.05% (V3, Ethereum)
  Deposit:
    0.5 WETH  (~$980)
    980 USDC  (~$980)
    Total:    ~$1,960

  Range:
    Lower: $1,700 (tick -204714)
    Upper: $2,300 (tick -199514)
    Current: $1,963 — IN RANGE
    Width: ±15% (medium)

  Expected Fee APY: ~15-21% (based on 7d pool data)

  Add liquidity with these parameters? (yes/no)

Only proceed if the user confirms. Then delegate to Task(subagent_type:liquidity-manager):

Add liquidity to this pool:

Pool: {pool address}
Chain: {chain}
Version: {version}
Token0: {token0 address} — Amount: {amount0}
Token1: {token1 address} — Amount: {amount1}
Tick lower: {tick_lower}
Tick upper: {tick_upper}

Strategy context:
- Range strategy: {medium/narrow/wide}
- From lp-strategist recommendation

Execute: handle approvals, simulate, route through safety-guardian, add liquidity,
wait for confirmation. Return position ID and actual amounts deposited.

Step 6: Confirm & Report (portfolio-analyst)

Delegate to Task(subagent_type:portfolio-analyst) with the new position:

Report on the portfolio impact of this new LP position:

New position:
- Position ID: {position_id from Step 5}
- Pool: {pool_address}
- Chain: {chain}
- Tokens deposited: {amounts}
- Tick range: {lower} to {upper}
- Transaction: {tx_hash}

Wallet address: {wallet_address}

Provide:
1. New position details and current status (in-range confirmation)
2. Portfolio impact (if other positions exist, show before/after composition)
3. Total portfolio value across all chains
4. Monitoring recommendations

Present final result:

Step 6/6: Position Confirmed & Portfolio Updated

  New Position: #456789
  Pool:     WETH/USDC 0.05% (V3, Ethereum)
  Status:   IN RANGE
  Value:    $1,960

  Deposited:
    0.5 WETH  ($980)
    980 USDC  ($980)

  Range:
    $1,700 — $2,300 (current: $1,963)

  Expected Returns:
    Fee APY: 15-21% (moderate-optimistic)
    Est. IL: -5 to -8% annualized
    Net: 9-15% annualized

  Portfolio Impact:
    Total LP Value:  $1,960 (new) + $45,000 (existing) = $46,960
    LP Allocation:   42% WETH, 35% USDC, 23% other
    Chain Split:     85% Ethereum, 15% Base

  ──────────────────────────────────────
  Pipeline Summary
  ──────────────────────────────────────
  Scan:      5 opportunities found, #1 selected
  Strategy:  V3 0.05%, ±15% range, bi-weekly rebalance
  Risk:      APPROVED (MEDIUM composite)
  Swap:      0.5 WETH → 980 USDC (preparation)
  Position:  #456789 — IN RANGE
  Cost:      $15.20 total gas (swap + LP entry)

  Next Steps:
  - Monitor: "How are my positions doing?"
  - Rebalance when needed: "Rebalance position #456789"
  - Collect fees: "Collect fees from position #456789"

Critical Decision Points

These are the moments where the skill must stop and ask rather than assume:

Situation	Action
Capital amount not specified	Ask: "How much capital would you like to deploy?"
Multiple good opportunities	Present top 3-5, let user choose
Risk-assessor VETO	Stop. Show research + strategy + veto reason.
Swap needed for token preparation	USER CONFIRMATION #1: show swap details, ask to proceed
Ready to add liquidity	USER CONFIRMATION #2: show position details, ask to proceed
Capital exceeds safety spending limit	Stop. Show limit. Suggest reducing amount or adjusting limits.
Wallet doesn't have stated capital	Stop. Show actual balance. Ask to adjust amount.
Best opportunity is on a different chain than wallet funds	Explain cross-chain situation, suggest bridge or chain choice

Partial Completion Recovery

If the pipeline fails mid-way, report what was accomplished and what remains:

LP Workflow — Partial Completion

  Completed:
    [done] Step 1: Scan — 5 opportunities found, #1 selected
    [done] Step 2: Strategy — V3 0.05%, ±15% range designed
    [done] Step 3: Risk — APPROVED (MEDIUM)
    [FAIL] Step 4: Swap — Transaction reverted (insufficient gas)

  Remaining:
    [ ] Step 5: Add liquidity
    [ ] Step 6: Portfolio report

  Recovery Options:
    - Ensure sufficient ETH for gas and retry: "Continue LP workflow"
    - Add liquidity manually with the strategy above: "Add liquidity to WETH/USDC 0.05%"
    - Start over: "Full LP workflow with $X"

Output Format

Successful Pipeline (all 6 steps)

Full LP Workflow Complete

  Opportunity: {pool_pair} {fee}% on {chain}
  Strategy:    {version}, {range_width} range, {rebalance_frequency} rebalance
  Risk:        {decision} ({composite_risk})
  Position:    #{position_id} — {status}
  Value:       ${total_value}

  Returns (moderate estimate):
    Fee APY: {fee_apy}%
    Est. IL: {il}%
    Net APY: {net_apy}%

  Cost: ${total_gas} gas across {n} transactions

  Pipeline: Scan -> Strategy -> Risk -> Swap -> Enter -> Confirm (all passed)

Important Notes

• This is the most complex skill. It orchestrates 6 agents with 2 user confirmation points and a conditional swap step. Each agent receives compound context from all predecessors.
• Two explicit confirmations: Before any swap and before adding liquidity. The user must say "yes" at both gates.
• Conditional swap: Step 4 only executes if the user doesn't already hold the right tokens. If they do, it's skipped entirely.
• Chain considerations: If scanning "all" chains, the best opportunity might be on a chain where the user's funds aren't located. The skill should flag this and suggest bridging or narrowing the chain filter.
• Gas budget: On Ethereum, the full pipeline (swap + LP) costs $15-50 in gas. For small positions (< $1K), warn that gas costs significantly eat into returns.
• Never auto-execute: Despite being an "autonomous" workflow, every spend of user capital requires explicit confirmation.

Error Handling

Error	User-Facing Message	Suggested Action
No opportunities found	"No LP opportunities match your criteria on {chain}."	Broaden chain filter or lower minTVL
Opportunity-scanner fails	"Opportunity scan failed. Cannot identify LP targets."	Try scan-opportunities directly
LP-strategist fails	"Strategy design failed for {pool}. Scan results preserved."	Try lp-strategy or optimize-lp directly
Risk-assessor VETO	"Risk assessment vetoed: {reason}. Strategy: {summary}."	Pick a different opportunity or reduce size
Risk-assessor HARD_VETO	"Strategy blocked: {reason}. This cannot be overridden."	Choose a lower-risk opportunity
Insufficient balance for swap	"Not enough {token} to prepare for LP. Have {X}, need {Y}."	Reduce capital or acquire tokens
Swap execution fails	"Token swap failed: {reason}. Strategy and risk data preserved."	Retry or swap manually
Liquidity add fails	"Failed to add liquidity: {reason}. Tokens are still in your wallet."	Retry or use manage-liquidity directly
Position not confirmed	"Position created but not yet confirmed on-chain. Check back in a moment."	Wait and check with track-performance
Safety spending limit exceeded	"Capital of ${X} exceeds spending limit of ${Y}."	Reduce amount or adjust safety config
Wallet not configured	"No wallet configured. Cannot execute transactions."	Set up wallet with setup-agent-wallet
User declines swap confirmation	"Token swap cancelled. Strategy preserved — you can proceed manually."	Use manage-liquidity with manual prep
User declines LP confirmation	"LP entry cancelled. All prior research is shown above."	Adjust parameters and retry