Uniswap Portfolio Report

Generate a comprehensive portfolio report for a wallet's Uniswap positions across all chains — covering total value, PnL, fee earnings, impermanent loss, and composition. Use when the user asks about their positions, earnings, or portfolio overview.

Security Scan

The skill's stated purpose (Uniswap portfolio reporting) is plausible, but its instructions and docs reference sensitive wallet configuration (WALLET_TYPE, PRIVATE_KEY) and delegate to an external subagent without declaring required credentials — this mismatch is concerning and needs clarification before use.

Purpose & Capability

The skill claims to generate Uniswap portfolio reports and delegates to a 'portfolio-analyst' subagent, which is a reasonable design. However, README/SKILL.md error handling references WALLET_TYPE and PRIVATE_KEY (agent wallet secrets) while the skill metadata declares no required env vars or credentials — asking for a private key would be disproportionate for a read-only reporting task unless clearly justified (e.g., to sign transactions).

Instruction Scope

SKILL.md itself is an instruction-only skill that delegates to Task(subagent_type:portfolio-analyst). The instructions do not explicitly perform network calls or file reads, but they rely entirely on the portfolio-analyst subagent, and the docs explicitly suggest using a configured agent wallet or PRIVATE_KEY. That scope creep (potential access to private keys or agent wallet) is not documented in the skill metadata and is a red flag.

Install Mechanism

The skill has no install spec (instruction-only), which is lower risk. README shows example npx install commands that fetch code from a GitHub path — those are user-run commands outside the skill bundle. Users should be cautious running npx install from an unknown repo, but the skill itself does not perform any downloads or installs.

Credentials

Declared requirements list no env vars or credentials, yet SKILL.md/README mention WALLET_TYPE and PRIVATE_KEY as configuration in error messages. This is inconsistent: requesting private key access (or implying it may be needed) is high-risk for a reporting skill and should be explicitly declared and justified. Also, the delegated portfolio-analyst may require RPC keys or subgraph endpoints but none are documented.

Persistence & Privilege

The skill is not always-enabled and does not request system-wide persistence or modify other skills. It is user-invocable and delegates to a subagent — autonomous invocation is allowed by platform defaults but is not exceptional here.

What to consider before installing

This skill appears to do what it says (generate a Uniswap portfolio report) but the documentation hints it may use the agent's configured wallet or PRIVATE_KEY without declaring that requirement. Before installing or using it: - Ask the author what 'portfolio-analyst' requires (does it need a PRIVATE_KEY, WALLET_TYPE, RPC keys, or only a public wallet address?). - Do NOT provide private keys. Prefer supplying a public wallet address (read-only) and read-only RPC/subgraph access tokens if needed. - If the tool needs to sign transactions, get a clear justification and consider using a separate signing service or ephemeral keys. - Be cautious running the example npx install commands against an unknown GitHub repo — running npx on untrusted code executes remote scripts on your machine. If the maintainer provides a clear, minimal list of required env vars (ideally none or only read-only RPC endpoints) and confirms the subagent will never request or store private keys, the assessment could be upgraded. Conversely, any requirement to provide PRIVATE_KEY or write secrets to the agent would keep this skill suspicious.

Portfolio Report

Overview

Generates a comprehensive portfolio report for a wallet's Uniswap positions across all supported chains. Delegates to the portfolio-analyst agent to discover positions, calculate PnL, track fee earnings, and analyze composition.

When to Use

Activate when the user asks:

• "Show me my positions"
• "Portfolio report"
• "What's my Uniswap PnL?"
• "How much have I earned in fees?"
• "Which positions are out of range?"
• "What's my portfolio worth?"
• "Summarize my LP positions"

Parameters

Parameter	Required	Default	Description
wallet	No	Configured agent wallet	Wallet address to analyze
chains	No	All chains	Specific chains or "all"
focus	No	full	"positions", "pnl", "fees", or "full"

Workflow

1. Extract parameters from the user's request: identify wallet address, chain filter, and focus area.

2. Delegate to portfolio-analyst: Invoke Task(subagent_type:portfolio-analyst) with the parameters. The agent discovers all positions across chains, values them, calculates PnL, and analyzes composition.

3. Present results: Format the portfolio report as a user-friendly summary.

Output Format

Portfolio Report: 0xf39F...2266

  Total Value: $125,000
    LP Positions: $95,000
    Idle Tokens:  $28,000
    Uncollected:  $2,000

  PnL Summary:
    Realized:    +$5,200
    Unrealized:  +$3,800
    Gas Costs:   -$450
    Net PnL:     +$8,550 (+7.3%)

  Positions (2):
    1. USDC/WETH 0.05% (V3, Ethereum) — IN RANGE
       Value: $50,000 | PnL: +$2,000 | Fees: $800 uncollected
    2. UNI/WETH 0.30% (V3, Ethereum) — OUT OF RANGE
       Value: $45,000 | PnL: +$2,000 | Fees: $1,200 uncollected

  Recommendations:
    - Collect $1,200 in fees from UNI/WETH position
    - Rebalance UNI/WETH position (currently out of range)

Important Notes

• Delegates entirely to portfolio-analyst — no direct MCP tool calls.
• PnL includes gas costs. A position may be profitable before gas but unprofitable after.
• IL is reported as both absolute dollar value and percentage.
• Data may be slightly delayed due to RPC/subgraph sync.

Error Handling

Error	User-Facing Message	Suggested Action
Wallet not configured	"No wallet configured."	Set WALLET_TYPE + PRIVATE_KEY
No positions found	"No Uniswap positions found for this wallet."	Wallet may not have LP'd
Chain unreachable	"Could not connect to X chain."	Try again later