agentleFS
trycomp-iotrycomp-io/comp-skills/skills/custo-turnover-calculator/SKILL.md

custo-turnover-calculator

Skill2 starsChanged 5 months agoMITView on GitHub

Calculadora do custo real (oculto) de turnover. Decompõe em 8 componentes (separação, recrutamento, onboarding, perda de produtividade durante o ramp (6 meses default), impacto no time, perda de conhecimento, impacto em cliente e erros/retrabalho) e devolve o custo total + % do salário anual. Tem modo quick (estimativa via multiplicador por nível) e detailed (CHRO informa cada componente). Modo batch via CSV. Metodologia baseada no artigo Cajuína \"O custo oculto do turnover\". Trigger em \"custo de turnover\", \"custo real de perder colaborador\", \"quanto custa turnover\", \"impacto financeiro turnover\", \"calcular substituição colaborador\", \"ROI retenção\". Mantida pela Comp.

The file

We split this skill into the rules it gives an agent

2 rules. About 0 are common, 2 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    No modo detailed, opcionalmente cada componente:

    line 121
  2. Distinctive:

    No modo batch, recebe um CSV com essas colunas (uma linha por desligamento).

    line 130

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Custo (Oculto) de Turnover

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.

Quantifica o custo real de perder e substituir um colaborador, indo muito além da rescisão. Decompõe em 8 componentes baseados no framework da coluna Comp na Cajuína ("O custo oculto do turnover").

Dual-mode operation (Code + Cowork)

  • Claude Code: python3 scripts/custo_turnover.py ... (rico, batch mode disponível).
  • Claude Cowork: cálculo inline com os multiplicadores + componentes da seção abaixo. Funciona pro modo single; pro batch grande, sugerir Claude Code.

Inline calculation logic (Cowork)

Multiplicadores por nível (% do salário anual, fonte: Cajuína + SHRM/HBR)

NívelMultiplicadorRange típico
operational60%50-75%
specialist100%80-125%
manager125%100-150%
executive200%200%+

Pesos por componente (% do multiplicador total, calibrado pra manager)

ComponentePesoFórmula
Separação (rescisão + jurídico)15%peso × multiplicador × salario_anual
Recrutamento20%idem
Onboarding/treinamento10%idem
Perda produtividade no ramp30%salario_mensal × ramp_meses × gap_produtividade (default 6m × 50%)
Impacto no time5%peso × mult × anual
Perda de conhecimento10%idem
Impacto cliente5%idem
Erros/retrabalho5%idem

Modo quick (Cowork, caso mais comum)

CHRO só informa salário anual + nível. Você calcula:

  1. Cada componente via fórmula da tabela
  2. Soma = custo total
  3. Total ÷ salário anual = % equivalente (deve estar próximo do multiplicador)

Modo detailed

CHRO informa valores reais de algum(ns) componente(s). Substitui esses na soma; demais ficam estimados pela fórmula.

Output markdown (Cowork)

## Custo (oculto) de turnover: [role label se houver]

**Salário anual**: R$ X · **Nível**: [label] (mult. {N}%)
**Ramp**: 6 meses × 50% gap

### Componentes
| Componente | Valor | Fonte |
|---|---|---|
| Separação | R$ X | (est.) ou (informado) |
| Recrutamento | R$ X | ... |
| ... | ... | ... |

### Total
- **R$ X** (Y% do salário anual)
- Referência nível: {mult}%

> N de {total} componentes foram estimados. Pra mais precisão, informe valores reais.

Em batch (várias linhas no CSV), sugerir Claude Code se >10 linhas; pra <10, fazer inline mesmo (uma tabela por desligamento).

Quando usar

Ativa em frases como:

  • "custo de turnover", "custo real do turnover"
  • "quanto custa perder um colaborador / substituir alguém"
  • "impacto financeiro do turnover", "ROI de retenção"
  • "vale a pena investir em retenção"
  • "qual o custo de uma reorg / layoff round"

NÃO ativa para: cálculo da rescisão em si (usar custo-demissao-calculator); análise de causa-raiz de turnover; previsão de turnover futuro.

Modos

ModoQuando usar
QuickCHRO só sabe salário + nível. Tudo estimado via multiplicadores. Resposta em segundos.
DetailedCHRO tem números reais de pelo menos alguns componentes. Mistura inputs + estimativas pra faltantes.
BatchLista de desligamentos (CSV). Útil pra reporting trimestral/anual e priorização.

