Analysing your portfolio is not about checking whether your stocks went up. A rigorous analysis examines three distinct dimensions: structural health, risk exposure, and behavioural patterns. Each reveals something the others cannot.
KlirInvest organises portfolio intelligence around three scores — each measuring a different dimension of portfolio quality.
Dimension 1: Structure — The Health Score
The Health Score (0–100) evaluates the structural quality of your portfolio. It answers: "Is this portfolio well-constructed?"
What it measures (model portfolio_health_score@2.1.0):
- Volatility — annualised portfolio standard deviation
- Tail risk (CVaR) — Expected Shortfall in the worst 5% of scenarios
- Concentration — largest single-position weight and top-5 weight sum
- Correlation stress — average pairwise correlation of your holdings (how closely they move together)
- Drawdown — depth of, and proximity to, the maximum drawdown
- Data confidence — data-quality proxy: history depth, outliers, and coverage behind every other component (NOT a market-liquidity measure)
Each component is converted into a convex penalty and combined as "100 − Σ(weight × penalty)".
Related ideas such as sector balance, geographic distribution, and asset-class balance are valuable diversification concepts but are not direct inputs to this score.
Why it matters:
A portfolio can generate strong returns while carrying structural risks that only manifest during drawdowns. The Health Score identifies these risks during calm periods, when adjustments are least costly and least emotionally driven.
Benchmark: Health Scores below 40 typically reflect elevated concentration, correlation stress, or drawdown fragility that becomes most visible when correlations rise and apparent diversification compresses.
Dimension 2: Exposure — The Risk Score
The Risk Score (model `risk_score@3.0.0`) expresses your portfolio's volatility in plain-English bands so it can be compared over time and across portfolios.
What it measures (model risk_score@3.0.0):
- Single scored input: the percentile rank of your portfolio's annualised volatility against an SPY-based historical reference distribution, returned as a 0–100 score.
- Bands: Defensive (0–25), Balanced (26–50), Aggressive (51–75), Speculative (76–100).
- Data-confidence band (displayed alongside, not scored): derived from return-history length and estimated-position-count completeness.
Related risk metrics (shown separately, not inputs to the Risk Score):
CVaR / Expected Shortfall at 95%, maximum drawdown, market beta, and Student-t tail modelling are surfaced next to the Risk Score as diagnostic context. They are not ingredients of the V3 Risk Score formula.
Why it matters:
Most investors have a vague sense of their risk tolerance but no quantified measure of their realised volatility relative to a familiar reference. The Risk Score gives a single comparable number for that one question; the related metrics above provide the rest of the risk picture.
Dimension 3: Behaviour — The Decision Readiness Score
The Decision Readiness Score (DRS) summarizes recorded personal decision-process penalties. Higher scores mean lower measured penalties, not better judgement or a recommendation to act.
What it measures:
- Trading frequency (30%) — recent real portfolio changes relative to the historical weekly baseline. Simulations are excluded from this penalty; a missing baseline does not establish a normal trading pattern.
- Risk-rule violations (30%) — breaches detected against recorded portfolio limits.
- Drawdown utilization (25%) — portfolio drawdown relative to the configured drawdown limit.
- Session activity (15%) — average session duration and actions per session, used as limited cognitive-load indicators. These do not measure your mental state.
Market regime is separate context. Reviewing an analysis or completing a checklist does not directly add points to this score.
Why it matters:
Barber and Odean (2000) reported a 6.5-percentage-point annual gap between the most active traders and the market in their historical sample. This is not a universal annual penalty or an estimate of returns recoverable with KlirInvest. The Decision Readiness Score summarizes the four recorded inputs above; it does not measure how well an investor understood an analysis.
A high DRS does not guarantee good outcomes. Research on investor behaviour suggests that consistently reviewing risk context before acting can reduce avoidable, emotion-driven decisions.
Bringing the Three Dimensions Together
Each score reveals a different vulnerability:
| Score | Reveals | Catches |
|---|---|---|
| Health Score | Structural weakness | Volatility, tail risk, position concentration, correlation stress, drawdown, data confidence |
| Risk Score | Exposure magnitude | Volatility percentile vs. an SPY-based reference distribution |
| Decision Readiness Score | Recorded process penalties | Trading frequency, risk-rule breaches, drawdown utilization, session activity |
A portfolio can have a Health Score of 80 and a DRS of 35: the two scores describe different measured inputs, and neither proves that the investor is impulsive or disciplined. A Risk Score of 30 is in the Balanced band (26–50), at or below the median of the SPY-based volatility reference scale; a score of 85 is in the Speculative band (76–100). Higher Risk Scores mean higher realized volatility, not better health. Neither band alone establishes excessive exposure or whether a portfolio is suitable.
The three scores together provide a complete picture that no single metric can.
How to Start
- Enter your holdings — ticker symbols and quantities
- Review your three scores — identify which dimension needs attention
- Examine the components — each score breaks down into actionable sub-metrics
- Model changes — use the deterministic Stress Test to size the impact of a single named shock, and the probabilistic Monte Carlo to see the outcome distribution; the two engines answer different questions and should both be consulted before executing
Try the free quick check at KlirInvest. It gives a rough Risk Score from asset-class averages, treating every symbol as an equal share. The Health Score, the Decision Readiness Score and a holdings-weighted analysis need a saved portfolio in an account.
