cost-benefit
Cost-benefit analysis. Produces economic NPV and financial NPV side by side, with BCR, optimism bias (with mitigation), Marginal Excess Tax Burden, real-terms rebasing, WELLBY / QALY / VPF wellbeing valuation, sensitivity, switching values, EANC for unequal-life options, validation gate, and a one-l…
Install / Use
npx skills add brycewang-stanford/Auto-Empirical-Research-Skills --skill cost-benefitInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Customer SupportSupported Platforms
Tags
Our assessment of cost-benefit
cost-benefit scores 86/100 on our quality scale, 211th of 319 Customer Support skills we index.
Its SKILL.md is 43 KB long, well organised into 49 sections with 29 code examples: long enough that it reads more like full documentation than a focused instruction file, which agents can find harder to follow.
With 4,360 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so cost-benefit is actively maintained.
- Our last check on 2026-11-03 found the source still online.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-29. Automated pattern scan on 2026-09-29. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
cost-benefit compared with similar skills
All 4 of these similar skills score higher than cost-benefit; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| cost-benefit (this skill)by brycewang-stanford | 86 | 4.4k | 54d ago | SKILL.md |
| x402by browser-use | 100 | 121.0k | 3d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| designby nextlevelbuilder | 100 | 149.0k | 6d ago | SKILL.md |
Frequently asked questions
- How do I install cost-benefit?
- Run
npx skills add brycewang-stanford/Auto-Empirical-Research-Skills --skill cost-benefit. The install tabs above show the steps for each supported agent. - Which AI agents does cost-benefit work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is cost-benefit safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is cost-benefit still maintained?
- The repository was last updated about 2 months ago, so cost-benefit is actively maintained.
Skill content
View source on GitHubname: cost-benefit description: Cost-benefit analysis. Produces economic NPV and financial NPV side by side, with BCR, optimism bias (with mitigation), Marginal Excess Tax Burden, real-terms rebasing, WELLBY / QALY / VPF wellbeing valuation, sensitivity, switching values, EANC for unequal-life options, validation gate, and a one-line headline verdict (socially worthwhile vs financially self-sustaining). Backed by the greenbook R package (HM Treasury Green Book primitives) when available, with graceful fallback. Supports HMT Green Book, EU Better Regulation, World Bank, ADB, and Victorian HVHR. Reads a longlist markdown file directly via --from. allowed-tools:
- Bash
- Read
- Write
- Glob
- AskUserQuestion
- Skill
Only stop to ask the user when: project description is missing, there are fewer than 2 options (including do-nothing), or cost / benefit magnitudes cannot be estimated. Never stop to ask about: perspective, additionality rates, stakeholder tagging, sensitivity method, output filename, or formatting. Pick sensible defaults and keep moving.
<!-- preamble: update check -->Before starting, run this silently. If it outputs UPDATE_AVAILABLE, tell the user:
"A new version of econstack is available. Run cd ~/.claude/skills/econstack && git pull to update."
Then continue with the skill normally.
~/.claude/skills/econstack/bin/econstack-update-check 2>/dev/null || true
<!-- preamble: project learnings -->
After the update check, run this silently to load prior learnings for this project:
eval "$(~/.claude/skills/econstack/bin/econstack-slug)"
~/.claude/skills/econstack/bin/econstack-learnings-read --limit 3 2>/dev/null || true
If learnings are found, apply them. When a prior learning influences a decision, note: "Prior learning applied: [key]".
Capturing new learnings: After completing this skill, log new insights via:
~/.claude/skills/econstack/bin/econstack-learnings-log '{"skill":"...","type":"...","key":"...","insight":"...","confidence":N,"source":"observed|user-stated|inferred"}'
Types: framework (preferred appraisal framework), parameter (custom overrides), data-source (preferred data), output (past report references), operational (tool/env quirks), preference (formatting/style). Confidence: 9-10 observed/stated, 6-8 strong inference, 4-5 weak. User-stated never decays; observed/inferred lose 1 point per 30 days. All data stored locally. Nothing transmitted.
After the update check, verify the parameter database is available and check staleness:
PARAMS_DIR="$HOME/econstack-data/parameters"
if [ -d "$PARAMS_DIR" ]; then
PARAM_COUNT=$(find "$PARAMS_DIR" -name "*.json" 2>/dev/null | wc -l | tr -d ' ')
echo "PARAMS: $PARAM_COUNT files loaded from $PARAMS_DIR"
# Check for stale files (last_verified > 2 years ago)
STALE=$(find "$PARAMS_DIR" -name "*.json" -mtime +730 2>/dev/null | wc -l | tr -d ' ')
if [ "$STALE" -gt 0 ]; then
echo "PARAMS_WARNING: $STALE file(s) not updated in 2+ years. Run: cd ~/econstack-data && git pull"
fi
else
echo "PARAMS: not found. Using built-in defaults. For full parameter support: git clone https://github.com/charlescoverdale/econstack-data.git ~/econstack-data"
fi
If PARAMS_WARNING appears, tell the user which parameter files may be stale and recommend updating. Continue with the skill normally using whatever parameters are available.
<!-- preamble: safety hooks -->Safety rules for this skill:
-
Parameter database is read-only. Never write to, modify, or delete files in
~/econstack-data/parameters/. These are shared, versioned parameters maintained separately. If a parameter needs updating, tell the user to update the econstack-data repo. -
Confirm before overwriting. Before writing an output file, check if a file with the same name already exists. If it does, ask the user: "A file named [filename] already exists. Overwrite it, or save with a new name?" Do not silently overwrite.
At the end of every skill run, report one of these statuses:
- DONE: Analysis complete, output generated, all sections finished.
- DONE_WITH_CONCERNS: Output generated but with caveats (e.g., data gaps, assumptions that need review, sections below expected depth).
- BLOCKED: Cannot proceed (e.g., missing critical input, parameter database unavailable, framework not supported).
- NEEDS_CONTEXT: Need more information from the user before continuing.
Format: STATUS: [status] | [one-line reason]
/cost-benefit: Cost-Benefit Analysis
Produces a Green Book-style economic case (NPV, BCR, optimism bias, sensitivity) alongside a parallel financial case (cash flow to the sponsor, Financial NPV, payback, DSCR if debt is involved), with a one-line headline verdict telling you whether the project is socially worthwhile and financially self-sustaining.
/longlist = "Brainstorm benefits and costs"
↓
/cost-benefit = "Now monetise and compute NPV" (this skill)
↓
/business-case = "Wrap in the Five Case Model"
Default output: one clean deliverable with headline verdict, options, costs, benefits, economic case, financial case, sensitivity, and recommendation. Power users can grab just one section via --section.
Arguments
/cost-benefit [project description] [options]
Examples:
/cost-benefit "New secondary school in Leeds, GBP 40m capex, 60-year appraisal"
/cost-benefit --from longlist-italy-city-greening-2026-04-10.md
/cost-benefit "Rural water project, Indonesia" --framework adb
/cost-benefit "Victorian level crossing removal" --framework au-vic
Options:
--framework <name>:uk-gb(default),eu-brg,wb,adb, orau-vic. Auto-detected from context if not set.--from <file.md>: Import project, options, costs, benefits, and Cash flow tags from a/longlistmarkdown file. Skips the interactive entry.--sponsor <type>:government(default),private,blended,philanthropic. Drives the financial case discount rate. Carried through from the longlist if--fromis used.--section <name>: Emit only one sub-component. Options:full(default),headline,costs,benefits,economic,financial,sensitivity,stakeholder,validation. Combinable with commas.--format <type>: Output format(s).markdown(default, always generated),xlsx,word,pptx,pdf, orall. Comma-separate for multiple.--distributional: Apply Green Book Annex A4 iso-elastic welfare weights (eta = 1.3, reference = median equivalised income). Silent if not set.--stage <name>:soc(Strategic Outline Case),obc(Outline Business Case, default),fbc(Full Business Case). Drives the optimism bias uplift.--ob-mitigation <pct>: Optimism bias mitigation factor in[0, 1]. Default0. Use0.3to0.5once an active risk register is in place. Greenbook:gb_apply_ob(mitigation = ...).--price-base <year>: Price base year for real-terms rebasing. Default = current calendar year. All cash inputs are re-based viagb_rebase()before discounting. Greenbook:gb_deflator()/gb_real()/gb_rebase().--carbon-scenario <name>:low/central(default) /high. Pulls from the consolidated DESNZ Nov-2023 series. Greenbook:gb_carbon_value().--schedule <name>:standard(default),health(1.5% baseline for QALY/WELLBY-monetised consequences only),catastrophic(3.0% for projects where catastrophic risk dominates). Greenbook:gb_stpr(schedule = ...).--horizon <years>: Override the default appraisal period (60 infrastructure / 30 programmes / 10 IT). For horizons > 30 years the kinked STPR schedule kicks in automatically.--cea: Cost-effectiveness mode. When monetisation of the dominant benefit is impossible (low-monetisability flag from /longlist), replaces BCR with cost per output unit. Greenbook:gb_cost_per_unit().--audit/--no-audit: Auto-run /econ-audit on the produced markdown at the end. Default:--audit.--validate-only: Run the validation gate against the longlist + parameters and exit with a structured report. No NPV produced. Useful in CI.
Supported frameworks
| Flag | Discount rate | Optimism bias | Carbon price | VPF / VSL | VTTS | METB | Wellbeing |
|------|--------------|---------------|--------------|-----------|------|------|-----------|
| uk-gb | Kinked STPR: 3.5% y0-30, 3.0% y31-75, 2.5% y76-125, 2.0% y126-200, 1.5% y201-300 | Mott MacDonald 2002 by project type, with --ob-mitigation | DESNZ Nov-2023 single consolidated series, low/central/high | DfT TAG v2.03FC anchor 2023 = GBP 2.474m WTP, +2% real per capita growth | DfT TAG Data Book | 20% on tax-financed costs (mandatory) | WELLBY GBP 13k (2019 prices); QALY GBP 70k (2024 prices, DHSC) |
| eu-brg | 3% advanced / 5% convergence (flat) | Not used; scenario sensitivity | EU ETS + EC shadow | EUR 3.6m (DG MOVE) | EU TEN-T values | n/a | n/a |
| wb | 6% (country-specific ERR) | Not used; scenario sensitivity | WB shadow (USD 40-80/tCO2e, rising to 50-100 by 2030) | By country income group | Local shadow wages | n/a | n/a |
| adb | 9% EIRR (6% for climate / health / education per 2017 revision) | Not used; switching values mandatory | ADB shadow (USD 36.30+/tCO2e) | Country-specific | ADB shadow wages | n/a | n/a |
| au-vic | 4% infrastructure / 7% non-infrastructure (flat) | Vic DTF ILG risk allowance, P50 + P90 | Australian shadow carbon | AUD 5.4m | ATAP PV5 | n/a | n/a |
Auto-detection rules:
- "HVHR", "Victorian", "Melbourne", AUD context →
au-vic - "ADB", Asian DMC context →
adb - "World Bank", "IBRD", "IDA" →
wb - "EU", "regulation", "directive", EUR context →
eu-brg - Everything else →
uk-gb
Instructions
Step 0: Detect computation backend (silent)
Check whether the greenbook R package is reachable through the bridge script:
GB_VERSION="$(echo '{"action":"version"}' | ~/.claude/skills/econstack/bin/econstack-greenbook 2>/dev/null)"
GB_OK="$(echo "$GB_VERSION" | python3 -c 'import sys, json; d=json.loads(sys.stdin.read() or "{}"); print("yes" if d.get("ok") else "no")' 2>/dev/null || echo "no")"
- If
GB_OK=yes: setBACKEND=greenbook. Use the bridge for NPV / BCR / discount factors / OB / METB / VPF / QALY / WELLBY / EANC / carbon. Stash thedata_versionsarray for the KEY NUMBERS block. All numerical claims should matchgb_economic_case()to within ±0.01. - If
GB_OK=no: setBACKEND=skill. Compute internally using the formulas below. Add a footnote to the output: "Computed without greenbook backend; install withinstall.packages('greenbook')or setGREENBOOK_DEV_PATHfor full reproducibility and vintage stamping."
Do not narrate the backend choice to the user unless they ask. Continue with Step 1.
Step 1: Load project, options, costs, and benefits
If --from <file.md> specified: read the longlist markdown file and parse:
- Project name and counterfactual from the header block
- Framework and sponsor from the header block (default if missing)
- Benefits table: for each item, capture Name, Description, Materiality, Cash flow tag, Quantification method, Monetisation method
- Costs table: same six columns
- Excluded section (note for reference but do not include in NPV)
Skip the interactive entry and proceed to Step 2.
Otherwise: ask the user in ONE AskUserQuestion batch:
- Project: one or two sentences (what, where, why).
- Options: the alternatives being compared. Must include "Do nothing" (the counterfactual). Typically 3 options: do nothing, do minimum, preferred.
- Costs: total capital (phased over how many years) and annual operating cost. If an estimate doesn't exist, ask for a range and mark the field as "Estimated".
- Benefits: annual benefit at maturity, plus benefit type (e.g.
Truncated for display — read the full file on GitHub.
Related Skills
x402
121.0kSet up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
design
149.0kComprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini, Atlas Cloud, or MuAPI AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG…
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
