position-manager-skill

A complete build-out of the official position-manager-skill seed: one routed Claude Code / Codex skill to monitor, backtest, rebalance, and tax-track concentrated-liquidity LP across every major Solana DEX.

Submitted to the Superteam Brasil “Ship useful agent skills for the Solana AI Kit” bounty via Path 1 (level up a seed). This populates the empty solanabr/position-manager-skill seed with a production-grade implementation. The skill is internally branded “CLMM Command Center” (name: position-manager).

The problem

Concentrated-liquidity LPs juggle five disconnected tools: one dashboard per venue (Orca, Raydium, Meteora, Kamino), a spreadsheet for IL math, a Telegram bot for alerts, and a separate exporter at tax time. Studies of Uniswap-style CLMM repeatedly show a majority of LPs are net-unprofitable after impermanent loss versus simply holding. The core failure mode is late information: polling a position every 60s means you learn you went out-of-range minutes after fees stopped accruing, and you size rebalances on stale quotes.

What it does

• Track every CLMM/DLMM position across Orca Whirlpools, Raydium CLMM, Meteora DLMM + DAMM v2, and Kamino vaults in one normalized LpPosition view (tick bounds, in-range flag, unclaimed fees, token amounts).
• Alert in realtime via reconnecting Yellowstone gRPC / websocket subscriptions, firing the moment the current tick crosses a stored bound, instead of polling.
• Backtest a range: IL-vs-HODL net P&L and fee-APR over historical price paths, plus the break-even range width where fees cover IL.
• Route yield: compare fee APR for a pair across venues so you LP where the capital actually earns.
• Rebalance safely: plan a close+reopen into a new range, always simulate first, and gate execution behind a typed human confirmation with slippage / exposure caps.
• Tax-lot ledger: build cost-basis lots (FIFO / HIFO / SPECID) from add/remove/collect events as a record-keeping aid.

Prior art and how this differs

Single-venue liquidity skills/SDKs exist (Orca, Raydium, Meteora, Kamino each ship their own); agiprolabs/claude-trading-skills covers CLMM math educationally (lp-math, impermanent-loss). None give you live, multi-venue position management as one routed skill. This is the build-out of the official empty position-manager-skill seed: realtime gRPC alerting (not polling), IL-vs-HODL backtesting with break-even width, cross-DEX yield routing, and a simulate-first human-confirm rebalance gate. Scaffolding and knowledge you run yourself - never a hosted or auto-running bot.

How it works (progressive loading)