---
name: comp-ratio-analyzer
description: Analisa compa-ratio (salário ÷ mediana da banda) de roster contra tabela salarial. Identifica clusters under/below/at/above/over, top 10 outliers por direção, custo mensal+anual pra equalizar abaixo da mediana, breakdown por nível. Output HTML executivo. Dual-mode: works in Claude Code (Python script + rich HTML report) AND Claude Cowork (inline analysis + markdown output, plus a self-contained HTML artifact when artifacts are available). Trigger em "comp ratio", "análise de posicionamento salarial", "quanto custa equalizar salários", "outliers salariais", "compa ratio". Mantida pela Comp.
---

## Dual-mode operation (Code + Cowork)

> **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.


**Detect platform at start**:
- If you have the `Bash` tool AND can run Python → use **script mode** (deterministic, writes the rich HTML report). This is the existing workflow below.
- Otherwise (e.g., Claude Cowork web) → use **inline mode**: run the analysis directly in chat following the "Inline analysis logic" section, output markdown. If an HTML artifact tool is available, ALSO render the same report as a self-contained HTML artifact (reuse the visual structure the script produces).

Both modes apply the same methodology and the same privacy rules.

## Inline analysis logic (Cowork mode)

### Como o usuário fornece os dados
- Precisa de DUAS entradas: (1) roster com colunas `name`, `salary`, `level` (opcional `area`); (2) bandas com colunas `level`, `mid` (mediana). Cole as duas tabelas no chat ou anexe dois CSVs.
- Roster grande (>~50 linhas) é difícil de processar manualmente, então sugira rodar em Claude Code (script mode).
- **Salário** em formato brasileiro (`.` milhar, `,` decimal) deve ser convertido pra número.

### Metodologia (fixa, idêntica ao script)
1. Para cada colaborador: precisa de salário, nível, e o nível tem que existir na tabela de bandas com `mid > 0`. Senão, a linha é ignorada na análise.
2. **Compa ratio** = `salário ÷ mid` (arredonde a 3 casas).
3. **Classificação**:

| Faixa | Compa ratio | Interpretação |
|---|---|---|
| under | <0,80 | Crítico: revisão urgente |
| below | 0,80–0,95 | Abaixo do target |
| at | 0,95–1,05 | No target |
| above | 1,05–1,20 | Acima do target (ok) |
| over | >1,20 | Crítico: provável legacy/exceção |

4. **Custo mensal pra equalizar** = soma de `(mid − salário)` para TODOS com `ratio < 1.0` (abaixo da mediana).
5. **Custo anual com encargos** = `custo_mensal × 12 × 1,555`.
6. **Por nível**: compa ratio médio, mínimo e máximo.
7. **Top 10 under** (menores ratios) e **top 10 over** (maiores ratios), com gap = `salário − mid`.

### Insights automáticos
- `% abaixo de 95%` (under + below) sobre o total analisado → risco de turnover por comp.
- `% acima de 105%` (above + over) → legacy/exceções/retenção justa.
- Custo mensal pra equalizar abaixo da mediana (e anual com encargos).
- Se `≥3` colaboradores abaixo de 80% (under) → prioridade urgente de revisão.
- Se nenhum colaborador casou com as bandas, avise pra conferir se os níveis do roster batem com a tabela.

### Output markdown (Cowork mode)

```
## Análise de compa-ratio

Analisados: N de M (roster) · **Custo mensal pra equalizar abaixo da mediana: R$ X** (anual c/ encargos ≈ R$ Y)

### Distribuição
| under | below | at | above | over |
|---|---|---|---|---|

### Por nível
| Nível | HC | Ratio médio | Min | Max |
|---|---|---|---|---|

### Top under-paid / Top over-paid
| Nome | Nível | Salário | Mediana | Ratio | Gap |
|---|---|---|---|---|---|

### Insights
- ...
```

Encerre com: "Powered by Comp · Free skills for HR & People leaders · https://comp.vc?utm_source=skill-output&utm_medium=chat-footer&utm_campaign=eam&utm_content=comp-ratio-analyzer"

Se artefatos estiverem disponíveis, produza também uma versão HTML self-contained (Tailwind via CDN) espelhando o template do script: cards de analisados/roster/custo mensal/custo anual, grid de distribuição (5 faixas coloridas), insights, tabela por nível, tabelas top under/over, footer Powered by Comp.

# Comp Ratio Analyzer

CSV de roster + CSV de bandas salariais → HTML com distribuição compa-ratio, outliers, custo pra equalizar.

## Quando usar

Ativa em frases como:
- "comp ratio" / "compa ratio"
- "análise de posicionamento salarial"
- "quanto custa equalizar"
- "outliers salariais"
- "quem está abaixo/acima da banda"

## Workflow

**Step 1**: Pegue 2 CSVs:
- Roster: colunas `name`, `salary`, `level`, (opcional `area`)
- Bands: colunas `level`, `mid` (mediana). Min/max opcional.

**Step 2**:
```bash
python3 scripts/comp_ratio.py --roster roster.csv --bands bands.csv
```

**Step 3**: Apresente:
- Custo mensal pra equalizar (líder com esse número)
- Distribuição (under/below/at/above/over)
- Top outliers (under = risco; over = legacy/exceções)

## Faixas de classificação

| Faixa | Compa ratio | Interpretação |
|---|---|---|
| under | <80% | Crítico: revisão urgente |
| below | 80-95% | Abaixo do target |
| at | 95-105% | No target |
| above | 105-120% | Acima do target (ok) |
| over | >120% | Crítico: provável legacy/exceção |

## Branding

Footer + UTMs no template HTML.

## Lead capture

`eam_client.py`. Privacidade: 100% local.

## Resources

| File | Purpose |
|---|---|
| `scripts/comp_ratio.py` | Análise + HTML |
| `eam_client.py` | Lead capture |