Portfolio analysis

Turn a broker statement into an auditable portfolio review. Keep statement facts, current research, investor assumptions and recommendations separate. The Python helper is offline and deterministic; the agent does the research and writes the finished Markdown report.

This skill produces research and conditional suggestions, not personalized financial advice. A review never authorizes trades, tax filings, account changes, scheduling or publishing.

1. Establish scope and parse

Read ibkr-input.md for IBKR files. Resolve the input, analysis cutoff and output location from the request. Default to a new reports/{analysis-date}-{run-id}/ in the user's working directory, never inside this skill folder, and keep earlier runs intact. Use the user's local date as the analysis date and keep the statement's valuation date separate. A historical review uses only evidence available by its cutoff.

Both activity-only declarations and full portfolio exports are supported. For full exports the helper reads BaseCurrency cash summaries and takes ending NAV from dated equity-summary rows; earlier daily NAV rows are not holdings.

Run with Python 3.9+ (standard library only) from the user's working directory; <skill-dir> is this skill's folder:

python3 <skill-dir>/scripts/analyze_portfolio.py --input /absolute/path/to/statement.xml \
  --format ibkr --out-dir /absolute/path/to/new-run