Business Case

What it does

When your agent uses it

• Building financial justification
• Cost-benefit analysis
• Build-vs-buy comparisons
• Sensitivity analysis

Example prompts

• “/business-case”

Requirements

• Compatibility (from SKILL.md): Claude Code 2.1.277+
• Pre-approved tools (allowed-tools): Read, Glob, Grep, WebFetch, WebSearch

What it can do on your machine

Read from SKILL.md and the folder at commit e4ff8d9. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • Read
  • Glob
  • Grep
  • WebFetch
  • WebSearch

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

• Compatibility

  Claude Code 2.1.277+

  From compatibility in the SKILL.md frontmatter.

Context cost

Business Case loads about 1.3k tokens when it runs, and up to ~2.9k if it reads all its reference files. Until then it costs about 59 tokens; SKILL.md has 254 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~59

When it runs · the whole SKILL.md, loaded when a task matches

~1.3k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~2.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from yonatangross/orchestkit at commit e4ff8d9, republished under its MIT licence (© yonatangross). 254 words, ~1,261 tokens.

name

business-case

description

Business case analysis with ROI, NPV, IRR, payback period, and TCO calculations for investment decisions. Use when building financial justification, cost-benefit analysis, build-vs-buy comparisons, or sensitivity analysis.

allowed-tools

Read, Glob, Grep, WebFetch, WebSearch

compatibility

Claude Code 2.1.277+

user-invocable

false

disable-model-invocation

false

metadata.owner-agent

product-strategist

metadata.category

document-asset-creation

metadata.version

1.0.0

metadata.author

OrchestKit

metadata.complexity

medium

metadata.tags

roi, npv, irr, tco, build-vs-buy, financial-analysis, cost-benefit

Is the investment multi-year?
  YES → Use NPV (+ IRR to compare alternatives)
  NO  → ROI is sufficient

Is this a build vs. buy decision?
  YES → TCO comparison across all three options
  NO  → Skip TCO, use NPV/ROI

Are assumptions uncertain?
  YES → Add sensitivity analysis (3 scenarios)
  NO  → Base case only

ROI = (Net Benefits - Total Costs) / Total Costs × 100%

NPV = Sum(Cash Flow_t / (1 + r)^t) - Initial Investment
  r = discount rate (10% enterprise, 15-20% growth, 25-40% startup)
  Decision: Accept if NPV > 0

IRR = discount rate where NPV = 0
  Decision: Accept if IRR > hurdle rate

Payback Period = Initial Investment / Annual Cash Flow
  Benchmarks: SaaS 6-12 mo, Enterprise platform 12-24 mo, Infra 24-36 mo

TCO = CAPEX + (OPEX × years) + Opportunity Cost + Hidden Costs

# Business Case: [Project Name]

## Executive Summary
[2-3 sentences: what we're investing in and expected return]

## Financial Analysis

### Investment Required
| Item | One-Time | Annual |
|------|----------|--------|
| Development | $X | |
| License / SaaS | | $X |
| Implementation | $X | |
| Training | $X | |
| Maintenance | | $X |
| **Total** | **$X** | **$X** |

### Expected Benefits
| Benefit | Annual Value | Confidence |
|---------|--------------|------------|
| Time savings (X hrs × $Y/hr) | $X | High |
| Error reduction | $X | Medium |
| Revenue uplift | $X | Low |
| **Total** | **$X** | |

### Key Metrics
| Metric | Value |
|--------|-------|
| 3-Year TCO | $X |
| NPV (10% discount) | $X |
| IRR | X% |
| Payback Period | X months |
| ROI | X% |

## Sensitivity Analysis
| Scenario | Discount Rate | Year 1 Benefits | NPV |
|----------|---------------|-----------------|-----|
| Base case | 10% | $X | $X |
| Conservative | 15% | $X × 0.75 | $X |
| Optimistic | 8% | $X × 1.25 | $X |

## Risk Analysis
| Risk | Probability | Impact | Mitigation |
|------|-------------|--------|------------|
| | | | |

## Recommendation
[GO / NO-GO] — [one-sentence rationale]

© yonatangross, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 6 other files (references) in src/skills/business-case of yonatangross/orchestkit.

• SKILL.md
• references/build-buy-partner-decision.md
• references/roi-calculation-guide.md
• rules/_sections.md
• rules/business-cost-benefit.md
• rules/business-roi.md
• test-cases.json

Open the folder on GitHubat commit e4ff8d9