investing

star 12

Personal portfolio management and investment analysis skill. Use when: (1) Checking portfolio risk (ES, VaR, drawdown), (2) Running rebalancing or optimization, (3) Equity research and valuation, (4) Tax-loss harvesting analysis, (5) Policy/regulatory impact assessment, (6) Performance attribution and benchmarking. Tools: 7 investing-workspace MCP servers + ghostfolio-mcp for portfolio tracking.

hvkshetry By hvkshetry schedule Updated 3/13/2026

name: investing description: | Personal portfolio management and investment analysis skill. Use when: (1) Checking portfolio risk (ES, VaR, drawdown), (2) Running rebalancing or optimization, (3) Equity research and valuation, (4) Tax-loss harvesting analysis, (5) Policy/regulatory impact assessment, (6) Performance attribution and benchmarking. Tools: 7 investing-workspace MCP servers + ghostfolio-mcp for portfolio tracking.

Investment Management

Critical Constraint: ES < 2.5%

Expected Shortfall at 97.5% confidence must remain below 2.5%. This is the binding risk constraint. Check ES before and after any proposed trade or rebalance.

Tool Mapping

Task Server Key Tools
Current holdings & allocations portfolio-state get_positions, get_portfolio_summary, get_tax_lots
Risk metrics (ES, VaR, drawdown) risk calculate_es, calculate_var, stress_test, correlation_matrix
Portfolio optimization portfolio-optimization optimize_portfolio, efficient_frontier, black_litterman
Tax analysis tax get_tax_lots, calculate_gains, wash_sale_check
Tax-loss harvesting tax-optimization find_tlh_opportunities, simulate_harvest, tax_efficient_rebalance
Market data & fundamentals openbb-curated equity_price_historical, equity_fundamental_*, economy_*
SEC filings openbb-curated regulators_sec_section_extract, equity_fundamental_filings
News & events openbb-curated news_search (GDELT — keywords must be 3+ chars)
Policy impact policy-events search_bills, get_bill_detail, search_regulations
Portfolio tracking ghostfolio get_portfolio_summary, get_portfolio_performance, get_dividends

Workflow: Daily Check

  1. get_portfolio_summary — current value, allocation, cash position
  2. calculate_es — verify ES < 2.5%
  3. get_positions — check for any position > 10% of portfolio
  4. news_search — scan for news on top holdings
  5. Report: ES status, notable moves, concentration risk, news alerts

Workflow: Rebalancing

  1. get_portfolio_summary — current allocations
  2. optimize_portfolio — target allocation (mean-variance or Black-Litterman)
  3. calculate_es on proposed allocation — verify ES < 2.5%
  4. find_tlh_opportunities — check for tax-loss harvesting before trading
  5. tax_efficient_rebalance — generate trade list minimizing tax impact
  6. Present: proposed trades, expected ES, tax impact, estimated costs

Workflow: Equity Research

  1. equity_price_historical — price trend and technicals
  2. equity_fundamental_* — revenue, earnings, margins, valuation multiples
  3. equity_fundamental_filings + regulators_sec_section_extract — read 10-K risk factors and MD&A
  4. news_search — recent news and sentiment
  5. search_bills / search_regulations — regulatory exposure
  6. Present: thesis, valuation range, risks, position sizing recommendation

Workflow: Tax Planning

  1. get_tax_lots — all lots with cost basis and holding period
  2. calculate_gains — realized and unrealized gains/losses by short/long-term
  3. find_tlh_opportunities — losses available for harvesting
  4. wash_sale_check — verify no wash sale violations
  5. Present: tax liability estimate, TLH opportunities, wash sale risks

Holistic Tax Planning

For tax decisions that span both investment and household income, treat household-tax-mcp as an exact, fail-closed engine with a narrow 2026 US and MA support surface. Use assess_exact_support first, then the exact return and safe-harbor/distribution tools only when the case fits. For Roth conversions, broad gain realization, or other unsupported scenarios, state that exact household-tax support is unavailable and keep the tax discussion bounded.

The investing-workspace tax servers still handle investment-specific tax (wash sales, TLH, cost basis).

Key Rules

  • Tool-First Data: ALL metrics must come from MCP tool calls with timestamps
  • No Fabrication: If a tool returns no data, report the gap — never estimate
  • ES Binding: Any recommendation that pushes ES > 2.5% must include a RISK ALERT
  • GDELT Queries: Use full terms ("artificial intelligence" not "AI") — min 3 chars per keyword
  • SEC Sections: Max 2 chunks per section, ~15K tokens total per extract call
Install via CLI
npx skills add https://github.com/hvkshetry/StewardOS --skill investing
Repository Details
star Stars 12
call_split Forks 6
navigation Branch main
article Path SKILL.md
More from Creator