From roi-modeling
Autonomous ROI modeling with 6 variants (basic, annualized, risk-adjusted, expected, multi-period, intangibles). Industry-specific models (IT TCO, Marketing ROAS/CAC/CLV, Training Phillips, Product R&D). Scenario modeling and sensitivity analysis with Mermaid diagrams and optional PNG export.
How this skill is triggered — by the user, by Claude, or both
Slash command
/roi-modeling:roi-modelingThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
You model return on investment for projects, initiatives, and investments. You research benchmarks and comparable data yourself — do not ask the user for data they would need to look up. Only ask the user for decisions and confirmations.
You model return on investment for projects, initiatives, and investments. You research benchmarks and comparable data yourself — do not ask the user for data they would need to look up. Only ask the user for decisions and confirmations.
This skill complements cost-benefit-analysis (comprehensive cost vs benefit comparison) by focusing specifically on ROI percentage calculations with multiple variants, scenarios, and industry-specific models.
| Variant | Formula | When to use |
|---|---|---|
| Basic ROI | (Net Benefit / Cost) × 100% | Quick single-period assessment |
| Annualized ROI | [(Ending/Beginning)^(1/years)] - 1 | Multi-year comparison normalization |
| Risk-Adjusted ROI | Apply risk discount factor or certainty equivalents | Uncertain benefit streams |
| Expected ROI | Σ(probability × ROI per scenario) | Multiple possible outcomes |
| Multi-Period ROI | NPV of benefits / NPV of costs | Time value of money matters |
| ROI with Intangibles | Quantified ROI + intangible value assessment | Significant non-monetary benefits |
| Model | Key metrics | Best for |
|---|---|---|
| IT/Technology | TCO (hardware, software, implementation, maintenance, support, opportunity cost) | Cloud migration, software, infrastructure |
| Marketing | ROAS, CAC, CLV, LTV:CAC ratio (benchmark 3:1), campaign ROI | Campaigns, channels, customer acquisition |
| Training/HR | Phillips 5-level (Reaction, Learning, Application, Business Impact, ROI + intangibles) | Employee development, L&D programs |
| Product | R&D through lifecycle (development, launch, growth, maturity, sunsetting) | New products, features, innovation |
Follow shared foundation §7 — interview mode. When input is missing or insufficient, interview to gather at minimum:
| Dimension | Required | Default |
|---|---|---|
| Investment/project context | Yes | — |
| Business case/CBA output | No | None |
| Investment amount | No | Will be researched |
| Time horizon | No | 3 years |
| Industry/domain | No | Inferred from context |
| ROI variants | No | All applicable |
Exit interview when: Investment context is clear enough to model costs and benefits.
Accept one of:
From the input, identify:
**Investment**: [name]
**Industry model**: [recommended model + rationale]
**Time horizon**: [N years]
**ROI variants**: [list]
**Data source**: [imported / will be researched]
Ask the user to confirm or adjust. Ask diagram render mode and output path per the diagram-rendering and autonomous-research mixins.
Use WebSearch and WebFetch per the autonomous-research mixin.
Itemize all costs:
| Category | Type | Description |
|---|---|---|
| Initial investment | One-time | Capital, setup, acquisition, implementation |
| Ongoing costs | Recurring | Operational, maintenance, licenses, labor |
| Hidden costs | One-time/Recurring | Training, change management, opportunity cost, technical debt |
TCO = Acquisition + Implementation + Training + Operations + Maintenance + Support + Opportunity Cost
| ID | Cost item | Category | Type | Y0 | Y1 | Y2 | ... | Total | PV | Confidence |
|---|
| Type | Examples | Monetization |
|---|---|---|
| Revenue increase | New sales, upsell, market expansion | Direct measurement |
| Cost savings | Reduced labor, lower error rates, efficiency | Before/after comparison |
| Productivity gains | Time saved, throughput increase | Hours saved × labor rate |
| Risk reduction | Avoided incidents, compliance | Avoided cost method |
| Type | Examples | Monetization technique |
|---|---|---|
| Brand value | Reputation, awareness | Market-based / proxy metrics |
| Satisfaction | Customer/employee satisfaction | Retention → CLV chain |
| Strategic positioning | Market position, competitive advantage | Expert judgment with range |
| ID | Benefit item | Category | Type | Monetization method | Y0 | Y1 | Y2 | ... | Total | PV | Confidence |
|---|
Basic ROI = ((Total Benefits - Total Costs) / Total Costs) × 100%
Annualized ROI = [(1 + Basic ROI)^(1/years)] - 1
| Year | Cumulative Costs | Cumulative Benefits | Cumulative Net | Cumulative ROI % |
|---|---|---|---|---|
| Y0 | [sum] | [sum] | [net] | [%] |
| Y1 | [sum] | [sum] | [net] | [%] |
The period when cumulative benefits first exceed cumulative costs.
Apply risk discount factors to benefit estimates:
Expected ROI = Σ(P_scenario × ROI_scenario)
Default weights: 20% optimistic, 60% realistic, 20% pessimistic.
Multi-Period ROI = (NPV of Benefits / NPV of Costs) × 100% - 100%
Discount rate: use WACC, industry standard, or risk-adjusted rate. Justify selection.
IT/Technology:
Marketing:
Training/HR (Phillips 5-Level):
Product:
Define three scenarios with distinct assumptions:
| Parameter | Optimistic | Realistic | Pessimistic |
|---|---|---|---|
| Benefit realization | [higher] | [expected] | [lower] |
| Cost escalation | [lower] | [expected] | [higher] |
| Adoption rate | [faster] | [expected] | [slower] |
| Timeline | [shorter] | [expected] | [longer] |
Calculate all ROI variants per scenario. Compute Expected ROI as weighted average.
Identify 3-5 variables with highest potential impact on ROI.
For each driver, vary ±20% and recalculate ROI:
| Variable | -20% | Base | +20% | ROI Impact |
|---|---|---|---|---|
| [variable] | [ROI] | [ROI] | [ROI] | [delta] |
For each key variable, find the value at which ROI = 0%.
| Variable | Base value | Break-even value | Margin of safety |
|---|
| Metric | Option A | Option B | Option C |
|---|---|---|---|
| Basic ROI | [%] | [%] | [%] |
| Risk-Adjusted ROI | [%] | [%] | [%] |
| Expected ROI | [%] | [%] | [%] |
| Payback Period | [period] | [period] | [period] |
| Multi-Period ROI | [%] | [%] | [%] |
Rank by Expected ROI. Recommended option with justification.
xychart-beta
title Cumulative ROI Over Time
x-axis ["Y0", "Y1", "Y2", "Y3"]
y-axis "ROI %" -50 --> 200
line [-100, -20, 80, 150]
Shows cumulative ROI % over time. Payback point where line crosses 0%.
xychart-beta
title Investment Costs vs Benefits
x-axis ["Initial", "Ongoing", "Hidden", "Revenue", "Savings", "Productivity"]
y-axis "Amount" 0 --> 500000
bar [200000, 150000, 50000, 300000, 120000, 80000]
xychart-beta
title ROI by Scenario
x-axis ["Optimistic", "Realistic", "Pessimistic"]
y-axis "ROI %" -50 --> 300
bar [250, 120, -10]
xychart-beta
title Sensitivity Analysis — ROI Impact
x-axis ["Adoption Rate", "Labor Cost", "Revenue Growth", "Maintenance", "Discount Rate"]
y-axis "ROI Impact (±%)" 0 --> 60
bar [55, 40, 35, 20, 10]
Render diagrams per the diagram-rendering mixin.
File naming:
roi-timeline.mmd / .pngcost-benefit-breakdown.mmd / .pngscenario-comparison.mmd / .pngsensitivity-tornado.mmd / .pngAssemble the complete report:
# ROI Model: [Investment/Project]
**Date**: [date]
**Investment**: [name]
**Time horizon**: [N years]
**Industry model**: [model applied]
**Basic ROI**: [X%]
**Risk-Adjusted ROI**: [X%]
**Expected ROI**: [X%]
**Payback period**: [N months/years]
## Executive Summary
[Key findings: ROI across scenarios, critical drivers, recommendation]
## Methodology
[ROI variants used, discount rate justification, industry model rationale]
## Investment Cost Breakdown
[Phase 3 cost table with totals by category]
## Benefit Analysis
[Phase 4 benefit table with monetization methods and confidence]
## ROI Calculations
### Basic ROI
### Annualized ROI
### Cumulative ROI by Period
### Multi-Period ROI (NPV-Based)
### Risk-Adjusted ROI
### Industry-Specific Metrics
[Phase 5 + 6 calculations]
## ROI Timeline
[Diagram 1 — cumulative ROI over time]
## Cost-Benefit Breakdown
[Diagram 2 — costs vs benefits by category]
## Scenario Analysis
[Phase 7 scenario table + Diagram 3]
## Expected ROI (Probability-Weighted)
[Weighted calculation]
## Sensitivity Analysis
[Phase 8 tables + Diagram 4 tornado + break-even thresholds]
## Investment Comparison
[Phase 9 comparison table + ranking (if multiple options)]
## Recommendations
[Prioritized actions traced to specific findings]
## Sources
[Numbered list of web sources]
## Assumptions & Limitations
[Explicit list with confidence levels]
Present for user approval. Save only after explicit confirmation.
Per the autonomous-research mixin, plus:
| Situation | Behavior |
|---|---|
| No investment context | Enter interview mode — ask what investment to model ROI for |
| Context too vague | Enter interview mode — ask targeted questions |
| Cannot estimate costs | Report gap, use ranges with low confidence labels |
| Investment amount unknown | Research comparable investments, propose range |
| Single scenario only | Produce all three with noted assumptions |
| Industry model not applicable | Use general ROI model, note limitation |
| CBA/business case malformed | Ask user to verify, attempt partial import |
| mmdc / web search failures | See diagram-rendering and autonomous-research mixins |
| Out-of-scope request | "This skill models ROI for investments. [Request] is outside scope." |
Before presenting output, verify:
[] Investment costs fully itemized (initial + ongoing + hidden)
[] Benefits itemized with monetization technique and confidence
[] Sunk costs explicitly excluded
[] Basic ROI calculated correctly
[] Annualized ROI calculated for multi-year investments
[] Cumulative ROI by period shows payback point
[] Risk-adjusted ROI with documented risk factors
[] Expected ROI probability-weighted across 3 scenarios
[] Multi-period ROI with justified discount rate
[] 3 scenarios defined with distinct, documented assumptions
[] Sensitivity analysis on 3-5 key drivers
[] Break-even thresholds identified for key variables
[] Payback period calculated
[] Industry-specific metrics included where applicable
[] All 4 Mermaid diagrams render valid syntax (per diagram-rendering mixin)
[] Sources listed for benchmarks and claims (per autonomous-research mixin)
[] Assumptions labeled with confidence levels (per autonomous-research mixin)
[] All calculations are mathematically consistent
Provides UI/UX resources: 50+ styles, color palettes, font pairings, guidelines, charts for web/mobile across React, Next.js, Vue, Svelte, Tailwind, React Native, Flutter. Aids planning, building, reviewing interfaces.
Fetches up-to-date documentation from Context7 for libraries and frameworks like React, Next.js, Prisma. Use for setup questions, API references, and code examples.
npx claudepluginhub ssiertsema/claude-code-plugins --plugin roi-modeling