Autonomous cost-benefit analysis skill that evaluates projects/initiatives by comparing total costs against total benefits in present-value terms. Calculates NPV, BCR, IRR, Payback Period, and Break-even. Supports multi-alternative comparison. Performs sensitivity analysis with scenario modeling (best/worst/base). Monetizes intangible costs and benefits. Researches market data and benchmarks via web. Generates Mermaid diagrams with optional PNG export.
How this skill is triggered — by the user, by Claude, or both
Slash command
/cost-benefit-analysis:cost-benefit-analysisThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
You evaluate projects and initiatives by comparing total costs against total benefits in present-value terms. You research industry benchmarks, market data, and comparable project costs yourself — do not ask the user for data they would need to look up. Only ask the user for decisions and confirmations.
You evaluate projects and initiatives by comparing total costs against total benefits in present-value terms. You research industry benchmarks, market data, and comparable project costs 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 industry-benchmarking (which compares performance metrics) and competitive-analysis (which evaluates strategic positioning) by providing financial evaluation of specific investment decisions.
Follow shared foundation SS7 — interview mode. When input is missing or insufficient, interview to gather at minimum:
| Dimension | Required | Default |
|---|---|---|
| Project/initiative context | Yes | — |
| Alternatives to compare | No | Will identify + "do nothing" baseline |
| Time horizon | No | 5 years (will recommend based on context) |
| Discount rate | No | Will research industry standard |
Exit interview when: Project context is clear enough to identify costs, benefits, and alternatives.
Accept one of:
From the input (or interview results), identify:
**Project**: [name]
**Alternatives**: [list including "do nothing"]
**Time horizon**: [N years]
**Discount rate**: [X% + rationale]
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.
Research relevant cost data for this type of project/industry:
Research relevant benefit data:
Research financial parameters:
Identify 2-4 alternatives to evaluate:
| ID | Alternative | Description | Key differentiator |
|---|---|---|---|
| A0 | Do Nothing | Status quo — continue current approach | Baseline for comparison |
| A1 | [name] | [description] | [differentiator] |
| A2 | [name] | [description] | [differentiator] |
For each alternative, identify and categorize all costs:
Present cost table per alternative:
| ID | Cost item | Category | Type | Year 0 | Year 1 | ... | Year N | Confidence |
|---|
For each alternative, identify and categorize all benefits:
Present benefit table per alternative:
| ID | Benefit item | Category | Type | Year 0 | Year 1 | ... | Year N | Confidence | Monetization method |
|---|
For intangible items (both costs and benefits), apply the most appropriate monetization technique:
| Technique | When to use | Example |
|---|---|---|
| Productivity-based | Time savings quantifiable | Hours saved x labor rate |
| Avoided cost | Expense prevented | Insurance claim reduction, penalty avoidance |
| Proxy metrics | Indirect chain to financial value | Satisfaction -> retention -> CLV delta |
| Market-based | Comparable pricing exists | Benchmark against market rates for equivalent |
| Expert judgment | No direct data available | Estimate with confidence range (use sparingly) |
For each alternative, calculate:
| Year | Total costs | Total benefits | Net cash flow | Discount factor (1/(1+r)^t) | PV of net | Cumulative PV |
|---|
Identify 3-5 variables with the highest impact on NPV. Common candidates:
For each key variable, vary by +/-20% and +/-40% from the base case:
| Variable | Base value | -40% | -20% | +20% | +40% | NPV impact range |
|---|
Define three scenarios with explicit assumptions:
| Scenario | Key assumptions | NPV | BCR | Payback |
|---|---|---|---|---|
| Best case | [optimistic assumptions] | |||
| Base case | [most likely assumptions] | |||
| Worst case | [pessimistic assumptions] |
For each key variable, determine the value at which NPV becomes negative (or positive for cost variables):
| Variable | Base value | Switching value | Meaning |
|---|
Rank variables by absolute NPV impact (most impactful at top) for diagram generation.
Identify project-specific risks and link to sensitivity findings:
| Risk | Probability | Impact | Related variable | NPV exposure | Mitigation |
|---|
| Metric | Do Nothing | Alternative 1 | Alternative 2 | ... |
|---|---|---|---|---|
| Total PV of costs | ||||
| Total PV of benefits | ||||
| NPV | ||||
| BCR | ||||
| IRR | ||||
| Payback Period | ||||
| Break-even | ||||
| Key risks | ||||
| Confidence level |
Rank alternatives by:
State the recommended alternative with justification covering:
Generate 4 Mermaid diagrams:
Year-by-year cumulative net cash flow showing payback point, one line per alternative.
File naming: cumulative-cash-flow.mmd / .png
Stacked bars showing cost categories vs benefit categories per alternative.
File naming: cost-benefit-breakdown.mmd / .png
Horizontal bars showing NPV impact per variable, most impactful at top.
File naming: tornado-diagram.mmd / .png
Grouped bars showing NPV for best/worst/base per alternative.
File naming: scenario-comparison.mmd / .png
Render diagrams per the diagram-rendering mixin.
Assemble the complete report:
# Cost-Benefit Analysis: [Project/Initiative]
**Date**: [date]
**Project**: [name]
**Alternatives evaluated**: [count]
**Time horizon**: [N years]
**Discount rate**: [X%]
**Recommended alternative**: [name] (NPV: [value])
## Executive Summary
[Key findings, recommended alternative, critical assumptions, primary risks]
## Methodology
[Discount rate justification, time horizon rationale, monetization approach]
## Alternatives
[Description of each alternative including "do nothing"]
## Cost Analysis
### [Alternative Name]
[Table: ID, Cost item, Category, Type, Year 0-N values, PV, Confidence]
[Subtotals by category, grand total]
## Benefit Analysis
### [Alternative Name]
[Table: ID, Benefit item, Category, Type, Year 0-N values, PV, Confidence, Monetization method]
[Subtotals by category, grand total]
## Financial Summary
### Year-by-Year Cash Flow
[Table per alternative: Year, Costs, Benefits, Net, Discount factor, PV, Cumulative]
### Key Metrics
| Metric | Alternative 1 | Alternative 2 | ... |
|---|---|---|---|
| NPV | | | |
| BCR | | | |
| IRR | | | |
| Payback Period | | | |
| Break-even | | | |
## Cumulative Cash Flow Chart
[Diagram 1]
## Cost-Benefit Breakdown
[Diagram 2]
## Sensitivity Analysis
### Key Variables
[Table: variable, base value, -40%, -20%, +20%, +40%, NPV impact]
### Tornado Diagram
[Diagram 3]
### Switching Values
[Table: variable, switching value, meaning]
### Scenarios
[Table: scenario, assumptions, NPV, BCR, payback]
### Scenario Comparison
[Diagram 4]
## Risk Assessment
[Table: risk, probability, impact, related variable, mitigation]
## Alternative Comparison & Recommendation
[Side-by-side table, ranking, recommended alternative with justification]
## Sources
[Numbered list of web sources — per autonomous-research mixin]
## Assumptions & Limitations
[Explicit list — per autonomous-research mixin]
Present for user approval. Save only after explicit confirmation.
Per the autonomous-research mixin, plus:
| Situation | Behavior |
|---|---|
| No project context | Enter interview mode (SS7) — "What project or initiative should I evaluate?" |
| Context too vague | Enter interview mode (SS7) — ask targeted questions |
| Cannot estimate key costs | Report gap, use ranges with low confidence |
| Discount rate unknown | Research industry standard, propose with justification |
| Single alternative only | Compare against "do nothing" baseline |
| Financial data unavailable | Use research-based estimates with [Assumption] labels and confidence levels |
| Intangible items unquantifiable | Use expert judgment with Low confidence and explicit range |
| IRR has no solution | Report "No IRR — cash flows do not cross zero" |
| Payback exceeds horizon | Report "Does not pay back within [N] years" |
| mmdc / web search failures | Per diagram-rendering and autonomous-research mixins |
| Out-of-scope request | "This skill performs cost-benefit analysis. [Request] is outside scope." |
Before presenting output, verify:
[] All costs categorized (direct/indirect/intangible, one-time/recurring)
[] All benefits categorized (tangible/intangible, direct/indirect)
[] Sunk costs excluded
[] Intangible items monetized with documented technique and confidence
[] Year-by-year cash flow table complete
[] NPV, BCR, IRR, Payback Period calculated
[] Discount rate justified
[] Sensitivity analysis on 3-5 key variables
[] Three scenarios defined (best/worst/base)
[] Risks identified with mitigations
[] Alternatives compared side-by-side
[] Clear recommendation with justification
[] All 4 Mermaid diagrams render valid syntax (per diagram-rendering mixin)
[] Sources listed (per autonomous-research mixin)
[] Assumptions labeled with confidence levels (per autonomous-research mixin)
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 cost-benefit-analysis