MCPInstall

expected-value

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.

Installs
136
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/lyndonkl/claude --skill expected-value
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads expected-value automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Expected Value

Table of Contents

Core Formula

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)

Workflow

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.

Common Patterns

Pattern 1: Investment Decision (Discrete Outcomes)

  • Structure: Go/no-go choice with 3-5 discrete scenarios (best, base, worst case)
  • Use case: Product launch, hire vs. not hire, accept investment offer, buy vs. lease
  • Pros: Simple, intuitive, easy to communicate (decision tree visualization)
  • Cons: Oversimplifies continuous distributions, binary framing may miss nuance
  • Example: Launch product feature (60% success $100k, 40% fail -$20k) → EV = $52k

Pattern 2: Portfolio Allocation (Multiple Options)

  • Structure: Allocate budget across N projects, each with own EV and risk profile
  • Use case: Venture portfolio, R&D budget, marketing spend allocation, team capacity
  • Pros: Diversification reduces variance, can optimize for risk/return tradeoff
  • Cons: Requires estimates for many variables, correlations matter (not independent)
  • Example: Invest in 3 startups ($50k each), EVs = [$20k, $15k, -$10k]. Total EV = $25k. Diversified portfolio reduces risk vs. single $150k bet.

Pattern 3: Sequential Decision (Decision Tree)

  • Structure: Series of decisions over time, outcomes of early decisions affect later options
  • Use case: Clinical trials (Phase I → II → III), staged investment, explore then exploit
  • Pros: Captures optionality (can stop if early results bad), fold-back induction finds optimal strategy
  • Cons: Tree grows exponentially, need probabilities for all branches
  • Example: Phase I drug trial (70% pass, $1M cost) → if pass, Phase II (50% pass, $5M) → if pass, Phase III (40% approve, $50M revenue). Calculate EV working backwards.

Pattern 4: Continuous Distribution (Monte Carlo)

  • Structure: Outcomes are continuous (revenue could be $0-$1M), use probability distributions
  • Use case: Financial modeling, project timelines, resource planning, sensitivity analysis
  • Pros: Captures full uncertainty, avoids discrete scenario bias, provides confidence intervals
  • Cons: Requires distributional assumptions, computationally intensive, harder to communicate
  • Example: Revenue ~ Normal($500k, $100k std dev). Run 10,000 simulations → mean = $510k, 90% CI = [$350k, $670k].

Pattern 5: Competitive Game (Payoff Matrix)

  • Structure: Your outcome depends on competitor's choice, create payoff matrix
  • Use case: Pricing strategy, product launch timing, negotiation, auction bidding
  • Pros: Incorporates strategic interaction, finds Nash equilibrium
  • Cons: Requires estimating competitor's probabilities and payoffs, game-theoretic complexity
  • Example: Price high vs. low, competitor prices high vs. low → 2×2 matrix. Calculate EV for each strategy given beliefs about competitor.

Guardrails

  1. 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.

  2. 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.

  3. Quantify uncertainty, don't hide it: Probabilities and payoffs are estimates. Use ranges, sensitivity analysis, or distributions rather than pretending false precision.

  4. 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.

  5. 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?

  6. Account for correlated outcomes: If outcomes are not independent (e.g., economic downturn affects all portfolio companies), correlation reduces diversification benefit.

  7. Time value of money: Discount future cash flows to present value. EV should use NPV, not nominal values.

  8. 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:

  • ❌ Ignoring risk aversion: EV($100k, 50/50) = EV($50k, certain) but most prefer certain $50k. Use utility functions for risk-averse agents.
  • ❌ Anchor on single scenario: "Best case is $1M!" → but probability is 5%. Focus on EV, not cherry-picked scenarios.
  • ❌ False precision: "Probability = 67.3%" when you're guessing. Use ranges, express uncertainty.
  • ❌ Sunk cost fallacy: Past costs are sunk, don't include in forward-looking EV. Only future costs/benefits matter.
  • ❌ Ignoring tail risk: Low-probability, high-impact events (0.1% chance of -$10M) can dominate EV. Don't round to zero.
  • ❌ Static analysis: Assume you can't update beliefs or change course. Real decisions allow learning and pivoting.

Quick Reference

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

  • Risk-neutral: U(x) = x (EV = EU)
  • Risk-averse: U(x) = √x or U(x) = log(x) (concave)
  • Risk-seeking: U(x) = x² (convex)

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:

  • Maximize EV: Choose option with highest EV (risk-neutral, repeated decisions)
  • Maximize EU: Choose option with highest expected utility (risk-averse, incorporates preferences)
  • Minimax regret: Minimize maximum regret across scenarios (conservative, avoid worst mistake)
  • Satisficing: Choose first option above threshold EV (bounded rationality)

