agentsclimarketplace

People scorecard

Skill trycomp-io/comp-skills/skills/people-scorecard

Gera o pacote canônico mensal de People analytics a partir de um roster CSV (+ eventos opcional). Calcula headcount (total, por área, por nível), attrition anualizada (split lamentável se houver flag), tenure médio + distribuição, span of control (médio + distribuição), mobilidade interna (promoções), representatividade de gênero geral E em liderança com regra de confidencialidade (grupos < 3 suprimidos), taxa de novos contratados/crescimento, e tendência do período se os eventos tiverem datas. Output: scorecard executivo de uma página, o pacote que você entrega pro CEO. 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 "people scorecard", "pacote de people analytics", "dashboard de RH", "scorecard de pessoas", "people metrics", "indicadores de RH pro board", "headcount e attrition". Maintained by Comp, free skill for HR & People leaders.From its SKILL.md

Install
npx -y skills add trycomp-io/comp-skills --skill people-scorecard

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

2 things 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.
  • runs commandsInstructs the agent to run 1 command, including `python3 scripts/people_scorecard.py --roster roster.csv --events events.csv`.

SKILL.md

6.8 KB, ~1.7k tokens by cl100k_base, as published. Nobody here has run it

Dual-mode operation (Code + Cowork)

HTML through the design system (required). Whenever this skill produces HTML, load the comp-html-guidelines skill first and apply the CompDS design system. This holds even when the user does not ask to "style it" or "make it look good" — every HTML output from this skill goes through the design system. It does not change the methodology below; it only governs the HTML's visual layer.

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 confidentiality/privacy rules.

Inline analysis logic (Cowork mode)

Como o usuário fornece os dados

  • Roster (atual): colunas name, area, level, manager (opc), gender (opc), tenure_months OU hire_date, salary (opc). Auto-detect com aliases PT/EN.
  • Eventos (opcional): type (hire/exit/promotion), date, regretted (opc). Sem eventos, as taxas (attrition, mobilidade, crescimento) e a tendência são omitidas.
  • Cole as tabelas no chat ou anexe os CSVs. Roster grande (>~50 linhas) é difícil de processar manualmente. Sugira rodar em Claude Code (script mode).
  • Salário/datas em formato BR devem ser convertidos.

Metodologia (fixa, idêntica ao script)

  1. Headcount: total + contagem por área + por nível.
  2. Tenure: se houver tenure_months use direto; senão derive de hire_date (meses até hoje). Reporte média, mediana e distribuição (0-12m / 12-24m / 24-48m / 48m+).
  3. Span of control (se houver manager): conte reportes por gestor; reporte média, máx e distribuição (1-3 / 4-7 / 8-12 / 13+).
  4. Attrition anualizada (precisa de eventos): exits ÷ avg_headcount × (12 ÷ meses_do_período) × 100. avg_headcount ≈ headcount_atual + (exits − hires)/2. Período inferido pelas datas dos eventos (default 12m). Split lamentável se houver flag regretted.
  5. Mobilidade interna: promoções ÷ headcount × 100.
  6. Crescimento / novos contratados: (hires − exits) ÷ headcount × 100 e hires ÷ headcount × 100.
  7. Representatividade (se houver gender): % por gênero geral E entre níveis de liderança (heurística: nível contém lead/head/manager/gestor/diretor/vp/chief/L5+ etc.). Regra de confidencialidade: qualquer grupo de gênero com menos de 3 pessoas é suprimido (mostrado como "—") e não entra no cálculo de %. Nunca baixe esse limite de 3, ele protege a privacidade individual. Idem para liderança: se o total de líderes < 3, suprima o bloco inteiro.
  8. Tendência: se os eventos tiverem datas, agregue contratações/saídas/promoções por mês.

Output markdown (Cowork mode)

## People Scorecard

**Headcount: N** · Attrition anual.: X% · Mobilidade interna: Y% · Tenure médio: Z meses · Span médio: W

