ahmetenesdur/portfolio
skills/portfolio/SKILL.md
View a comprehensive DeFi portfolio dashboard and optimize portfolio allocation via automated rebalancing. Use this skill when the user wants an overview, summary, dashboard, total value, net worth, portfolio rebalancing, target allocation, or wants to see all their DeFi positions across Starknet at once. Also trigger when the user asks "what do I have", "show me everything", "how much am I worth", "my positions", "my investments", "rebalance my portfolio", "I want 50% ETH", "optimize my holdings", or any request for a holistic view of their Starknet holdings — even if they don't explicitly say "portfolio".
$ install --global
skillsauthnpx skillsauth add ahmetenesdur/starkfi portfolioInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 29, 2026, 6:46 AM197.2s1 file scanned
SKILL.md
- name:
- portfolio
- description:
- View a comprehensive DeFi portfolio dashboard and optimize portfolio allocation via automated rebalancing. Use this skill when the user wants an overview, summary, dashboard, total value, net worth, portfolio rebalancing, target allocation, or wants to see all their DeFi positions across Starknet at once. Also trigger when the user asks "what do I have", "show me everything", "how much am I worth", "my positions", "my investments", "rebalance my portfolio", "I want 50% ETH", "optimize my holdings", or any request for a holistic view of their Starknet holdings — even if they don't explicitly say "portfolio".
- license:
- MIT
- compatibility:
- Requires Node.js 18+ and npx.
- version:
- 0.3.0
- author:
- ahmetenesdur
- category:
- wallet-data
Portfolio Overview & Optimization
Display a comprehensive DeFi portfolio dashboard aggregating token balances, staking positions, Troves vault positions, Endur liquid staking (LST), lending positions, DCA orders, and confidential Tongo balances — all with USD valuations. Rebalance the portfolio to a target allocation via automated batch swaps.
Prerequisites
- Active session required.
- For rebalancing: sufficient token balances + gas for batch swap transactions.
Rules
- Use
portfolioas the FIRST command when the user asks "what do I have?" or wants an overall assessment. - The
portfoliocommand is read-only — it never modifies any on-chain state. - USD prices are sourced from the StarkZap SDK and may have slight variations.
- For
portfolio-rebalance, ALWAYS use--simulatefirst to preview the plan before executing. - Target allocations must sum to 100%. If they don't, inform the user and ask them to adjust.
- After rebalancing, run
portfolioagain to confirm the new allocation.
Commands
Portfolio Dashboard
npx starkfi@latest portfolio [--json]
Portfolio Rebalance
# Rebalance to target allocation
npx starkfi@latest portfolio-rebalance --target "<allocation>" [--slippage <n>] [--simulate] [--json]
Parameters
portfolio
| Parameter | Type | Description | Required |
| --------- | ---- | -------------- | -------- |
| --json | flag | Output as JSON | No |
portfolio-rebalance
| Parameter | Type | Description | Required |
| -------------- | ------ | ---------------------------------------------------- | -------- |
| --target | string | Target allocation (e.g. "50 ETH, 30 USDC, 20 STRK") | Yes |
| --slippage | number | Slippage tolerance % (default: 1) | No |
| --simulate | flag | Preview plan without executing | No |
| --json | flag | Output as JSON | No |
Target allocation format: Comma-separated <percentage> <token> pairs that sum to 100.
Dashboard Sections
The portfolio displays seven sections:
- Token Balances — STRK, ETH, and all ERC-20 tokens with non-zero balances and their USD values.
- Staking Positions — Active stakes across all validators/pools with pending rewards. Shows unpooling amounts and cooldown dates when exit intents are active.
- Lending Positions — Active Vesu V2 positions: supplied and borrowed amounts with pool details.
- DCA Orders — Active Dollar-Cost Averaging recurring swap orders.
- Confidential Tongo Balance — Private active and pending balances under Tongo Cash.
- Troves Vault Positions — Active deposits in Troves DeFi yield strategies with current value and APY.
- LST Positions — xSTRK holdings from Endur liquid staking with current STRK value and yield accrued.
Examples
User: "Show me my portfolio"
npx starkfi@latest portfolio
User: "What's my total value on Starknet?"
npx starkfi@latest portfolio
User: "Get my portfolio as JSON for analysis"
npx starkfi@latest portfolio --json
User: "Rebalance to 50% ETH, 30% USDC, 20% STRK"
# 1. View current allocation
npx starkfi@latest portfolio
# 2. Preview the rebalance plan
npx starkfi@latest portfolio-rebalance --target "50 ETH, 30 USDC, 20 STRK" --simulate
# 3. Execute after user confirms
npx starkfi@latest portfolio-rebalance --target "50 ETH, 30 USDC, 20 STRK"
npx starkfi@latest tx-status <hash>
# 4. Verify new allocation
npx starkfi@latest portfolio
User: "I want 60% ETH and 40% STRK"
npx starkfi@latest portfolio-rebalance --target "60 ETH, 40 STRK" --simulate
User: "Optimize my portfolio with 2% slippage"
npx starkfi@latest portfolio-rebalance --target "50 ETH, 30 USDC, 20 STRK" --slippage 2
Error Handling
| Error | Action |
| ---------------------- | -------------------------------------------------------------------------------------------------- |
| Not authenticated | Run authenticate-wallet skill first. |
| Partial failure | Some sections may show errors while others succeed. The portfolio uses fault-tolerant aggregation. |
| Network error | Retry once. Use config to set custom RPC. |
| Invalid allocation | Ensure target percentages sum to 100 and token symbols are valid. |
| Rebalance failed | Check balances, ensure tokens have sufficient liquidity on supported providers. |
| Insufficient balance | Not enough tokens to execute swaps — check balance first. |
Related Skills
- Use
balancefor a focused view of token balances only. - Use
stakingstake-statusfor detailed staking positions. - Use
lendinglend-statusfor detailed lending positions. - Use
lendinglend-monitorto monitor health factors across lending positions. - Use
dcadca-listto view active DCA orders. - Use
trovestroves-positionfor detailed vault positions. - Use
lstlst-positionfor detailed liquid staking positions. - Use
tradeif you need to swap a single token pair (not full rebalance).
Related Skills
ahmetenesdur/troves
testing
VerifiedTrustedCommunity
Deposit and withdraw from Troves DeFi yield vault strategies on Starknet. View available strategies, check positions, and manage vault deposits. Use this skill when the user mentions Troves, vault, yield vault, DeFi vault, strategy, yield farming, vault deposit, vault withdraw, earning yield through vaults, passive yield strategies, or wants to deposit into or withdraw from a yield strategy — even if they don't say "Troves" explicitly.
2SKILL.mdUpdated Apr 29, 2026
ahmetenesdur/lst
testing
VerifiedTrustedCommunity
Liquid staking via Endur on Starknet — stake STRK to receive xSTRK, redeem xSTRK back to STRK, check positions, and view protocol stats. Yield is embedded in the xSTRK share price (no manual claim needed). Use this skill when the user mentions liquid staking, LST, xSTRK, Endur, liquid staking token, share price, instant staking, tradeable staking position, or wants a staking token they can trade or use in DeFi — even if they don't say "liquid staking" explicitly.
2SKILL.mdUpdated Apr 29, 2026
ahmetenesdur/dca
testing
VerifiedTrustedCommunity
Create, preview, list, and cancel recurring Dollar-Cost Averaging (DCA) buy orders on Starknet via AVNU or Ekubo. Use this skill when the user wants to set up automatic recurring purchases, dollar-cost average into a token, create a DCA order, schedule periodic buys, invest regularly, buy every day/week/month, or manage existing DCA orders. Also trigger when the user says "recurring buy", "scheduled purchase", "buy X of Y every day", or any variation about automated periodic investing — even if they don't use the term "DCA" explicitly.
2SKILL.mdUpdated Apr 10, 2026
ahmetenesdur/confidential
development
VerifiedTrustedCommunity
Manage confidential (private) transfers via Tongo Cash on Starknet — setup, fund, transfer, withdraw, ragequit, rollover using ZK proofs. Use this skill when the user wants to send tokens privately, hide transfer amounts, use zero-knowledge proofs, set up Tongo, fund or withdraw from a confidential account, perform an emergency exit (ragequit), or activate pending balance (rollover). Also trigger when the user says "send privately", "confidential transfer", "hide my transaction", "Tongo Cash", "ZK transfer", or any variation about privacy-preserving transfers — even if they don't use the word "confidential".
2SKILL.mdUpdated Apr 10, 2026