Sensitivity analysis questions:

  • How much do probabilities need to change to flip decision?
  • What's EV in best case? Worst case? Which variables have most impact?
  • At what probability does EV break even (EV = 0)?

Key resources:

  • resources/template.md: Decision framing, outcome identification, EV calculation templates, sensitivity analysis
  • resources/methodology.md: Probability estimation, payoff quantification, decision tree analysis, utility functions
  • resources/evaluators/rubric_expected_value.json: Quality criteria (scenario completeness, probability calibration, payoff quantification, EV interpretation)

Inputs required:

  • Decision: What are you choosing between? (2+ mutually exclusive alternatives)
  • Outcomes: For each alternative, what could happen? (3-5 scenarios typical)
  • Probabilities: How likely is each outcome? (sum to 1.0)
  • Payoffs: What's the value (gain/loss) of each outcome? (dollars, time, utility)

Outputs produced:

  • expected-value-analysis.md: Decision framing, outcome scenarios with probabilities and payoffs, EV calculations, sensitivity analysis, recommendation with risk considerations

FAQ

What does the expected-value skill do?

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.

How do I install expected-value?

Run npx skills add https://github.com/lyndonkl/claude --skill expected-value in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/expected-value/ (personal) or .claude/skills/expected-value/ (project).

Which AI agents can use expected-value?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is expected-value safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains expected-value?

It is published by lyndonkl in lyndonkl/claude. It has 136 recorded installs.

More from lyndonkl/claude

View all →

evaluation-rubrics

lyndonkl/claude

Designs structured scoring tools with explicit criteria, performance scales, and descriptors for consistent, transparent quality assessment. Use when need quality criteria and scoring scales to evaluate work consistently, compare alternatives objectively, set acceptance thresholds, reduce subjective bias, or when user mentions rubric, scoring criteria, quality standards, evaluation framework, inter-rater reliability, or grading/assessing work.

Develops business strategies grounded in rigorous competitive and market analysis using proven frameworks (Good Strategy kernel, Porter's 5 Forces, SWOT, Blue Ocean, Playing to Win, Value Chain Analysis, BCG Matrix). Use when developing strategy (market entry, product launch, expansion, M&A, turnaround), conducting competitive analysis, making strategic decisions (build vs buy, pricing, positioning), planning strategic initiatives, or when user mentions strategy, competitive analysis, Porter's 5 Forces, SWOT, market positioning, or strategic frameworks.

Business & Finance491 installs

Guides systematic multi-pass review and editing of scientific manuscripts (research articles, reviews, perspectives) to improve clarity, structure, scientific rigor, and reader comprehension. Use when reviewing or editing research manuscripts, journal articles, or perspectives, when user mentions manuscript, paper draft, article, research writing, journal submission, reviewer feedback, or needs to improve scientific writing.

Open the skill to read its SKILL.md instructions.

Guides learners to discover knowledge through strategic Socratic questioning and progressive scaffolding removal. Combines question ladders, misconception detectors, Feynman explanations, and worked-example fading to build durable understanding. Use when teaching complex concepts, correcting misconceptions, onboarding team members, mentoring problem-solving, or designing self-paced learning. Use when user mentions "teach me", "help me understand", "explain like I'm", "learning path", "guided discovery", or "Socratic method".

Guides creation and review of competitive grant proposals (NIH R01/R21/K, NSF, foundations) by applying reviewer-perspective thinking to ensure clear hypotheses, compelling significance, genuine innovation, and feasible approaches. Use when writing or reviewing grant proposals, crafting specific aims, drafting significance/innovation/approach sections, or when user mentions R01, R21, K-series, grant writing, proposal review, study section, or fundable hypothesis.

Popular other skills

View category →

hyperframes-cli

heygen-com/hyperframes

The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.

1.3M installs

triage

mattpocock/skills

Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.

1M installs

ask-matt

mattpocock/skills

Ask which skill or flow fits your situation. A router over the skills in this repo.

778.4K installs

to-questionnaire

mattpocock/skills

Turn a decision you can't fully answer into a questionnaire for someone else to fill in.

508.9K installs

wait-what

mattpocock/skills

Stop. That last message did not land: re-pitch it.

459.7K installs

loop-me

mattpocock/skills

Grill me about specs for the workflows I want to build, within this workspace.

447.9K installs