skills/expected-value/SKILL.md
Calculates probability-weighted averages of all possible outcomes to enable rational decisions under uncertainty. Covers scenario identification, probability estimation, payoff quantification, and risk-adjusted interpretation. Use when comparing risky options (investments, product bets, strategic choices), prioritizing projects by expected return, assessing whether to take a gamble, or when user mentions expected value, EV calculation, risk-adjusted return, probability-weighted outcomes, or decision tree.
npx skillsauth add lyndonkl/claude expected-valueInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
EV = Σ (Probability of outcome x Value of outcome)
EV = (p₁ × v₁) + (p₂ × v₂) + ... + (pₙ × vₙ)
where probabilities must sum to 1.0
Example: Launch feature with 60% chance of $100k revenue, 40% chance of -$20k sunk cost. EV = (0.6 x $100k) + (0.4 x -$20k) = $60k - $8k = $52k (positive EV, rational to launch if risk tolerance allows)
Copy this checklist and track your progress:
Expected Value Analysis Progress:
- [ ] Step 1: Define decision and alternatives
- [ ] Step 2: Identify possible outcomes
- [ ] Step 3: Estimate probabilities
- [ ] Step 4: Estimate payoffs (values)
- [ ] Step 5: Calculate expected values
- [ ] Step 6: Interpret and adjust for risk preferences
Step 1: Define decision and alternatives
What decision are you making? What are the mutually exclusive options? See resources/template.md.
Step 2: Identify possible outcomes
For each alternative, what could happen? List scenarios from best case to worst case. See resources/template.md.
Step 3: Estimate probabilities
What's the probability of each outcome? Use base rates, reference classes, expert judgment, data. See resources/methodology.md.
Step 4: Estimate payoffs (values)
What's the value (gain or loss) of each outcome? Quantify in dollars, time, utility. See resources/methodology.md.
Step 5: Calculate expected values
Multiply probabilities by payoffs, sum across outcomes for each alternative. See resources/template.md.
Step 6: Interpret and adjust for risk preferences
Choose option with highest EV? Or adjust for risk aversion, non-monetary factors, strategic value. See resources/methodology.md.
Validate using resources/evaluators/rubric_expected_value.json. Minimum standard: Average score ≥ 3.5.
Pattern 1: Investment Decision (Discrete Outcomes)
Pattern 2: Portfolio Allocation (Multiple Options)
Pattern 3: Sequential Decision (Decision Tree)
Pattern 4: Continuous Distribution (Monte Carlo)
Pattern 5: Competitive Game (Payoff Matrix)
Probabilities should sum to 1.0: Listed outcomes need to be exhaustive (cover all possibilities) and mutually exclusive (no overlap). Verify: p1 + p2 + ... + pn = 1.0.
Adjust for risk on one-shot, high-stakes decisions: EV is a long-run average. For rare, irreversible decisions, factor in risk aversion. A 1% chance of $1B (EV = $10M) does not mean betting the house is rational.
Quantify uncertainty, don't hide it: Probabilities and payoffs are estimates. Use ranges, sensitivity analysis, or distributions rather than pretending false precision.
Consider non-monetary value: Some outcomes have utility not captured by money (reputation, learning, optionality, morale). Convert to a common scale or use multi-attribute utility.
Ground probabilities in data: Use base rates, reference classes, data, and expert forecasts rather than gut feel. Check calibration: are "70% confident" predictions right 70% of the time?
Account for correlated outcomes: If outcomes are not independent (e.g., economic downturn affects all portfolio companies), correlation reduces diversification benefit.
Time value of money: Discount future cash flows to present value. EV should use NPV, not nominal values.
Consider option value: In sequential decisions, fold-back induction finds optimal strategy. Factor in the option to stop early, pivot, or wait for more information.
Common pitfalls:
Key formulas:
Expected Value: EV = Σ (pᵢ × vᵢ) where p = probability, v = value
Expected Utility (for risk aversion): EU = Σ (pᵢ × U(vᵢ)) where U = utility function
Net Present Value: NPV = Σ (CF_t / (1+r)^t) where CF = cash flow, r = discount rate, t = time period
Variance (risk measure): Var = Σ (pᵢ × (vᵢ - EV)²)
Standard Deviation: σ = √Var
Coefficient of Variation (risk/return ratio): CV = σ / EV (lower = better risk-adjusted return)
Breakeven probability: p* where EV = 0. Solve: p* × v_success + (1-p*) × v_failure = 0.
Decision rules:
Sensitivity analysis questions:
Key resources:
Inputs required:
Outputs produced:
expected-value-analysis.md: Decision framing, outcome scenarios with probabilities and payoffs, EV calculations, sensitivity analysis, recommendation with risk considerationstesting
--- name: advisory-edit description: A strict advisory-only editing discipline for a writer who dictates ("speaks out") essays and wants help WITHOUT having their voice changed. The editor directs structure, flags grammar, and suggests strategic language — but never modifies the writer's text unless the writer explicitly says "apply" / "make that change" / "rewrite this." Produces a line-referenced, suggestion-only critique where every item is marked the writer's call. Four passes: structural, l
testing
Provides the house style for analyst-grade strategist writing — third-person register with sparing first-person, no em dashes, no "not X, not Y, not Z" negation cascades, numbered footnote citations rather than inline source parentheticals, specific opinion-signaling phrases, and topic-forward paragraph structure modeled on voice patterns observed in Damodaran's Musings on Markets and Thompson's Stratechery. Use when consolidating working notes into a finished long-form strategist or analyst report that must read as written by a senior human analyst rather than an AI assistant.
testing
Renders a markdown report to a PDF using pandoc with xelatex (11pt serif body, 1-inch margins, numbered footnotes, formal heading hierarchy). Requires a one-time install of pandoc and a LaTeX engine on the user's machine — basictex on macOS or texlive-xetex on Linux. Does not attempt automatic install. Fails loudly with the exact install commands if pandoc or xelatex is missing on the user's PATH. Use when producing a finished strategist or analyst report PDF from a polished markdown source.
testing
Produces step-by-step computational walkthroughs of vector and matrix operations as a sequence of numbered "frames", showing the explicit state at each step. The text-equivalent of a 3Blue1Brown animation — each frame shows what changed and why, so the learner can re-trace the operation by hand. Use when the learner needs to *see* a computation unfold (eigenvalue computation, attention with 3 tokens, gradient descent step, SVD on a 2×2, layer norm on a 3-vector, softmax of a small input), when an explanation has been given but the learner needs to ground it in a worked example, or when introducing an operation that's intimidating in symbol form but trivial in pencil-and-paper form.