Brad Zhang / public archive

Brad Zhang

AI product notes, agent workflow writing, and open-source dossiers for founders and early technical teams.

Open source/skill-roi-calculator

Project dossier / README

skill-roi-calculator

yizhiyanhua-ai/skill-roi-calculator

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

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

Repository reading order

Understand the workflow it replaces before deciding whether to stay in the README, open a topic path, or move toward collaboration.

01 / Workflow

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

Start by naming the old workflow this repo is replacing.

02 / README

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

Then use the README and site interpretation to confirm the project boundary and delivery surface.

03 / Proof graph

Technical distribution for AI builders

Finally, place the repository back into a bigger market question and working conversation.

github.com/yizhiyanhua-ai/skill-roi-calculator

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

Related clusters

A project page should also return to the bigger market question.

Commercial outcomes

Founding engineer fit

Design partner sprint

Developer-facing proof work

skill-roi-calculator | Open Source Project