[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M748RW4DR3XFDXRWXB00M8FS":3,"skill-same:01M748RW4DR3XFDXRWXB00M8FS":94},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":6,"updatedAt":31,"install":32,"resources":45},"01M748RW4DR3XFDXRWXB00M8FS","portfolio-manager",null,"Comprehensive portfolio analysis using Alpaca MCP Server integration to fetch holdings and positions, then analyze asset allocation, risk metrics, individual stock positions, diversification, and generate rebalancing recommendations. Use when user requests portfolio review, position analysis, risk assessment, performance evaluation, or rebalancing suggestions for their brokerage account.","mphinance\u002Falpha-skills","mphinance","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F217996678?v=4","01M71VQC89A6CMFACD2J1CJW6E","Michael H","01M71VQC9B4C0BJ7XXKT8RWRV9",32,"MIT","https:\u002F\u002Fgithub.com\u002Fmphinance\u002Falpha-skills\u002Fblob\u002Fmain\u002Fskills\u002Fportfolio-manager\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: portfolio-manager\ndescription: Comprehensive portfolio analysis using Alpaca MCP Server integration to fetch holdings and positions, then analyze asset allocation, risk metrics, individual stock positions, diversification, and generate rebalancing recommendations. Use when user requests portfolio review, position analysis, risk assessment, performance evaluation, or rebalancing suggestions for their brokerage account.\n---\n\n# Portfolio Manager\n\n## Overview\n\nAnalyze and manage investment portfolios by integrating with Alpaca MCP Server to fetch real-time holdings data, then performing comprehensive analysis covering asset allocation, diversification, risk metrics, individual position evaluation, and rebalancing recommendations. Generate detailed portfolio reports with actionable insights.\n\nThis skill leverages Alpaca's brokerage API through MCP (Model Context Protocol) to access live portfolio data, ensuring analysis is based on actual current positions rather than manually entered data.\n\n## When to Use\n\nInvoke this skill when the user requests:\n- \"Analyze my portfolio\"\n- \"Review my current positions\"\n- \"What's my asset allocation?\"\n- \"Check my portfolio risk\"\n- \"Should I rebalance my portfolio?\"\n- \"Evaluate my holdings\"\n- \"Portfolio performance review\"\n- \"What stocks should I buy or sell?\"\n- Any request involving portfolio-level analysis or management\n\n## Prerequisites\n\n### Alpaca MCP Server Setup\n\nThis skill requires Alpaca MCP Server to be configured and connected. The MCP server provides access to:\n- Current portfolio positions\n- Account equity and buying power\n- Historical positions and transactions\n- Market data for held securities\n\n**MCP Server Tools Used:**\n- `get_account_info` - Fetch account equity, buying power, cash balance\n- `get_positions` - Retrieve all current positions with quantities, cost basis, market value\n- `get_portfolio_history` - Historical portfolio performance data\n- Market data tools for price quotes and fundamentals\n\nIf Alpaca MCP Server is not connected, inform the user and provide setup instructions from `references\u002Falpaca_mcp_setup.md`.\n\n> **Not using Alpaca?** This skill only needs *read* access to positions, so any\n> read-capable broker or aggregator works. See\n> [Alpaca in awesome-broker-mcp](https:\u002F\u002Fgithub.com\u002Fmphinance\u002Fawesome-broker-mcp\u002Fblob\u002Fmain\u002Fbrokers\u002Falpaca.md)\n> for this connector, or use the [`broker-mcp-selector`](..\u002Fbroker-mcp-selector\u002F) skill to\n> pick a read-only route (e.g. [SnapTrade](https:\u002F\u002Fgithub.com\u002Fmphinance\u002Fawesome-broker-mcp\u002Fblob\u002Fmain\u002Faggregators\u002Fsnaptrade.md)\n> or [Truthifi](https:\u002F\u002Fgithub.com\u002Fmphinance\u002Fawesome-broker-mcp\u002Fblob\u002Fmain\u002Faggregators\u002Ftruthifi.md))\n> for accounts Alpaca doesn't cover. For analysis, prefer a **read-only** connection —\n> this skill never needs a trading scope.\n\n## Workflow\n\n### Step 1: Fetch Portfolio Data via Alpaca MCP\n\nUse Alpaca MCP Server tools to gather current portfolio information:\n\n**1.1 Get Account Information:**\n```\nUse mcp__alpaca__get_account_info to fetch:\n- Account equity (total portfolio value)\n- Cash balance\n- Buying power\n- Account status\n```\n\n**1.2 Get Current Positions:**\n```\nUse mcp__alpaca__get_positions to fetch all holdings:\n- Symbol ticker\n- Quantity held\n- Average entry price (cost basis)\n- Current market price\n- Current market value\n- Unrealized P&L ($ and %)\n- Position size as % of portfolio\n```\n\n**1.3 Get Portfolio History (Optional):**\n```\nUse mcp__alpaca__get_portfolio_history for performance analysis:\n- Historical equity values\n- Time-weighted return calculation\n- Drawdown analysis\n```\n\n**Data Validation:**\n- Verify all positions have valid ticker symbols\n- Confirm market values sum to approximate account equity\n- Check for any stale or inactive positions\n- Handle edge cases (fractional shares, options, crypto if supported)\n\n### Step 2: Enrich Position Data\n\nFor each position in the portfolio, gather additional market data and fundamentals:\n\n**2.1 Current Market Data:**\n- Real-time or delayed price quotes\n- Daily volume and liquidity metrics\n- 52-week range\n- Market capitalization\n\n**2.2 Fundamental Data:**\nUse WebSearch or available market data APIs to fetch:\n- Sector and industry classification\n- Key valuation metrics (P\u002FE, P\u002FB, dividend yield)\n- Recent earnings and financial health indicators\n- Analyst ratings and price targets\n- Recent news and material developments\n\n**2.3 Technical Analysis:**\n- Price trend (20-day, 50-day, 200-day moving averages)\n- Relative strength\n- Support and resistance levels\n- Momentum indicators (RSI, MACD if available)\n\n### Step 3: Portfolio-Level Analysis\n\nPerform comprehensive portfolio analysis using frameworks from reference files:\n\n#### 3.1 Asset Allocation Analysis\n\n**Read references\u002Fasset-allocation.md** for allocation frameworks\n\nAnalyze current allocation across multiple dimensions:\n\n**By Asset Class:**\n- Equities vs Fixed Income vs Cash vs Alternatives\n- Compare to target allocation for user's risk profile\n- Assess if allocation matches investment goals\n\n**By Sector:**\n- Technology, Healthcare, Financials, Consumer, etc.\n- Identify sector concentration risks\n- Compare to benchmark sector weights (e.g., S&P 500)\n\n**By Market Cap:**\n- Large-cap vs Mid-cap vs Small-cap distribution\n- Concentration in mega-caps\n- Market cap diversification score\n\n**By Geography:**\n- US vs International vs Emerging Markets\n- Domestic concentration risk assessment\n\n**Output Format:**\n```markdown\n## Asset Allocation\n\n### Current Allocation vs Target\n| Asset Class | Current | Target | Variance |\n|-------------|---------|--------|----------|\n| US Equities | XX.X% | YY.Y% | +\u002F- Z.Z% |\n| ... |\n\n### Sector Breakdown\n[Pie chart description or table with sector percentages]\n\n### Top 10 Holdings\n| Rank | Symbol | % of Portfolio | Sector |\n|------|--------|----------------|--------|\n| 1 | AAPL | X.X% | Technology |\n| ... |\n```\n\n#### 3.2 Diversification Analysis\n\n**Read references\u002Fdiversification-principles.md** for diversification theory\n\nEvaluate portfolio diversification quality:\n\n**Position Concentration:**\n- Identify top holdings and their aggregate weight\n- Flag if any single position exceeds 10-15% of portfolio\n- Calculate Herfindahl-Hirschman Index (HHI) for concentration measurement\n\n**Sector Concentration:**\n- Identify dominant sectors\n- Flag if any sector exceeds 30-40% of portfolio\n- Compare to benchmark sector diversity\n\n**Correlation Analysis:**\n- Estimate correlation between major positions\n- Identify highly correlated holdings (potential redundancy)\n- Assess true diversification benefit\n\n**Number of Positions:**\n- Optimal range: 15-30 stocks for individual portfolios\n- Flag if under-diversified (\u003C10 stocks) or over-diversified (>50 stocks)\n\n**Output:**\n```markdown\n## Diversification Assessment\n\n**Concentration Risk:** [Low \u002F Medium \u002F High]\n- Top 5 holdings represent XX% of portfolio\n- Largest single position: [SYMBOL] at XX%\n\n**Sector Diversification:** [Excellent \u002F Good \u002F Fair \u002F Poor]\n- Dominant sector: [Sector Name] at XX%\n- [Assessment of balance across sectors]\n\n**Position Count:** [Optimal \u002F Under-diversified \u002F Over-diversified]\n- Total positions: XX stocks\n- [Recommendation]\n\n**Correlation Concerns:**\n- [List any highly correlated position pairs]\n- [Diversification improvement suggestions]\n```\n\n#### 3.3 Risk Analysis\n\n**Read references\u002Fportfolio-risk-metrics.md** for risk measurement frameworks\n\nCalculate and interpret key risk metrics:\n\n**Volatility Measures:**\n- Estimated portfolio beta (weighted average of position betas)\n- Individual position volatilities\n- Portfolio standard deviation (if historical data available)\n\n**Downside Risk:**\n- Maximum drawdown (from portfolio history)\n- Current drawdown from peak\n- Positions with significant unrealized losses\n\n**Risk Concentration:**\n- Percentage in high-volatility stocks (beta > 1.5)\n- Percentage in speculative\u002Funprofitable companies\n- Leverage usage (if applicable)\n\n**Tail Risk:**\n- Exposure to potential black swan events\n- Single-stock concentration risk\n- Sector-specific event risk\n\n**Output:**\n```markdown\n## Risk Assessment\n\n**Overall Risk Profile:** [Conservative \u002F Moderate \u002F Aggressive]\n\n**Portfolio Beta:** X.XX (vs market at 1.00)\n- Interpretation: Portfolio is [more\u002Fless] volatile than market\n\n**Maximum Drawdown:** -XX.X% (from $XXX,XXX to $XXX,XXX)\n- Current drawdown from peak: -XX.X%\n\n**High-Risk Positions:**\n| Symbol | % of Portfolio | Beta | Risk Factor |\n|--------|----------------|------|-------------|\n| [TICKER] | XX% | X.XX | [High volatility \u002F Recent loss \u002F etc] |\n\n**Risk Concentrations:**\n- XX% in single sector ([Sector])\n- XX% in stocks with beta > 1.5\n- [Other concentration risks]\n\n**Risk Score:** XX\u002F100 ([Low\u002FMedium\u002FHigh] risk)\n```\n\n#### 3.4 Performance Analysis\n\nEvaluate portfolio performance using available data:\n\n**Absolute Returns:**\n- Overall portfolio unrealized P&L ($ and %)\n- Best performing positions (top 5 by % gain)\n- Worst performing positions (bottom 5 by % loss)\n\n**Time-Weighted Returns (if history available):**\n- YTD return\n- 1-year, 3-year, 5-year annualized returns\n- Compare to benchmark (S&P 500, relevant index)\n\n**Position-Level Performance:**\n- Winners vs Losers ratio\n- Average gain on winning positions\n- Average loss on losing positions\n- Positions near 52-week highs\u002Flows\n\n**Output:**\n```markdown\n## Performance Review\n\n**Total Portfolio Value:** $XXX,XXX\n**Total Unrealized P&L:** $XX,XXX (+XX.X%)\n**Cash Balance:** $XX,XXX (XX% of portfolio)\n\n**Best Performers:**\n| Symbol | Gain | Position Value |\n|--------|------|----------------|\n| [TICKER] | +XX.X% | $XX,XXX |\n| ... |\n\n**Worst Performers:**\n| Symbol | Loss | Position Value |\n|--------|------|----------------|\n| [TICKER] | -XX.X% | $XX,XXX |\n| ... |\n\n**Performance vs Benchmark (if available):**\n- Portfolio return: +X.X%\n- S&P 500 return: +Y.Y%\n- Alpha: +\u002F- Z.Z%\n```\n\n### Step 4: Individual Position Analysis\n\nFor key positions (top 10-15 by portfolio weight), perform detailed analysis:\n\n**Read references\u002Fposition-evaluation.md** for position analysis framework\n\nFor each significant position:\n\n**4.1 Current Thesis Validation:**\n- Why was this position initiated? (if known from user context)\n- Has the investment thesis played out or broken?\n- Recent company developments and news\n\n**4.2 Valuation Assessment:**\n- Current valuation metrics (P\u002FE, P\u002FB, etc.)\n- Compare to historical valuation range\n- Compare to sector peers\n- Overvalued \u002F Fair \u002F Undervalued assessment\n\n**4.3 Technical Health:**\n- Price trend (uptrend, downtrend, sideways)\n- Position relative to moving averages\n- Support and resistance levels\n- Momentum status\n\n**4.4 Position Sizing:**\n- Current weight in portfolio\n- Is size appropriate given conviction and risk?\n- Overweight or underweight vs optimal\n\n**4.5 Action Recommendation:**\n- **HOLD** - Position is well-sized and thesis intact\n- **ADD** - Underweight given opportunity, thesis strengthening\n- **TRIM** - Overweight or valuation stretched\n- **SELL** - Thesis broken, better opportunities elsewhere\n\n**Output per position:**\n```markdown\n### [SYMBOL] - [Company Name] (XX.X% of portfolio)\n\n**Position Details:**\n- Shares: XXX\n- Avg Cost: $XX.XX\n- Current Price: $XX.XX\n- Market Value: $XX,XXX\n- Unrealized P\u002FL: $X,XXX (+XX.X%)\n\n**Fundamental Snapshot:**\n- Sector: [Sector]\n- Market Cap: $XX.XB\n- P\u002FE: XX.X | Dividend Yield: X.X%\n- Recent developments: [Key news or earnings]\n\n**Technical Status:**\n- Trend: [Uptrend \u002F Downtrend \u002F Sideways]\n- Price vs 50-day MA: [Above\u002FBelow by XX%]\n- Support: $XX.XX | Resistance: $XX.XX\n\n**Position Assessment:**\n- **Thesis Status:** [Intact \u002F Weakening \u002F Broken \u002F Strengthening]\n- **Valuation:** [Undervalued \u002F Fair \u002F Overvalued]\n- **Position Sizing:** [Optimal \u002F Overweight \u002F Underweight]\n\n**Recommendation:** [HOLD \u002F ADD \u002F TRIM \u002F SELL]\n**Rationale:** [1-2 sentence explanation]\n```\n\n### Step 5: Rebalancing Recommendations\n\n**Read references\u002Frebalancing-strategies.md** for rebalancing approaches\n\nGenerate specific rebalancing recommendations:\n\n**5.1 Identify Rebalancing Triggers:**\n- Positions that have drifted significantly from target weights\n- Sector\u002Fasset class allocations requiring adjustment\n- Overweight positions to trim (exceeded threshold)\n- Underweight areas to add (below threshold)\n- Tax considerations (capital gains implications)\n\n**5.2 Develop Rebalancing Plan:**\n\n**Positions to TRIM:**\n- Overweight positions (>threshold deviation from target)\n- Stocks that have run up significantly (valuation concerns)\n- Concentrated positions exceeding 15-20% of portfolio\n- Positions with broken thesis\n\n**Positions to ADD:**\n- Underweight sectors or asset classes\n- High-conviction positions currently underweight\n- New opportunities to improve diversification\n\n**Cash Deployment:**\n- If excess cash (>10% of portfolio), suggest deployment\n- Prioritize based on opportunity and allocation gaps\n\n**5.3 Prioritization:**\nRank rebalancing actions by priority:\n1. **Immediate** - Risk reduction (trim concentrated positions)\n2. **High Priority** - Major allocation drift (>10% from target)\n3. **Medium Priority** - Moderate drift (5-10% from target)\n4. **Low Priority** - Fine-tuning and opportunistic adjustments\n\n**Output:**\n```markdown\n## Rebalancing Recommendations\n\n### Summary\n- **Rebalancing Needed:** [Yes \u002F No \u002F Optional]\n- **Primary Reason:** [Concentration risk \u002F Sector drift \u002F Cash deployment \u002F etc]\n- **Estimated Trades:** X sell orders, Y buy orders\n\n### Recommended Actions\n\n#### HIGH PRIORITY: Risk Reduction\n**TRIM [SYMBOL]** from XX% to YY% of portfolio\n- **Shares to Sell:** XX shares (~$XX,XXX)\n- **Rationale:** [Overweight \u002F Valuation extended \u002F etc]\n- **Tax Impact:** $X,XXX capital gain (est)\n\n#### MEDIUM PRIORITY: Asset Allocation\n**ADD [Sector\u002FAsset Class]** exposure\n- **Target:** Increase from XX% to YY%\n- **Suggested Stocks:** [SYMBOL1, SYMBOL2, SYMBOL3]\n- **Amount to Invest:** ~$XX,XXX\n\n#### CASH DEPLOYMENT\n**Current Cash:** $XX,XXX (XX% of portfolio)\n- **Recommendation:** [Deploy \u002F Keep for opportunities \u002F Reduce to X%]\n- **Suggested Allocation:** [Distribution across sectors\u002Fstocks]\n\n### Implementation Plan\n1. [First action - highest priority]\n2. [Second action]\n3. [Third action]\n...\n\n**Timing Considerations:**\n- [Tax year-end planning \u002F Earnings season \u002F Market conditions]\n- [Suggested phasing if applicable]\n```\n\n### Step 6: Generate Portfolio Report\n\nCreate comprehensive markdown report saved to repository root:\n\n**Filename:** `portfolio_analysis_YYYY-MM-DD.md`\n\n**Report Structure:**\n\n```markdown\n# Portfolio Analysis Report\n\n**Account:** [Account type if available]\n**Report Date:** YYYY-MM-DD\n**Portfolio Value:** $XXX,XXX\n**Total P&L:** $XX,XXX (+XX.X%)\n\n---\n\n## Executive Summary\n\n[3-5 bullet points summarizing key findings]\n- Overall portfolio health assessment\n- Major strengths\n- Key risks or concerns\n- Primary recommendations\n\n---\n\n## Holdings Overview\n\n[Summary table of all positions]\n\n---\n\n## Asset Allocation\n[Section from Step 3.1]\n\n---\n\n## Diversification Analysis\n[Section from Step 3.2]\n\n---\n\n## Risk Assessment\n[Section from Step 3.3]\n\n---\n\n## Performance Review\n[Section from Step 3.4]\n\n---\n\n## Position Analysis\n[Detailed analysis of top 10-15 positions from Step 4]\n\n---\n\n## Rebalancing Recommendations\n[Section from Step 5]\n\n---\n\n## Action Items\n\n**Immediate Actions:**\n- [ ] [Action 1]\n- [ ] [Action 2]\n\n**Medium-Term Actions:**\n- [ ] [Action 3]\n- [ ] [Action 4]\n\n**Monitoring Priorities:**\n- [ ] [Watch list item 1]\n- [ ] [Watch list item 2]\n\n---\n\n## Appendix: Full Holdings\n\n[Complete table with all positions and metrics]\n```\n\n### Step 7: Interactive Follow-up\n\nBe prepared to answer follow-up questions:\n\n**Common Questions:**\n\n**\"Why should I sell [SYMBOL]?\"**\n- Explain specific concerns (valuation, thesis breakdown, concentration)\n- Provide supporting data\n- Offer alternative positions if applicable\n\n**\"What should I buy instead?\"**\n- Suggest specific stocks to improve allocation\n- Explain how they address portfolio gaps\n- Provide brief investment thesis\n\n**\"What's my biggest risk?\"**\n- Identify primary risk factor (concentration, sector exposure, volatility)\n- Quantify the risk\n- Suggest mitigation strategies\n\n**\"How does my portfolio compare to [benchmark]?\"**\n- Compare allocation, sector weights, risk metrics\n- Highlight key differences\n- Assess if differences are justified\n\n**\"Should I rebalance now or wait?\"**\n- Consider market conditions, tax implications, transaction costs\n- Provide timing recommendation with rationale\n\n**\"Can you analyze [specific position] in more detail?\"**\n- Perform deep-dive analysis using us-stock-analysis skill if needed\n- Integrate findings back into portfolio context\n\n## Analysis Frameworks\n\n### Target Allocation Templates\n\nThis skill includes reference allocation models for different investor profiles:\n\n**Read references\u002Ftarget-allocations.md** for detailed models:\n\n- **Conservative** (Capital preservation, income focus)\n- **Moderate** (Balanced growth and income)\n- **Growth** (Long-term capital appreciation)\n- **Aggressive** (Maximum growth, high risk tolerance)\n\nEach model includes:\n- Asset class targets (Stocks\u002FBonds\u002FCash\u002FAlternatives)\n- Sector guidelines\n- Market cap distribution\n- Geographic allocation\n- Position sizing rules\n\nUse these as comparison benchmarks when user hasn't specified their allocation strategy.\n\n### Risk Profile Assessment\n\nIf user's target allocation is unknown, assess appropriate risk profile based on:\n- Age (if mentioned)\n- Investment timeline (if mentioned)\n- Current allocation (reveals preferences)\n- Position types (conservative vs speculative stocks)\n\n**Read references\u002Frisk-profile-questionnaire.md** for assessment framework\n\n## Output Guidelines\n\n**Tone and Style:**\n- Objective and analytical\n- Actionable recommendations with clear rationale\n- Acknowledge uncertainty in market forecasts\n- Balance optimism with risk awareness\n- Quantify whenever possible\n\n**Data Presentation:**\n- Tables for comparisons and metrics\n- Percentages for allocations and returns\n- Dollar amounts for absolute values\n- Consistent formatting throughout report\n\n**Recommendation Clarity:**\n- Explicit action verbs (TRIM, ADD, HOLD, SELL)\n- Specific quantities (sell XX shares, add $X,XXX)\n- Priority levels (Immediate, High, Medium, Low)\n- Supporting rationale for each recommendation\n\n**Visual Descriptions:**\n- Describe allocation breakdowns as if creating pie charts\n- Sector weights as bar chart equivalents\n- Performance trends with directional indicators (↑ ↓ →)\n\n## Reference Files\n\nLoad these references as needed during analysis:\n\n**references\u002Falpaca-mcp-setup.md**\n- When: User needs help setting up Alpaca MCP Server\n- Contains: Installation instructions, API key configuration, MCP server connection steps, troubleshooting\n\n**references\u002Fasset-allocation.md**\n- When: Analyzing portfolio allocation or creating rebalancing plan\n- Contains: Asset allocation theory, optimal allocation by risk profile, sector allocation guidelines, rebalancing triggers\n\n**references\u002Fdiversification-principles.md**\n- When: Assessing portfolio diversification quality\n- Contains: Modern portfolio theory basics, correlation concepts, optimal position count, concentration risk thresholds, diversification metrics\n\n**references\u002Fportfolio-risk-metrics.md**\n- When: Calculating risk scores or interpreting volatility\n- Contains: Beta calculation, standard deviation, Sharpe ratio, maximum drawdown, Value at Risk (VaR), risk-adjusted return metrics\n\n**references\u002Fposition-evaluation.md**\n- When: Analyzing individual holdings for buy\u002Fhold\u002Fsell decisions\n- Contains: Position analysis framework, thesis validation checklist, position sizing guidelines, sell discipline criteria\n\n**references\u002Frebalancing-strategies.md**\n- When: Developing rebalancing recommendations\n- Contains: Rebalancing methodologies (calendar-based, threshold-based, tactical), tax optimization strategies, transaction cost considerations, implementation timing\n\n**references\u002Ftarget-allocations.md**\n- When: Need benchmark allocations for comparison\n- Contains: Model portfolios for conservative\u002Fmoderate\u002Fgrowth\u002Faggressive investors, sector target ranges, market cap distributions\n\n**references\u002Frisk-profile-questionnaire.md**\n- When: User hasn't specified risk tolerance or target allocation\n- Contains: Risk assessment questions, scoring methodology, risk profile classification\n\n## Error Handling\n\n**If Alpaca MCP Server is not connected:**\n1. Inform user that Alpaca integration is required\n2. Provide setup instructions from references\u002Falpaca-mcp-setup.md\n3. Offer alternative: manual data entry (less ideal, user provides CSV of positions)\n\n**If API returns incomplete data:**\n- Proceed with available data\n- Note limitations in report\n- Suggest manual verification for missing positions\n\n**If position data seems stale:**\n- Flag the issue\n- Recommend refreshing connection or checking Alpaca status\n- Proceed with analysis but caveat findings\n\n**If user has no positions:**\n- Acknowledge empty portfolio\n- Offer portfolio construction guidance instead of analysis\n- Suggest using value-dividend-screener or us-stock-analysis for stock ideas\n\n## Advanced Features\n\n### Tax-Loss Harvesting Opportunities\n\nIdentify positions with unrealized losses suitable for tax-loss harvesting:\n- Positions with losses >5%\n- Holding period considerations (avoid wash sale rule)\n- Replacement security suggestions (similar but not substantially identical)\n\n### Dividend Income Analysis\n\nFor portfolios with dividend-paying stocks:\n- Estimate annual dividend income\n- Dividend growth rate trajectory\n- Dividend coverage and sustainability\n- Yield on cost for long-term holdings\n\n### Correlation Matrix\n\nFor portfolios with 5-20 positions:\n- Estimate correlation between major positions\n- Identify redundant positions (correlation >0.8)\n- Suggest diversification improvements\n\n### Scenario Analysis\n\nModel portfolio behavior under different scenarios:\n- **Bull Market** (+20% equity appreciation)\n- **Bear Market** (-20% equity decline)\n- **Sector Rotation** (Tech weakness, Value strength)\n- **Rising Rates** (Impact on growth stocks and bonds)\n\n## Example Queries\n\n**Basic Portfolio Review:**\n- \"Analyze my portfolio\"\n- \"Review my positions\"\n- \"How's my portfolio doing?\"\n\n**Allocation Analysis:**\n- \"What's my asset allocation?\"\n- \"Am I too concentrated in tech?\"\n- \"Show me my sector breakdown\"\n\n**Risk Assessment:**\n- \"Is my portfolio too risky?\"\n- \"What's my portfolio beta?\"\n- \"What are my biggest risks?\"\n\n**Rebalancing:**\n- \"Should I rebalance?\"\n- \"What should I buy or sell?\"\n- \"How can I improve diversification?\"\n\n**Performance:**\n- \"What are my best and worst positions?\"\n- \"How am I performing vs the market?\"\n- \"Which stocks are winning and losing?\"\n\n**Position-Specific:**\n- \"Should I sell [SYMBOL]?\"\n- \"Is [SYMBOL] overweight in my portfolio?\"\n- \"What should I do with [SYMBOL]?\"\n\n## Limitations and Disclaimers\n\n**Include in all reports:**\n\n*This analysis is for informational purposes only and does not constitute financial advice. Investment decisions should be made based on individual circumstances, risk tolerance, and financial goals. Past performance does not guarantee future results. Consult with a qualified financial advisor before making investment decisions.*\n\n*Data accuracy depends on Alpaca API and third-party market data sources. Verify critical information independently. Tax implications are estimates only; consult a tax professional for specific guidance.*\n","# Portfolio Manager\n\n## Overview\n\nAnalyze and manage investment portfolios by integrating with Alpaca MCP Server to fetch real-time holdings data, then performing comprehensive analysis covering asset allocation, diversification, risk metrics, individual position evaluation, and rebalancing recommendations. Generate detailed portfolio reports with actionable insights.\n\nThis skill leverages Alpaca's brokerage API through MCP (Model Context Protocol) to access live portfolio data, ensuring analysis is based on actual current positions rather than manually entered data.\n\n## When to Use\n\nInvoke this skill when the user requests:\n- \"Analyze my portfolio\"\n- \"Review my current positions\"\n- \"What's my asset allocation?\"\n- \"Check my portfolio risk\"\n- \"Should I rebalance my portfolio?\"\n- \"Evaluate my holdings\"\n- \"Portfolio performance review\"\n- \"What stocks should I buy or sell?\"\n- Any request involving portfolio-level analysis or management\n\n## Prerequisites\n\n### Alpaca MCP Server Setup\n\nThis skill requires Alpaca MCP Server to be configured and connected. The MCP server provides access to:\n- Current portfolio positions\n- Account equity and buying power\n- Historical positions and transactions\n- Market data for held securities\n\n**MCP Server Tools Used:**\n- `get_account_info` - Fetch account equity, buying power, cash balance\n- `get_positions` - Retrieve all current positions with quantities, cost basis, market value\n- `get_portfolio_history` - Historical portfolio performance data\n- Market data tools for price quotes and fundamentals\n\nIf Alpaca MCP Server is not connected, inform the user and provide setup instructions from `references\u002Falpaca_mcp_setup.md`.\n\n> **Not using Alpaca?** This skill only needs *read* access to positions, so any\n> read-capable broker or aggregator works. See\n> [Alpaca in awesome-broker-mcp](https:\u002F\u002Fgithub.com\u002Fmphinance\u002Fawesome-broker-mcp\u002Fblob\u002Fmain\u002Fbrokers\u002Falpaca.md)\n> for this connector, or use the [`broker-mcp-selector`](..\u002Fbroker-mcp-selector\u002F) skill to\n> pick a read-only route (e.g. [SnapTrade](https:\u002F\u002Fgithub.com\u002Fmphinance\u002Fawesome-broker-mcp\u002Fblob\u002Fmain\u002Faggregators\u002Fsnaptrade.md)\n> or [Truthifi](https:\u002F\u002Fgithub.com\u002Fmphinance\u002Fawesome-broker-mcp\u002Fblob\u002Fmain\u002Faggregators\u002Ftruthifi.md))\n> for accounts Alpaca doesn't cover. For analysis, prefer a **read-only** connection —\n> this skill never needs a trading scope.\n\n## Workflow\n\n### Step 1: Fetch Portfolio Data via Alpaca MCP\n\nUse Alpaca MCP Server tools to gather current portfolio information:\n\n**1.1 Get Account Information:**\n```\nUse mcp__alpaca__get_account_info to fetch:\n- Account equity (total portfolio value)\n- Cash balance\n- Buying power\n- Account status\n```\n\n**1.2 Get Current Positions:**\n```\nUse mcp__alpaca__get_positions to fetch all holdings:\n- Symbol ticker\n- Quantity held\n- Average entry price (cost basis)\n- Current market price\n- Current market value\n- Unrealized P&L ($ and %)\n- Position size as % of portfolio\n```\n\n**1.3 Get Portfolio History (Optional):**\n```\nUse mcp__alpaca__get_portfolio_history for performance analysis:\n- Historical equity values\n- Time-weighted return calculation\n- Drawdown analysis\n```\n\n**Data Validation:**\n- Verify all positions have valid ticker symbols\n- Confirm market values sum to approximate account equity\n- Check for any stale or inactive positions\n- Handle edge cases (fractional shares, options, crypto if supported)\n\n### Step 2: Enrich Position Data\n\nFor each position in the portfolio, gather additional market data and fundamentals:\n\n**2.1 Current Market Data:**\n- Real-time or delayed price quotes\n- Daily volume and liquidity metrics\n- 52-week range\n- Market capitalization\n\n**2.2 Fundamental Data:**\nUse WebSearch or available market data APIs to fetch:\n- Sector and industry classification\n- Key valuation metrics (P\u002FE, P\u002FB, dividend yield)\n- Recent earnings and financial health indicators\n- Analyst ratings and price targets\n- Recent news and material developments\n\n**2.3 Technical Analysis:**\n- Price trend (20-day, 50-day, 200-day moving averages)\n- Relative strength\n- Support and resistance levels\n- Momentum indicators (RSI, MACD if available)\n\n### Step 3: Portfolio-Level Analysis\n\nPerform comprehensive portfolio analysis using frameworks from reference files:\n\n#### 3.1 Asset Allocation Analysis\n\n**Read references\u002Fasset-allocation.md** for allocation frameworks\n\nAnalyze current allocation across multiple dimensions:\n\n**By Asset Class:**\n- Equities vs Fixed Income vs Cash vs Alternatives\n- Compare to target allocation for user's risk profile\n- Assess if allocation matches investment goals\n\n**By Sector:**\n- Technology, Healthcare, Financials, Consumer, etc.\n- Identify sector concentration risks\n- Compare to benchmark sector weights (e.g., S&P 500)\n\n**By Market Cap:**\n- Large-cap vs Mid-cap vs Small-cap distribution\n- Concentration in mega-caps\n- Market cap diversification score\n\n**By Geography:**\n- US vs International vs Emerging Markets\n- Domestic concentration risk assessment\n\n**Output Format:**\n```markdown\n## Asset Allocation\n\n### Current Allocation vs Target\n| Asset Class | Current | Target | Variance |\n|-------------|---------|--------|----------|\n| US Equities | XX.X% | YY.Y% | +\u002F- Z.Z% |\n| ... |\n\n### Sector Breakdown\n[Pie chart description or table with sector percentages]\n\n### Top 10 Holdings\n| Rank | Symbol | % of Portfolio | Sector |\n|------|--------|----------------|--------|\n| 1 | AAPL | X.X% | Technology |\n| ... |\n```\n\n#### 3.2 Diversification Analysis\n\n**Read references\u002Fdiversification-principles.md** for diversification theory\n\nEvaluate portfolio diversification quality:\n\n**Position Concentration:**\n- Identify top holdings and their aggregate weight\n- Flag if any single position exceeds 10-15% of portfolio\n- Calculate Herfindahl-Hirschman Index (HHI) for concentration measurement\n\n**Sector Concentration:**\n- Identify dominant sectors\n- Flag if any sector exceeds 30-40% of portfolio\n- Compare to benchmark sector diversity\n\n**Correlation Analysis:**\n- Estimate correlation between major positions\n- Identify highly correlated holdings (potential redundancy)\n- Assess true diversification benefit\n\n**Number of Positions:**\n- Optimal range: 15-30 stocks for individual portfolios\n- Flag if under-diversified (\u003C10 stocks) or over-diversified (>50 stocks)\n\n**Output:**\n```markdown\n## Diversification Assessment\n\n**Concentration Risk:** [Low \u002F Medium \u002F High]\n- Top 5 holdings represent XX% of portfolio\n- Largest single position: [SYMBOL] at XX%\n\n**Sector Diversification:** [Excellent \u002F Good \u002F Fair \u002F Poor]\n- Dominant sector: [Sector Name] at XX%\n- [Assessment of balance across sectors]\n\n**Position Count:** [Optimal \u002F Under-diversified \u002F Over-diversified]\n- Total positions: XX stocks\n- [Recommendation]\n\n**Correlation Concerns:**\n- [List any highly correlated position pairs]\n- [Diversification improvement suggestions]\n```\n\n#### 3.3 Risk Analysis\n\n**Read references\u002Fportfolio-risk-metrics.md** for risk measurement frameworks\n\nCalculate and interpret key risk metrics:\n\n**Volatility Measures:**\n- Estimated portfolio beta (weighted average of position betas)\n- Individual position volatilities\n- Portfolio standard deviation (if historical data available)\n\n**Downside Risk:**\n- Maximum drawdown (from portfolio history)\n- Current drawdown from peak\n- Positions with significant unrealized losses\n\n**Risk Concentration:**\n- Percentage in high-volatility stocks (beta > 1.5)\n- Percentage in speculative\u002Funprofitable companies\n- Leverage usage (if applicable)\n\n**Tail Risk:**\n- Exposure to potential black swan events\n- Single-stock concentration risk\n- Sector-specific event risk\n\n**Output:**\n```markdown\n## Risk Assessment\n\n**Overall Risk Profile:** [Conservative \u002F Moderate \u002F Aggressive]\n\n**Portfolio Beta:** X.XX (vs market at 1.00)\n- Interpretation: Portfolio is [more\u002Fless] volatile than market\n\n**Maximum Drawdown:** -XX.X% (from $XXX,XXX to $XXX,XXX)\n- Current drawdown from peak: -XX.X%\n\n**High-Risk Positions:**\n| Symbol | % of Portfolio | Beta | Risk Factor |\n|--------|----------------|------|-------------|\n| [TICKER] | XX% | X.XX | [High volatility \u002F Recent loss \u002F etc] |\n\n**Risk Concentrations:**\n- XX% in single sector ([Sector])\n- XX% in stocks with beta > 1.5\n- [Other concentration risks]\n\n**Risk Score:** XX\u002F100 ([Low\u002FMedium\u002FHigh] risk)\n```\n\n#### 3.4 Performance Analysis\n\nEvaluate portfolio performance using available data:\n\n**Absolute Returns:**\n- Overall portfolio unrealized P&L ($ and %)\n- Best performing positions (top 5 by % gain)\n- Worst performing positions (bottom 5 by % loss)\n\n**Time-Weighted Returns (if history available):**\n- YTD return\n- 1-year, 3-year, 5-year annualized returns\n- Compare to benchmark (S&P 500, relevant index)\n\n**Position-Level Performance:**\n- Winners vs Losers ratio\n- Average gain on winning positions\n- Average loss on losing positions\n- Positions near 52-week highs\u002Flows\n\n**Output:**\n```markdown\n## Performance Review\n\n**Total Portfolio Value:** $XXX,XXX\n**Total Unrealized P&L:** $XX,XXX (+XX.X%)\n**Cash Balance:** $XX,XXX (XX% of portfolio)\n\n**Best Performers:**\n| Symbol | Gain | Position Value |\n|--------|------|----------------|\n| [TICKER] | +XX.X% | $XX,XXX |\n| ... |\n\n**Worst Performers:**\n| Symbol | Loss | Position Value |\n|--------|------|----------------|\n| [TICKER] | -XX.X% | $XX,XXX |\n| ... |\n\n**Performance vs Benchmark (if available):**\n- Portfolio return: +X.X%\n- S&P 500 return: +Y.Y%\n- Alpha: +\u002F- Z.Z%\n```\n\n### Step 4: Individual Position Analysis\n\nFor key positions (top 10-15 by portfolio weight), perform detailed analysis:\n\n**Read references\u002Fposition-evaluation.md** for position analysis framework\n\nFor each significant position:\n\n**4.1 Current Thesis Validation:**\n- Why was this position initiated? (if known from user context)\n- Has the investment thesis played out or broken?\n- Recent company developments and news\n\n**4.2 Valuation Assessment:**\n- Current valuation metrics (P\u002FE, P\u002FB, etc.)\n- Compare to historical valuation range\n- Compare to sector peers\n- Overvalued \u002F Fair \u002F Undervalued assessment\n\n**4.3 Technical Health:**\n- Price trend (uptrend, downtrend, sideways)\n- Position relative to moving averages\n- Support and resistance levels\n- Momentum status\n\n**4.4 Position Sizing:**\n- Current weight in portfolio\n- Is size appropriate given conviction and risk?\n- Overweight or underweight vs optimal\n\n**4.5 Action Recommendation:**\n- **HOLD** - Position is well-sized and thesis intact\n- **ADD** - Underweight given opportunity, thesis strengthening\n- **TRIM** - Overweight or valuation stretched\n- **SELL** - Thesis broken, better opportunities elsewhere\n\n**Output per position:**\n```markdown\n### [SYMBOL] - [Company Name] (XX.X% of portfolio)\n\n**Position Details:**\n- Shares: XXX\n- Avg Cost: $XX.XX\n- Current Price: $XX.XX\n- Market Value: $XX,XXX\n- Unrealized P\u002FL: $X,XXX (+XX.X%)\n\n**Fundamental Snapshot:**\n- Sector: [Sector]\n- Market Cap: $XX.XB\n- P\u002FE: XX.X | Dividend Yield: X.X%\n- Recent developments: [Key news or earnings]\n\n**Technical Status:**\n- Trend: [Uptrend \u002F Downtrend \u002F Sideways]\n- Price vs 50-day MA: [Above\u002FBelow by XX%]\n- Support: $XX.XX | Resistance: $XX.XX\n\n**Position Assessment:**\n- **Thesis Status:** [Intact \u002F Weakening \u002F Broken \u002F Strengthening]\n- **Valuation:** [Undervalued \u002F Fair \u002F Overvalued]\n- **Position Sizing:** [Optimal \u002F Overweight \u002F Underweight]\n\n**Recommendation:** [HOLD \u002F ADD \u002F TRIM \u002F SELL]\n**Rationale:** [1-2 sentence explanation]\n```\n\n### Step 5: Rebalancing Recommendations\n\n**Read references\u002Frebalancing-strategies.md** for rebalancing approaches\n\nGenerate specific rebalancing recommendations:\n\n**5.1 Identify Rebalancing Triggers:**\n- Positions that have drifted significantly from target weights\n- Sector\u002Fasset class allocations requiring adjustment\n- Overweight positions to trim (exceeded threshold)\n- Underweight areas to add (below threshold)\n- Tax considerations (capital gains implications)\n\n**5.2 Develop Rebalancing Plan:**\n\n**Positions to TRIM:**\n- Overweight positions (>threshold deviation from target)\n- Stocks that have run up significantly (valuation concerns)\n- Concentrated positions exceeding 15-20% of portfolio\n- Positions with broken thesis\n\n**Positions to ADD:**\n- Underweight sectors or asset classes\n- High-conviction positions currently underweight\n- New opportunities to improve diversification\n\n**Cash Deployment:**\n- If excess cash (>10% of portfolio), suggest deployment\n- Prioritize based on opportunity and allocation gaps\n\n**5.3 Prioritization:**\nRank rebalancing actions by priority:\n1. **Immediate** - Risk reduction (trim concentrated positions)\n2. **High Priority** - Major allocation drift (>10% from target)\n3. **Medium Priority** - Moderate drift (5-10% from target)\n4. **Low Priority** - Fine-tuning and opportunistic adjustments\n\n**Output:**\n```markdown\n## Rebalancing Recommendations\n\n### Summary\n- **Rebalancing Needed:** [Yes \u002F No \u002F Optional]\n- **Primary Reason:** [Concentration risk \u002F Sector drift \u002F Cash deployment \u002F etc]\n- **Estimated Trades:** X sell orders, Y buy orders\n\n### Recommended Actions\n\n#### HIGH PRIORITY: Risk Reduction\n**TRIM [SYMBOL]** from XX% to YY% of portfolio\n- **Shares to Sell:** XX shares (~$XX,XXX)\n- **Rationale:** [Overweight \u002F Valuation extended \u002F etc]\n- **Tax Impact:** $X,XXX capital gain (est)\n\n#### MEDIUM PRIORITY: Asset Allocation\n**ADD [Sector\u002FAsset Class]** exposure\n- **Target:** Increase from XX% to YY%\n- **Suggested Stocks:** [SYMBOL1, SYMBOL2, SYMBOL3]\n- **Amount to Invest:** ~$XX,XXX\n\n#### CASH DEPLOYMENT\n**Current Cash:** $XX,XXX (XX% of portfolio)\n- **Recommendation:** [Deploy \u002F Keep for opportunities \u002F Reduce to X%]\n- **Suggested Allocation:** [Distribution across sectors\u002Fstocks]\n\n### Implementation Plan\n1. [First action - highest priority]\n2. [Second action]\n3. [Third action]\n...\n\n**Timing Considerations:**\n- [Tax year-end planning \u002F Earnings season \u002F Market conditions]\n- [Suggested phasing if applicable]\n```\n\n### Step 6: Generate Portfolio Report\n\nCreate comprehensive markdown report saved to repository root:\n\n**Filename:** `portfolio_analysis_YYYY-MM-DD.md`\n\n**Report Structure:**\n\n```markdown\n# Portfolio Analysis Report\n\n**Account:** [Account type if available]\n**Report Date:** YYYY-MM-DD\n**Portfolio Value:** $XXX,XXX\n**Total P&L:** $XX,XXX (+XX.X%)\n\n---\n\n## Executive Summary\n\n[3-5 bullet points summarizing key findings]\n- Overall portfolio health assessment\n- Major strengths\n- Key risks or concerns\n- Primary recommendations\n\n---\n\n## Holdings Overview\n\n[Summary table of all positions]\n\n---\n\n## Asset Allocation\n[Section from Step 3.1]\n\n---\n\n## Diversification Analysis\n[Section from Step 3.2]\n\n---\n\n## Risk Assessment\n[Section from Step 3.3]\n\n---\n\n## Performance Review\n[Section from Step 3.4]\n\n---\n\n## Position Analysis\n[Detailed analysis of top 10-15 positions from Step 4]\n\n---\n\n## Rebalancing Recommendations\n[Section from Step 5]\n\n---\n\n## Action Items\n\n**Immediate Actions:**\n- [ ] [Action 1]\n- [ ] [Action 2]\n\n**Medium-Term Actions:**\n- [ ] [Action 3]\n- [ ] [Action 4]\n\n**Monitoring Priorities:**\n- [ ] [Watch list item 1]\n- [ ] [Watch list item 2]\n\n---\n\n## Appendix: Full Holdings\n\n[Complete table with all positions and metrics]\n```\n\n### Step 7: Interactive Follow-up\n\nBe prepared to answer follow-up questions:\n\n**Common Questions:**\n\n**\"Why should I sell [SYMBOL]?\"**\n- Explain specific concerns (valuation, thesis breakdown, concentration)\n- Provide supporting data\n- Offer alternative positions if applicable\n\n**\"What should I buy instead?\"**\n- Suggest specific stocks to improve allocation\n- Explain how they address portfolio gaps\n- Provide brief investment thesis\n\n**\"What's my biggest risk?\"**\n- Identify primary risk factor (concentration, sector exposure, volatility)\n- Quantify the risk\n- Suggest mitigation strategies\n\n**\"How does my portfolio compare to [benchmark]?\"**\n- Compare allocation, sector weights, risk metrics\n- Highlight key differences\n- Assess if differences are justified\n\n**\"Should I rebalance now or wait?\"**\n- Consider market conditions, tax implications, transaction costs\n- Provide timing recommendation with rationale\n\n**\"Can you analyze [specific position] in more detail?\"**\n- Perform deep-dive analysis using us-stock-analysis skill if needed\n- Integrate findings back into portfolio context\n\n## Analysis Frameworks\n\n### Target Allocation Templates\n\nThis skill includes reference allocation models for different investor profiles:\n\n**Read references\u002Ftarget-allocations.md** for detailed models:\n\n- **Conservative** (Capital preservation, income focus)\n- **Moderate** (Balanced growth and income)\n- **Growth** (Long-term capital appreciation)\n- **Aggressive** (Maximum growth, high risk tolerance)\n\nEach model includes:\n- Asset class targets (Stocks\u002FBonds\u002FCash\u002FAlternatives)\n- Sector guidelines\n- Market cap distribution\n- Geographic allocation\n- Position sizing rules\n\nUse these as comparison benchmarks when user hasn't specified their allocation strategy.\n\n### Risk Profile Assessment\n\nIf user's target allocation is unknown, assess appropriate risk profile based on:\n- Age (if mentioned)\n- Investment timeline (if mentioned)\n- Current allocation (reveals preferences)\n- Position types (conservative vs speculative stocks)\n\n**Read references\u002Frisk-profile-questionnaire.md** for assessment framework\n\n## Output Guidelines\n\n**Tone and Style:**\n- Objective and analytical\n- Actionable recommendations with clear rationale\n- Acknowledge uncertainty in market forecasts\n- Balance optimism with risk awareness\n- Quantify whenever possible\n\n**Data Presentation:**\n- Tables for comparisons and metrics\n- Percentages for allocations and returns\n- Dollar amounts for absolute values\n- Consistent formatting throughout report\n\n**Recommendation Clarity:**\n- Explicit action verbs (TRIM, ADD, HOLD, SELL)\n- Specific quantities (sell XX shares, add $X,XXX)\n- Priority levels (Immediate, High, Medium, Low)\n- Supporting rationale for each recommendation\n\n**Visual Descriptions:**\n- Describe allocation breakdowns as if creating pie charts\n- Sector weights as bar chart equivalents\n- Performance trends with directional indicators (↑ ↓ →)\n\n## Reference Files\n\nLoad these references as needed during analysis:\n\n**references\u002Falpaca-mcp-setup.md**\n- When: User needs help setting up Alpaca MCP Server\n- Contains: Installation instructions, API key configuration, MCP server connection steps, troubleshooting\n\n**references\u002Fasset-allocation.md**\n- When: Analyzing portfolio allocation or creating rebalancing plan\n- Contains: Asset allocation theory, optimal allocation by risk profile, sector allocation guidelines, rebalancing triggers\n\n**references\u002Fdiversification-principles.md**\n- When: Assessing portfolio diversification quality\n- Contains: Modern portfolio theory basics, correlation concepts, optimal position count, concentration risk thresholds, diversification metrics\n\n**references\u002Fportfolio-risk-metrics.md**\n- When: Calculating risk scores or interpreting volatility\n- Contains: Beta calculation, standard deviation, Sharpe ratio, maximum drawdown, Value at Risk (VaR), risk-adjusted return metrics\n\n**references\u002Fposition-evaluation.md**\n- When: Analyzing individual holdings for buy\u002Fhold\u002Fsell decisions\n- Contains: Position analysis framework, thesis validation checklist, position sizing guidelines, sell discipline criteria\n\n**references\u002Frebalancing-strategies.md**\n- When: Developing rebalancing recommendations\n- Contains: Rebalancing methodologies (calendar-based, threshold-based, tactical), tax optimization strategies, transaction cost considerations, implementation timing\n\n**references\u002Ftarget-allocations.md**\n- When: Need benchmark allocations for comparison\n- Contains: Model portfolios for conservative\u002Fmoderate\u002Fgrowth\u002Faggressive investors, sector target ranges, market cap distributions\n\n**references\u002Frisk-profile-questionnaire.md**\n- When: User hasn't specified risk tolerance or target allocation\n- Contains: Risk assessment questions, scoring methodology, risk profile classification\n\n## Error Handling\n\n**If Alpaca MCP Server is not connected:**\n1. Inform user that Alpaca integration is required\n2. Provide setup instructions from references\u002Falpaca-mcp-setup.md\n3. Offer alternative: manual data entry (less ideal, user provides CSV of positions)\n\n**If API returns incomplete data:**\n- Proceed with available data\n- Note limitations in report\n- Suggest manual verification for missing positions\n\n**If position data seems stale:**\n- Flag the issue\n- Recommend refreshing connection or checking Alpaca status\n- Proceed with analysis but caveat findings\n\n**If user has no positions:**\n- Acknowledge empty portfolio\n- Offer portfolio construction guidance instead of analysis\n- Suggest using value-dividend-screener or us-stock-analysis for stock ideas\n\n## Advanced Features\n\n### Tax-Loss Harvesting Opportunities\n\nIdentify positions with unrealized losses suitable for tax-loss harvesting:\n- Positions with losses >5%\n- Holding period considerations (avoid wash sale rule)\n- Replacement security suggestions (similar but not substantially identical)\n\n### Dividend Income Analysis\n\nFor portfolios with dividend-paying stocks:\n- Estimate annual dividend income\n- Dividend growth rate trajectory\n- Dividend coverage and sustainability\n- Yield on cost for long-term holdings\n\n### Correlation Matrix\n\nFor portfolios with 5-20 positions:\n- Estimate correlation between major positions\n- Identify redundant positions (correlation >0.8)\n- Suggest diversification improvements\n\n### Scenario Analysis\n\nModel portfolio behavior under different scenarios:\n- **Bull Market** (+20% equity appreciation)\n- **Bear Market** (-20% equity decline)\n- **Sector Rotation** (Tech weakness, Value strength)\n- **Rising Rates** (Impact on growth stocks and bonds)\n\n## Example Queries\n\n**Basic Portfolio Review:**\n- \"Analyze my portfolio\"\n- \"Review my positions\"\n- \"How's my portfolio doing?\"\n\n**Allocation Analysis:**\n- \"What's my asset allocation?\"\n- \"Am I too concentrated in tech?\"\n- \"Show me my sector breakdown\"\n\n**Risk Assessment:**\n- \"Is my portfolio too risky?\"\n- \"What's my portfolio beta?\"\n- \"What are my biggest risks?\"\n\n**Rebalancing:**\n- \"Should I rebalance?\"\n- \"What should I buy or sell?\"\n- \"How can I improve diversification?\"\n\n**Performance:**\n- \"What are my best and worst positions?\"\n- \"How am I performing vs the market?\"\n- \"Which stocks are winning and losing?\"\n\n**Position-Specific:**\n- \"Should I sell [SYMBOL]?\"\n- \"Is [SYMBOL] overweight in my portfolio?\"\n- \"What should I do with [SYMBOL]?\"\n\n## Limitations and Disclaimers\n\n**Include in all reports:**\n\n*This analysis is for informational purposes only and does not constitute financial advice. Investment decisions should be made based on individual circumstances, risk tolerance, and financial goals. Past performance does not guarantee future results. Consult with a qualified financial advisor before making investment decisions.*\n\n*Data accuracy depends on Alpaca API and third-party market data sources. Verify critical information independently. Tax implications are estimates only; consult a tax professional for specific guidance.*\n",{"name":5,"description":7},"main","78b6ee6816aca6e5660cc7f0382650e9e7687086","skills\u002Fportfolio-manager",6,"https:\u002F\u002Fgithub.com\u002Fmphinance\u002Falpha-skills","https:\u002F\u002Fgithub.com\u002Fmphinance","https:\u002F\u002Fmphinance.com","2026-11-13 05:04:11",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add mphinance\u002Falpha-skills --skill portfolio-manager",{"tool":38,"command":39},"bunx","bunx skills add mphinance\u002Falpha-skills --skill portfolio-manager",{"tool":41,"command":42},"pnpm","pnpm dlx skills add mphinance\u002Falpha-skills --skill portfolio-manager","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmphinance\u002Falpha-skills\u002Fblob\u002Fmain\u002Fskills\u002Fportfolio-manager\u002FSKILL.md",true,[46,52,56,60,64,68,72,76,80,84,90],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"README.md","REFERENCE","参考文档",11535,"https:\u002F\u002Fgithub.com\u002Fmphinance\u002Falpha-skills\u002Fblob\u002Fmain\u002Fskills\u002Fportfolio-manager\u002FREADME.md",{"path":53,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":54,"sourceHtmlUrl":55},"references\u002Falpaca-mcp-setup.md",9897,"https:\u002F\u002Fgithub.com\u002Fmphinance\u002Falpha-skills\u002Fblob\u002Fmain\u002Fskills\u002Fportfolio-manager\u002Freferences\u002Falpaca-mcp-setup.md",{"path":57,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":58,"sourceHtmlUrl":59},"references\u002Fasset-allocation.md",17249,"https:\u002F\u002Fgithub.com\u002Fmphinance\u002Falpha-skills\u002Fblob\u002Fmain\u002Fskills\u002Fportfolio-manager\u002Freferences\u002Fasset-allocation.md",{"path":61,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":62,"sourceHtmlUrl":63},"references\u002Fdiversification-principles.md",18785,"https:\u002F\u002Fgithub.com\u002Fmphinance\u002Falpha-skills\u002Fblob\u002Fmain\u002Fskills\u002Fportfolio-manager\u002Freferences\u002Fdiversification-principles.md",{"path":65,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":66,"sourceHtmlUrl":67},"references\u002Fportfolio-risk-metrics.md",17129,"https:\u002F\u002Fgithub.com\u002Fmphinance\u002Falpha-skills\u002Fblob\u002Fmain\u002Fskills\u002Fportfolio-manager\u002Freferences\u002Fportfolio-risk-metrics.md",{"path":69,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":70,"sourceHtmlUrl":71},"references\u002Fposition-evaluation.md",16464,"https:\u002F\u002Fgithub.com\u002Fmphinance\u002Falpha-skills\u002Fblob\u002Fmain\u002Fskills\u002Fportfolio-manager\u002Freferences\u002Fposition-evaluation.md",{"path":73,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":74,"sourceHtmlUrl":75},"references\u002Frebalancing-strategies.md",19565,"https:\u002F\u002Fgithub.com\u002Fmphinance\u002Falpha-skills\u002Fblob\u002Fmain\u002Fskills\u002Fportfolio-manager\u002Freferences\u002Frebalancing-strategies.md",{"path":77,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":78,"sourceHtmlUrl":79},"references\u002Frisk-profile-questionnaire.md",19546,"https:\u002F\u002Fgithub.com\u002Fmphinance\u002Falpha-skills\u002Fblob\u002Fmain\u002Fskills\u002Fportfolio-manager\u002Freferences\u002Frisk-profile-questionnaire.md",{"path":81,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":82,"sourceHtmlUrl":83},"references\u002Ftarget-allocations.md",18956,"https:\u002F\u002Fgithub.com\u002Fmphinance\u002Falpha-skills\u002Fblob\u002Fmain\u002Fskills\u002Fportfolio-manager\u002Freferences\u002Ftarget-allocations.md",{"path":85,"resourceType":86,"resourceTypeDesc":87,"sizeBytes":88,"sourceHtmlUrl":89},"scripts\u002Fcheck_alpaca_connection.py","SCRIPT","脚本",10357,"https:\u002F\u002Fgithub.com\u002Fmphinance\u002Falpha-skills\u002Fblob\u002Fmain\u002Fskills\u002Fportfolio-manager\u002Fscripts\u002Fcheck_alpaca_connection.py",{"path":91,"resourceType":86,"resourceTypeDesc":87,"sizeBytes":92,"sourceHtmlUrl":93},"scripts\u002Ftests\u002Fconftest.py",301,"https:\u002F\u002Fgithub.com\u002Fmphinance\u002Falpha-skills\u002Fblob\u002Fmain\u002Fskills\u002Fportfolio-manager\u002Fscripts\u002Ftests\u002Fconftest.py",[95,103,108,115,122,129],{"skillNo":96,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":102},"01M7BANC8ZXMVWWHSY3E31AAC3","order-lifecycle-safety","Idempotency, reconcile-before-retry, audit-before-forward and environment-proof preflight rules for any code or agent that places broker orders. Use when building or reviewing an order path, handling a timeout or unknown order outcome, adding client_order_id, deciding whether a retry is safe, or confirming paper vs live before sending an order.","https:\u002F\u002Fgithub.com\u002Fmphinance\u002Falpha-skills\u002Fblob\u002Fmain\u002Fskills\u002Forder-lifecycle-safety\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":104,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":105,"categories":106,"keywords":107,"publishedAt":102},"01M7BAMZ37XP7XM8YDXWWSX0T9","https:\u002F\u002Fgithub.com\u002Fmphinance\u002Falpha-skills\u002Fblob\u002Fmain\u002Fplugins\u002Fquant-skills\u002Fskills\u002Forder-lifecycle-safety\u002FSKILL.md",[],[],{"skillNo":109,"name":110,"nameZh":6,"description":111,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":112,"categories":113,"keywords":114,"publishedAt":19},"01M74928K9ZC74YQ1GMYB4N2Q0","write-a-skill","Create new agent skills with proper structure, progressive disclosure, and bundled resources. Use when user wants to create, write, or build a new skill.","https:\u002F\u002Fgithub.com\u002Fmphinance\u002Falpha-skills\u002Fblob\u002Fmain\u002Fskills\u002Fwrite-a-skill\u002FSKILL.md",[],[],{"skillNo":116,"name":117,"nameZh":6,"description":118,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":119,"categories":120,"keywords":121,"publishedAt":19},"01M749259PAEA22A891D0EJTKK","wireframe-sketch","A hand-drawn wireframe exploration — graph-paper background, marker \u002F\npencil tone, multiple tab labels for variants, sticky-note annotations,\nscribbled chart placeholders, hatched fills. Reads like a designer's\nwhiteboard before any pixels are committed. Use when the brief asks for\n\"wireframe\", \"sketch wireframe\", \"hand-drawn\", \"lo-fi\", \"whiteboard\",\n\"草稿\", or \"手绘原型\".","https:\u002F\u002Fgithub.com\u002Fmphinance\u002Falpha-skills\u002Fblob\u002Fmain\u002Fskills\u002Fwireframe-sketch\u002FSKILL.md",[],[],{"skillNo":123,"name":124,"nameZh":6,"description":125,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":126,"categories":127,"keywords":128,"publishedAt":19},"01M74920ZWJS5Q1JRVJ8TSTQ5A","weekly-update","Single-file horizontal-swipe slide deck for a weekly team update —\nshipped, in flight, blocked, metrics, asks. 6–8 slides. Use when the\nbrief mentions \"weekly update\", \"team update slides\", \"weekly status\",\n\"周报演示\".","https:\u002F\u002Fgithub.com\u002Fmphinance\u002Falpha-skills\u002Fblob\u002Fmain\u002Fskills\u002Fweekly-update\u002FSKILL.md",[],[],{"skillNo":130,"name":131,"nameZh":6,"description":132,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":133,"categories":134,"keywords":135,"publishedAt":19},"01M7491YFRHYFV5QPS0MJ3DSNP","webull-openapi","Trade stocks, options, futures, crypto, and event contracts on Webull. Query real-time and historical market data. Manage accounts and positions. Supports US, HK, JP, SG, TH, MY, UK, MX, BR, EU, ZA, and AU regions with configurable risk controls.","https:\u002F\u002Fgithub.com\u002Fmphinance\u002Falpha-skills\u002Fblob\u002Fmain\u002Fskills\u002Fwebull-openapi\u002FSKILL.md",[],[]]