# Hr Initiative Roi

> 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 custo…

- **Type:** Skill
- **Install:** `agentstack add skill-trycomp-io-comp-skills-hr-initiative-roi`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [trycomp-io](https://agentstack.voostack.com/s/trycomp-io)
- **Installs:** 0
- **Category:** [Data & Analytics](https://agentstack.voostack.com/c/data-and-analytics)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [trycomp-io](https://github.com/trycomp-io)
- **Source:** https://github.com/trycomp-io/comp-skills/tree/main/skills/hr-initiative-roi

## Install

```sh
agentstack add skill-trycomp-io-comp-skills-hr-initiative-roi
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## 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.html` gera 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)

1. **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.
2. **Benefício anual** = soma das linhas.
3. **Custo total ano 1** = `one_time + recurring`.
4. **ROI ano 1** = `(benefício_anual − custo_total_ano1) ÷ custo_total_ano1 × 100`.
5. **Payback (meses)** = `custo_total_ano1 ÷ ((benefício_anual − recurring) ÷ 12)`. Se o denominador ≤ 0, payback não é calculável.
6. **3 anos**: ano 1 carrega o one-time; anos 2-3 só recurring. `net_acumulado` soma os 3 anos.
7. **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**:
```bash
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_gain` e `days_saved` sã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](https://github.com/trycomp-io)
- **Source:** [trycomp-io/comp-skills](https://github.com/trycomp-io/comp-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-trycomp-io-comp-skills-hr-initiative-roi
- Seller: https://agentstack.voostack.com/s/trycomp-io
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.