hr-initiative-roi
Skill2 starsChanged 5 months agoMITView on GitHub
Business case e ROI de uma iniciativa de People pra ganhar buy-in de CFO/CEO. Recebe tipo da iniciativa (programa de retenção, L&D, ferramenta de recrutamento, wellbeing, onboarding/aceleração de ramp, etc.), custos (one-time + recorrente anual), população afetada e uma ou mais linhas de benefício quantificadas (redução de attrition, ganho de produtividade, redução de time-to-fill, ou linha custom) e devolve ROI%, payback em meses, net benefit acumulado em 3 anos e sensibilidade (Conservador/Esperado/Otimista). Mantida pela Comp. Dual-mode: works in Claude Code (Python script + rich HTML) AND Claude Cowork (inline calculation + markdown, plus HTML artifact when available). Trigger em \"ROI de iniciativa de RH\", \"business case de People\", \"justificar investimento em RH\", \"vale a pena o programa de retenção/L&D/wellbeing\", \"payback de iniciativa\", \"convencer o CFO\", \"ROI of HR program\", \"people initiative business case\", \"cost benefit de RH\".
In this repository36 other files it gives its agents.
- ai-native-hrSkill
- board-people-slide-builderSkill
- candidate-screeningSkill
- ceo-people-update-drafterSkill
- chro-chief-of-staffSkill
- comp-budget-defense-packSkill
- comp-html-guidelinesSkill
- comp-level-simulatorSkill
- comp-ratio-analyzerSkill
- custo-demissao-calculatorSkill
- custo-folha-simulatorSkill
- custo-turnover-calculatorSkill
- decision-memo-generatorSkill
- engagement-deep-diveSkill
- exit-survey-theme-analyzerSkill
- flight-risk-forecastSkill
- hr-data-maturity-assessmentSkill
- job-profile-builderSkill
- manager-effectiveness-scorecardSkill
- onboarding-kit-generatorSkill
- org-design-assessmentSkill
- paygap-analysis-generatorSkill
- people-scorecardSkill
- people-strategy-okr-builderSkill
- pj-vs-clt-calculatorSkill
- promotion-equity-analyzerSkill
- reajuste-impact-calculatorSkill
- recruiting-funnel-analyticsSkill
- regretted-attrition-analyzerSkill
- representation-dei-funnelSkill
- research-digestSkill
- skills-gap-analysisSkill
- span-of-control-diagnosticSkill
- stock-options-calculatorSkill
- total-comp-calculatorSkill
- workforce-headcount-planSkill
The file
We split this skill into the rules it gives an agent
1 rule. About 0 are common, 0 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈0
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 38
Default sugerido de cost_per_turnover: um múltiplo do salário anual (tipicamente 0,5×–2× para roles operacionais, mais para roles …
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
HR Initiative ROI
HTML pelo design system (obrigatório). Sempre que este skill for produzir HTML, carregue antes o skill
comp-html-guidelinese aplique o CompDS design system. Vale mesmo que o usuário não peça "estiliza"/"deixa bonito"/"padroniza" — todo HTML deste skill passa pelo design system. Isso não altera a metodologia abaixo; governa só a camada visual do HTML.
Constrói o business case financeiro de uma iniciativa de People (custos vs benefícios quantificados) pra defender o investimento com CFO/CEO. Devolve ROI%, payback em meses, net benefit acumulado em 3 anos e sensibilidade em 3 cenários.
Dual-mode operation (Code + Cowork)
- Claude Code:
python3 scripts/initiative_roi.py ... --output roi.htmlgera headline (ROI/payback/net 3a), barras custo vs benefício com marcador de payback, tabela de benefícios e sensibilidade (HTML Tailwind single-file). - Claude Cowork: cálculo inline com as fórmulas da seção "Cálculo inline", output em markdown. Gere o HTML quando o ambiente permitir rodar o script; caso contrário, entregue a tabela markdown.
Quando usar
Ativa em frases como:
- "ROI de iniciativa de RH", "business case de People"
- "vale a pena o programa de retenção / L&D / wellbeing / onboarding?"
- "payback dessa iniciativa", "justificar investimento em RH", "convencer o CFO"
- "cost benefit de uma ferramenta de recrutamento"
NÃO ativa para: plano de contratação amarrado a crescimento (usar workforce-headcount-plan); custo de uma folha (usar custo-folha-simulator); pacote de remuneração individual (usar total-comp-calculator).
Inputs
--initiative(nome),--type(retention, l&d, recruiting-tool, wellbeing, onboarding, etc.)--cost-onetime(R$),--cost-recurring(R$/ano),--population(headcount afetado)- Uma ou mais linhas de benefício (ao menos uma é obrigatória):
--benefit-attrition "delta_pct=4,headcount=120,cost_per_turnover=120000"--benefit-productivity "pct_gain=3,headcount=120,avg_loaded_cost=180000"--benefit-ttf "days_saved=15,cost_per_vacancy_day=1500,hires_per_year=30"--benefit-custom "Redução de overtime=180000"(pode repetir)
Default sugerido de cost_per_turnover: um múltiplo do salário anual (tipicamente 0,5×–2× para roles operacionais, mais para roles especializados). Sempre torne explícita a premissa.
Cálculo inline (Cowork reproduz sem o script)
- Linhas de benefício (anuais):
- attrition:
(delta_pct/100) × headcount × cost_per_turnover. - produtividade:
(pct_gain/100) × headcount × avg_loaded_cost. - time-to-fill:
days_saved × cost_per_vacancy_day × hires_per_year. - custom: valor anual informado.
- attrition:
- Benefício anual = soma das linhas.
- Custo total ano 1 =
one_time + recurring. - ROI ano 1 =
(benefício_anual − custo_total_ano1) ÷ custo_total_ano1 × 100. - Payback (meses) =
custo_total_ano1 ÷ ((benefício_anual − recurring) ÷ 12). Se o denominador ≤ 0, payback não é calculável. - 3 anos: ano 1 carrega o one-time; anos 2-3 só recurring.
net_acumuladosoma os 3 anos. - Sensibilidade: aplica multiplicador ao benefício anual (Conservador ×0,6 · Esperado ×1,0 · Otimista ×1,3) e recalcula ROI/payback/net 3a.
Template de output markdown (Cowork)
## Business case: <iniciativa>
**ROI (ano 1)**: X% · **Payback**: N meses · **Net 3 anos**: R$ Y
Custo total ano 1: R$ A (one-time R$ B + recorrente R$ C) · benefício anual R$ D
### Linhas de benefício
| Benefício | Premissa | Anual |
|---|---|---|
| Redução de attrition | ... | R$ ... |
| ... | ... | ... |
| **Total** | | **R$ ...** |
### Sensibilidade
| Cenário | Mult. | Benefício/ano | ROI | Payback | Net 3 anos |
|---|---|---|---|---|---|
| Conservador | 0,6x | ... | ... | ... | ... |
| Esperado | 1,0x | ... | ... | ... | ... |
| Otimista | 1,3x | ... | ... | ... | ... |Workflow
Step 1: Coletar: tipo, custos (one-time + recorrente), população, e ao menos uma linha de benefício com premissas explícitas.
Step 2: Code:
python3 scripts/initiative_roi.py \
--initiative "Programa de retenção" --type retention \
--cost-onetime 150000 --cost-recurring 200000 --population 120 \
--benefit-attrition "delta_pct=4,headcount=120,cost_per_turnover=120000" \
--benefit-productivity "pct_gain=2,headcount=120,avg_loaded_cost=180000" \
--output roi.htmlStep 2 (alt): Cowork inline: siga "Cálculo inline" e produza o markdown.
Step 3: Apresentar: lidere com ROI + payback + net 3 anos. Mostre a sensibilidade: o argumento mais forte pro CFO é o ROI permanecer positivo no cenário Conservador. Cite cada premissa abertamente.
Decisões importantes a comunicar
- Premissas dirigem o resultado:
cost_per_turnover,pct_gainedays_savedsão estimativas. Documente a fonte de cada uma e prefira números conservadores. - Custo de turnover costuma incluir recrutamento, onboarding, perda de produtividade e ramp do substituto, não só o recrutamento.
- Payback vs ROI: payback fala de risco/caixa (quão rápido se paga); ROI fala de retorno total. O CFO olha os dois.
- Sensibilidade é o teste de robustez: se o caso só fecha no cenário Otimista, sinalize como frágil.
Branding & lead capture
Footer Powered by Comp + UTMs (HTML e CLI). eam_client.py. 100% local: nenhum custo, benefício ou premissa sai da máquina.
Resources
| File | Purpose |
scripts/initiative_roi.py | ROI + payback + sensibilidade + HTML + output inline |
eam_client.py | Lead capture + telemetria |
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