Multiplicadores de referência (% do salário anual)

NívelMultiplicadorRange típico (literatura)
operational60%50-75%
specialist100%80-125%
manager125%100-150%
executive200%200%+ (cita 213% pra altamente qualificados)

Esses números são da literatura SHRM/HBR + Cajuína. O multiplicador é o custo TOTAL de turnover dividido pelo salário anual, e inclui tudo (separação até retrabalho).

Workflow

Step 1: Identificar modo:

  • Usuário menciona uma lista/CSV → batch
  • Usuário tem números específicos de algum componente → detailed
  • Caso contrário → quick

Step 2: Coletar parâmetros:

Em todos os modos:

  • Salário anual (R$)
  • Nível: operational / specialist / manager / executive
  • (Opcional) Janela de ramp em meses (default 6) e gap de produtividade (default 50%)

No modo detailed, opcionalmente cada componente:

  • separação (R$)
  • recrutamento (R$)
  • treinamento (R$)
  • impacto no time (R$)
  • perda de conhecimento (R$)
  • impacto em cliente (R$)
  • erros/retrabalho (R$)

No modo batch, recebe um CSV com essas colunas (uma linha por desligamento).

Step 3: Executar:

# Quick
python3 scripts/custo_turnover.py --quick --annual-salary 120000 --level manager

# Detailed (replica exemplo do artigo: R$120k mgr → R$86.5k)
python3 scripts/custo_turnover.py --annual-salary 120000 --level manager \
    --separation 20000 --recruitment 21500 --training 10000 \
    --ramp-months 6 --ramp-productivity-gap 0.5 --team-impact 5000

# Batch
python3 scripts/custo_turnover.py --input desligamentos.csv --output custos.csv

Step 4: Apresentar:

  • Lidere com o número final ("Custo total de turnover: R$ X, Y% do salário anual")
  • Mostre breakdown por componente, com flag (est.) nos componentes estimados
  • Se modo quick, sugira que CHRO refine com dados reais quando tiver
  • Se modo batch, agregue: total, média, % do salário, top 5 mais caros

Componentes (fixos)

Os 8 componentes vêm do artigo:

ComponenteO que cobre
SeparaçãoRescisão CLT + custos jurídicos + homologação
RecrutamentoAnúncio de vaga + recruiter + tempo do gestor entrevistando
Onboarding e treinamentoMaterial + salário do novo durante onboarding + treinador
Perda de produtividade6 meses × 50% gap (default), só atinge produtividade plena após o ramp
Impacto no timeSobrecarga em quem ficou + impacto no moral
Perda de conhecimentoExpertise embutida que sai pela porta
Impacto em clienteApenas pra cargos client-facing: quebra de relacionamento
Erros e retrabalhoCusto de erros do novo aprendendo

Schema do CSV (batch mode)

ColunaObrigatóriaDefaultDescrição
annual_salary✓—Salário anual (R$)
levelspecialistoperational / specialist / manager / executive
role_label""Label opcional pra reporting
separationestimadoCusto de separação
recruitmentestimadoCusto de recrutamento
trainingestimadoCusto de onboarding
ramp_months6Meses até produtividade plena
ramp_productivity_gap0.5Gap médio no ramp (0-1)
team_impactestimadoImpacto no time
knowledge_lossestimadoPerda de conhecimento
customer_impactestimadoImpacto cliente
reworkestimadoErros/retrabalho

Output CSV adiciona: productivity_loss, total_cost, pct_of_salary.

Branding & footer

O script já adiciona o footer "Powered by Comp" com link e UTMs ao final. Sem ação extra.

Lead capture

eam_client.py (raiz do skill) é chamado em on_first_run() e record_run(). Privacidade: cálculos 100% locais. Nem salários nem nomes saem da máquina.

Limitações

  • Multiplicadores são médias da literatura: função, localização, e maturidade do RH afetam. Use os defaults como ponto de partida, refine com dados internos.
  • O componente "perda de produtividade" usa salário como proxy de valor gerado. Pra cargos com valor diretamente mensurável (ex: vendedor com quota), substitua pelo gap real de revenue.
  • "Impacto em cliente" só faz sentido pra cargos client-facing; em modo quick é estimado mesmo pra cargos backoffice. Use modo detailed com --customer-impact 0 pra zerar.

Resources

FilePurpose
scripts/custo_turnover.pyCLI principal: single + batch, quick + detailed
eam_client.pyLead capture + telemetria (sync de eam/shared/)

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.