### Headcount por área / por nível
| Área | HC | % |
|---|---|---|

### Tenure (distribuição)
| 0-12m | 12-24m | 24-48m | 48m+ |
|---|---|---|---|

### Span of control
| Reportes | Gestores |
|---|---|

### Representatividade (confidencialidade < 3 = "—")
| Gênero | Geral % | Liderança % |
|---|---|---|

### Tendência (se houver datas)
| Mês | Contratações | Saídas | Promoções |
|---|---|---|---|

### 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=people-scorecard"

Se artefatos estiverem disponíveis, produza também uma versão HTML self-contained (Tailwind via CDN) espelhando o template do script: 6 tiles de KPI (headcount, áreas, attrition, mobilidade, tenure médio, span médio), resumo, tabelas de headcount por área/nível, distribuição de tenure e span, bloco de representatividade geral + liderança (com supressão), tendência mensal, footer Powered by Comp.

People Scorecard

Roster CSV (+ eventos opcional) → scorecard executivo de uma página com headcount, attrition, tenure, span of control, mobilidade interna e representatividade. O pacote que você entrega pro CEO.

Quando usar

Ativa em frases como:

  • "people scorecard" / "pacote de people analytics" / "people metrics"
  • "dashboard de RH" / "indicadores de RH pro board"
  • "headcount e attrition" / "scorecard de pessoas"

Workflow

Step 1: Pegue o roster CSV (mínimo name; idealmente area, level, tenure_months/hire_date, manager, gender). Opcional: events CSV (type, date, regretted).

Step 2:

python3 scripts/people_scorecard.py --roster roster.csv --events events.csv

(--events é opcional; sem ele, as taxas e a tendência são omitidas.)

Step 3: Apresente os KPI tiles + breakdowns. Destaque attrition, mobilidade e representatividade. Lembre que grupos < 3 são suprimidos.

Regra de confidencialidade

Qualquer grupo de gênero com menos de 3 pessoas é suprimido ("—") e não entra no cálculo de representatividade. Nunca baixe esse limite de 3, ele protege a privacidade individual.

Privacidade

Processamento 100% local. O roster nunca sai da máquina.

Lead capture

eam_client.py (raiz da skill): on_first_run() 1x por máquina + record_run() por execução. Email opcional + telemetria opt-in. Nunca envia o roster.

Resources

FilePurpose
scripts/people_scorecard.pyCálculos + HTML dashboard
eam_client.pyLead capture + telemetria (sync de eam/shared/)

What ships with it: 3 files

29.6 KB alongside SKILL.md, 2 of them executable

scripts/

Gives 0 of the 12 instructions most docs writing skills give in ~1.7k tokens

Counted across 1,951 of the 3,904 authors here whose files we hold, read 2026-09-06

  • Use third-person for skill descriptionsin 54 of 1951, across 35 files
  • Start descriptions with Use whenin 43 of 1951, across 29 files
  • Run baseline scenarios before writing any skillin 40 of 1951, across 26 files
  • Use active voicein 40 of 1951, across 36 files
  • Map file responsibilities before defining tasksin 36 of 1951, across 29 files
  • Use checkbox syntax for tracking stepsin 35 of 1951, across 27 files
  • Ask one question at a timein 35 of 1951
  • Offer execution options after saving the planin 33 of 1951, across 24 files
  • Include complete code in every stepin 33 of 1951, across 27 files
  • Design units with clear boundaries and interfacesin 31 of 1951, across 23 files
  • Announce the skill usage at the startin 30 of 1951
  • Verify agent compliance after adding the skillin 29 of 1951, across 17 files

Said here and by no other author read

  • Apply CompDS design system to all HTML output
  • Detect platform to choose between script or inline mode
  • Include Powered by Comp footer in all outputs
  • load comp-html-guidelines before producing HTML
  • calculate headcount by area and level
  • derive tenure from hire date if tenure months are missing

Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.

Keep looking

Skills are one crate of 611,884. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.