Project dossier

skill-roi-calculator

An ROI lens for deciding whether an AI skill is worth operationalizing.

Python · 0 stars / 0 forks · Active Jan 25, 2026 · GitHub

What this repository answers

Skill ROI Calculator 🇨🇳 中文 Calculate the Return on Investment (ROI) for Skills to evaluate whether development is worthwhile.

Workflow replaced: Shipping AI utilities with no model for time saved, effort required, or adoption payoff.

Why it matters: The next wave of AI work needs economic judgment, not just enthusiasm. ROI tooling makes that judgment explicit.

How it gets used

Evaluate whether a workflow deserves to become a product or internal standard.
Add commercial discipline to AI workflow design.

README

Skill ROI Calculator

🇨🇳 中文

Calculate the Return on Investment (ROI) for Skills to evaluate whether development is worthwhile.

Features

Calculate development costs (developer time, expert time, maintenance)
Estimate benefits (time saved, labor cost reduction)
Generate ROI analysis reports
Support both Chinese and English output

Usage

# Full ROI calculation
python scripts/calculate_roi.py \
  --skill-name "contract-reviewer" \
  --dev-hours 4 \
  --hourly-rate 150 \
  --expert-hours 8 \
  --expert-rate 300 \
  --usage-count 156 \
  --time-saved 15 \
  --user-rate 200 \
  --period 3

# Output as JSON
python scripts/calculate_roi.py --json ...

# English output
python scripts/calculate_roi.py --lang en ...

ROI Rating Scale

ROI	Rating	Recommendation
> 200%	Excellent	Highly recommended, expand to other departments
100-200%	Good	Worth the investment, continue optimizing
50-100%	Average	Acceptable, needs usage improvement
0-50%	Low	Needs re-evaluation
< 0%	Negative	Consider stopping investment

License

MIT