Install
$ agentstack add skill-trycomp-io-comp-skills-hr-initiative-roi ✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
Verified badge
Passed review? Show it. Paste this badge into your README, it links to the public security report.
Reliability & compatibility
Declared compatibility
Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.
We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.
How agent discovery & health will work →About
HR Initiative ROI
> HTML pelo design system (obrigatório). Sempre que este skill for produzir HTML, carregue antes o skill comp-html-guidelines e 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.
- 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:
**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.html
Step 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 |
Source & license
This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.
- Author: trycomp-io
- Source: trycomp-io/comp-skills
- License: MIT
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet, be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.