plugins/lobbi-engagement-toolkit/skills/roi-calculator/SKILL.md
Calculate automation ROI from current manual effort data and project investment figures. Use when quantifying the business case for an automation engagement or validating the financial return for a client decision-maker.
npx skillsauth add markus41/claude plugins/lobbi-engagement-toolkit/skills/roi-calculatorInstall 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.
Calculate the financial return on an automation engagement using actual client process data. Produce an ROI summary suitable for executive presentation, including payback period, first-year net benefit, and 3-year NPV.
Ask the client the following questions during discovery. Document every answer — do not estimate figures that can be collected.
Current process data:
Who performs this process?
How often does the process occur?
How long does one instance take?
What is the error rate?
Are there additional costs?
What percentage of the process will automation handle?
Calculate the total annual cost of the manual process.
Manual labor cost:
Annual volume = [frequency per period] × [periods per year]
Hours per instance = [minutes per instance] / 60
Annual hours = annual volume × hours per instance
Annual labor cost = annual hours × fully-loaded hourly rate
Error and rework cost:
Annual errors = annual volume × error rate (decimal)
Annual rework hours = annual errors × (correction time in minutes / 60)
Annual rework cost = annual rework hours × hourly rate of correction staff
Additional costs:
Annual additional costs = overtime/temp + vendor transaction fees + penalties + attrition
Total annual cost of manual process:
Total = annual labor cost + annual rework cost + annual additional costs
Labor hours recovered by automation:
Straight-through volume = annual volume × straight-through rate
Hours recovered from straight-through = straight-through volume × (minutes per instance / 60)
Exception volume = annual volume × exception rate
Hours recovered from exceptions = exception volume × ((minutes per instance - exception review time) / 60)
Total hours recovered = hours recovered from straight-through + hours recovered from exceptions
Annual labor savings = total hours recovered × hourly rate
Error reduction savings:
Automation error rate (assume 0.1% for well-designed systems, vs. current [X]%)
Remaining annual errors = annual volume × 0.001
Rework hours saved = (annual errors - remaining annual errors) × (correction time / 60)
Annual error savings = rework hours saved × hourly rate
Additional cost savings:
Eliminated overtime/temp: $[X]/year
Eliminated per-transaction vendor fees: $[X] × straight-through volume
Annual additional savings = sum of eliminated costs
Total annual savings:
Total annual savings = annual labor savings + annual error savings + annual additional savings
Project investment:
Total project fee: $[Investment]
Ongoing annual cost (maintenance, hosting, licensing): $[Annual ongoing]
Year 1 total cost: Project fee + annual ongoing
Year 2–3 total cost per year: Annual ongoing only
ROI metrics:
| Metric | Formula | Value | |--------|---------|-------| | First-year net benefit | Total annual savings − Year 1 total cost | $[X] | | First-year ROI | (Net benefit / Year 1 total cost) × 100 | [X]% | | Payback period | Year 1 total cost / (Total annual savings / 12) | [N] months | | Year 2 net benefit | Total annual savings − Annual ongoing | $[X] | | Year 3 net benefit | Total annual savings − Annual ongoing | $[X] | | 3-year cumulative savings | Sum of year 1–3 savings | $[X] | | 3-year total cost | Year 1 cost + (Year 2+3 ongoing × 2) | $[X] | | 3-year NPV (10% discount rate) | NPV formula below | $[X] |
3-year NPV calculation:
Discount rate: 10% (standard corporate hurdle rate)
Year 1 net cash flow: total annual savings − year 1 total cost
Year 2 net cash flow: total annual savings − annual ongoing
Year 3 net cash flow: total annual savings − annual ongoing
NPV = Year1_CF / (1.10)^1 + Year2_CF / (1.10)^2 + Year3_CF / (1.10)^3
Show how ROI changes if key assumptions vary. Helps the client see the floor.
| Scenario | Assumption Change | Annual Savings | Payback Period | |---------|------------------|----------------|---------------| | Base case | As collected | $[X] | [N] months | | Conservative (-20%) | 20% lower volume or savings rate | $[X] | [N] months | | Optimistic (+20%) | 20% higher volume or straight-through rate | $[X] | [N] months | | Break-even | Minimum savings to achieve 24-month payback | $[X] | 24 months |
Break-even volume: The minimum annual transaction volume at which the project pays back within 24 months:
Break-even annual savings = Year 1 total cost / 2
Break-even volume = break-even annual savings / (savings per transaction)
Produce a one-page ROI summary for executive presentation:
[Client Name] — Automation ROI Summary
| | Current State | Automated | |--|--|--| | Annual process volume | [N] transactions | [N] transactions | | Manual hours per year | [N] hours | [N] hours (exceptions only) | | Annual labor cost | $[X] | $[X] | | Annual error cost | $[X] | $[X] | | Total annual cost | $[X] | $[X] |
Investment and Return:
| | | |--|--| | Project investment | $[Amount] | | Annual ongoing cost | $[Amount] | | Annual net savings | $[Amount] | | First-year ROI | [X]% | | Payback period | [N] months | | 3-year NPV | $[Amount] |
Based on [volume] transactions/year at $[rate]/hour, [X]% automation rate, and [X]% current error rate. Actual results may vary.
development
Enhanced plan-authoring skill with Pre-Writing context gathering, task metadata, non-TDD templates, Red Flags, telemetry, and an automated plan linter. Use when you have a spec or requirements for a multi-step task, before touching code.
tools
Documentation intelligence engine with graph-based API docs, algorithm library, and drift detection
tools
Ultraplan cloud planning — kick off a plan in the cloud from your terminal, review and revise in the browser, then execute remotely or send back to CLI
tools
--- name: mcp description: Configure MCP servers for Claude Code — stdio vs HTTP, authentication, Tools/Resources/Prompts distinction, channels (CI webhook, mobile relay, Discord bridge, fakechat), and cost of always-loaded tools. Use this skill whenever adding an MCP server, debugging connection issues, choosing between MCP Tools vs Prompts vs Resources, installing channel servers, or managing .mcp.json. Triggers on: "MCP server", "mcp config", "add Obsidian MCP", "install context7", "channels"