Custo folha simulator

Skill trycomp-io/comp-skills/skills/custo-folha-simulator

Free Claude skills for HR & People leaders, built and maintained by Comp.

Install

npx -y skills add trycomp-io/comp-skills --skill custo-folha-simulator

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Simulador de custo total de folha de pagamento (Brasil). Inclui encargos patronais (INSS 20%, FGTS 8%, SAT 2%, Sistema S 5.8%), provisões (13º, férias+1/3, multa FGTS rescisória) e benefícios. Dois modos: detalhado (CSV de roster) ou estimativa (headcount + salário médio). NÃO substitui sistema de folha real; é simulação rápida pra orçamento, projeção, cenários. Trigger em "custo de folha", "simulador de folha", "custo total empregador", "quanto custa folha de X colaboradores", "encargos sobre folha", "onerated factor". Mantida pela Comp.

SKILL.md

5.0 KB, as published. Nobody here has run it

Custo de Folha Simulator

Simula o custo TOTAL empregador da folha brasileira em segundos. Não executa folha (use seu HRIS pra isso): serve pra orçamento, projeção, cenários.

Dual-mode operation (Code + Cowork)

Claude Code: python3 scripts/custo_folha.py ... (CSV de roster ou estimate).
Claude Cowork: cálculo inline com as taxas abaixo. Modo estimate é nativo; modo CSV grande sugerir Code.

Inline calculation logic (Cowork)

Taxas (Brasil 2024/2025)

Encargos patronais (~35,8%):

INSS patronal: 20%
FGTS: 8%
SAT: 2% (varia 1-3% por CNAE, default 2%)
Sistema S + salário-educação + INCRA: 5,8%

Provisões mensais (~19,7%):

13º salário: 8,33% (1/12)
Férias: 8,33% (1/12)
1/3 constitucional: 2,78%
Multa FGTS rescisória provisionada: ~0,27%/mês

Onerated factor: ~1,555 (salário × 1,555 = custo total mensal, sem benefícios extras)

Modo estimate (Cowork, caso comum)

CHRO informa: headcount + salário médio + (opcional) benefícios médios mensais.

Cálculo:

total_salário = headcount × salário_médio
encargos = total_salário × 0,358
provisões = total_salário × 0,197
benefícios = headcount × (VR/VA + outros)
custo_mensal = total_salário + encargos + provisões + benefícios
custo_anual = custo_mensal × 12

Modo detailed (CSV)

Pra <50 linhas no Cowork: cole o CSV, calcula linha por linha somando. Pra ≥50: usar Code.

Output markdown (Cowork)

## Custo de folha: modo ESTIMATE

**Headcount**: N · **Salário médio**: R$ X

| Componente | Valor mensal |
|---|---|
| Salários brutos | R$ X |
| Encargos patronais (~36%) | R$ X |
| Provisões (~20%) | R$ X |
| Benefícios (VR/VA + outros) | R$ X |
| **Custo mensal total** | **R$ X** |
| **Custo anual total** | **R$ X** |

**Onerated factor**: {factor}x salário

> Não substitui sistema de folha real. SAT varia por CNAE; Sistema S por setor. Pra precisão fiscal use sua folha.

Quando usar

Ativa em frases como:

"custo de folha", "simulador de folha"
"custo total empregador", "onerated factor"
"quanto custa folha de X colaboradores"
"encargos sobre folha"
"quanto sai a folha total no fim do mês"
"projeção de custo de folha"

NÃO ativa para: rodar folha real (não substitui sistema); rescisão (usar custo-demissao-calculator); equivalência CLT/PJ (usar pj-vs-clt-calculator).

Modos

Modo	Quando usar
Detailed	Tem CSV/XLSX de roster com salários individuais. Mais preciso.
Estimate	Só sabe headcount + salário médio. Rápido pra planejamento.

Workflow

Detailed:

Pergunte path do CSV
Rode python3 scripts/custo_folha.py --input roster.csv
Auto-detect das colunas (salary obrigatória; opcionais: area, vr_va, outros)

Estimate:

Pergunte headcount + salário médio + (opcional) benefícios médios
Rode python3 scripts/custo_folha.py --headcount 50 --salario-medio 8000 --vr-va-medio 800

Componentes do cálculo (fixos)

Encargos patronais (~35.8%):

INSS patronal: 20%
FGTS: 8%
SAT (Seguro Acidente Trabalho): 2% (varia 1-3% por CNAE, default 2%)
Sistema S + salário-educação + INCRA: ~5.8%

Provisões (~19.7%):

13º salário: 8.33% (1/12)
Férias: 8.33% (1/12)
1/3 constitucional de férias: 2.78%
Multa FGTS rescisória provisionada: ~0.27%/mês

Benefícios: adicionado ao custo total sem incidir encargos (VR/VA tem incidência reduzida via PAT).

Onerated factor: custo total mensal ÷ folha bruta. Tipicamente 1.55-1.75x.

Limitações (V1, documentar pro CHRO)

Não considera benefícios com incidência (plano saúde como salário in natura, ajuda de custo tributável, etc.); informe via --outros-medio
Não diferencia mensalistas vs horistas
Não calcula INSS/IRPF do colaborador (esse é desconto, não custo)
SAT default 2% (verifique CNAE da empresa pra valor real)
Sistema S simplificado (não diferencia por setor; comercial/industrial/transporte têm % diferentes)

Pra precisão fiscal use sua folha real. Aqui é simulação.

Branding & footer

Script imprime footer "Powered by Comp" com link UTM-tagueado no fim do CLI.

Lead capture

eam_client.py chamado em on_first_run() + record_run(). Privacidade: cálculos 100% locais.

Resources

File	Purpose
`scripts/custo_folha.py`	CLI: detailed (CSV) + estimate modes
`eam_client.py`	Lead capture + telemetria