workforce-headcount-plan

workforce-headcount-plan is a skill for Claude Code, Codex from trycomp-io/comp-skills. It costs 228 tokens per session (1,973 once invoked), scanned A, original, MIT.

A workforce planning method that estimates how many employees a company may need as it grows. It uses current staffing and a growth target to plan hiring, replacement hires, and payroll costs across scenarios.

In plain words
What is it for?
Use it to build headcount plans by role and quarter, calculate additional hires and replacement hires, estimate payroll costs, and compare conservative, base, and aggressive growth cases. Headcount means the number of employees.
Why use it?
It connects business growth plans with hiring needs instead of treating recruitment as a separate guess. Comparing scenarios helps show how staffing and costs could change.

Skill for Claude CodeCodex

Part of the comp-skills plugin — 37 skills shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/trycomp-io/comp-skills/workforce-headcount-plan
Any agent
npx skills add trycomp-io/comp-skills --skill workforce-headcount-plan
Clone the repo
git clone --depth 1 https://github.com/trycomp-io/comp-skills

Made for: Claude Code, Codex.

Or install comp-skills, the plugin that ships this one along with the rest of its 37 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for workforce-headcount-plan

README.md
[![agentmods](https://agentmods.dev/badge/skills/trycomp-io/comp-skills/workforce-headcount-plan.svg)](https://agentmods.dev/skills/trycomp-io/comp-skills/workforce-headcount-plan)
Your own site
<a href="https://agentmods.dev/skills/trycomp-io/comp-skills/workforce-headcount-plan"><img src="https://agentmods.dev/badge/skills/trycomp-io/comp-skills/workforce-headcount-plan.svg" alt="Measured on agentmods" height="20"></a>
Per session 228 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,973 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00228 $0.01973
Opus 5 $0.00114 $0.00986
Sonnet 5 $0.00046 $0.00395
Haiku 4.5 $0.00023 $0.00197

Measured 4d ago against content hash d92c0c61231c, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

workforce-headcount-plan scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

The scan reads SKILL.md. This mod also ships 2 executable files (eam_client.py, scripts/headcount_plan.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/workforce-headcount-plan/SKILL.md · 118 lines

How it starts

The opening of the file, as written. The whole thing — 118 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Workforce Headcount Plan

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 plano de contratação forward-looking de uma empresa amarrado ao crescimento: projeta o headcount necessário por função por trimestre a partir de um driver (receita-alvo, % de crescimento ou headcount-alvo), calcula net new hires (incluindo backfill de attrition) e o custo incremental de folha, em 3 cenários (Conservador / Base / Agressivo). É o artefato estratégico que liga o plano de negócio ao plano de pessoas.

Dual-mode operation (Code + Cowork)

  • Claude Code: python3 scripts/headcount_plan.py ... --output plan.html, gerando roadmap função × trimestre, comparação de cenários, gráficos de headcount e custo (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:

  • "plano de headcount", "workforce planning", "planejamento de quadro"
  • "quantas pessoas preciso contratar pra chegar em R$ X"
  • "headcount plan", "hiring plan", "plano de contratação"
  • "dimensionar / projetar a equipe", "headcount por função"
  • "quanto vai custar crescer o time"

NÃO ativa para: análise de salários atuais vs banda (usar comp-ratio-analyzer); custo de uma folha estática (usar custo-folha-simulator); business case de uma iniciativa (usar hr-initiative-roi).

Inputs

  • Headcount atual (um dos dois):
    • --functions-csv com colunas function,headcount,loaded_cost_annual (custo opcional)
    • --headcount-total (total único, sem quebra por função)
  • Driver de crescimento (um, obrigatório):
    • --target-revenue + (--rev-per-employee ou --current-revenue)
    • --growth-pct (crescimento % do headcount)
    • --target-headcount (alvo total absoluto)
  • Ratios opcionais: --rev-per-employee, --ratios "eng:product=2,sales:cs=3", --manager-span (os dois últimos são informativos no v1).
  • Parâmetros: --avg-loaded-cost (default R$ 240.000/ano, custo carregado quando não vem no CSV), --horizon-quarters (default 4), --attrition-pct (default 0).

Read the full file on GitHub · 118 lines

Files

What ships with it

3 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 118 lines · 228 tokens per session scan A d92c0c61231c

Subscribe to this mod's changes

workforce-headcount-plan is a skill published in the GitHub repository trycomp-io/comp-skills (2 stars, last pushed 3mo ago), licensed MIT. It adds 228 tokens to every session and 1,973 once invoked, about $0.0011 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

contingencia-report

Gera relatórios estruturados de contingência jurídica para uso em balanços, auditoria e compliance. Use quando o usuário precisar classificar processos por probabilidade de perda (provável/possível/remota) conforme CPC art. 95-96 e IAS 37 / CPC 25, calcular impacto financeiro no passivo contingente, ou preparar…

autodevx/legal-skills · 107 tokens

contrato-review

Analisa contratos brasileiros identificando cláusulas problemáticas, riscos jurídicos e oportunidades de negociação. Use quando precisar fazer due diligence contratual, revisar minutas antes de assinatura, identificar cláusulas abusivas ou desequilibradas, verificar conformidade com CC/2002, CDC, LGPD ou legislação…

autodevx/legal-skills · 101 tokens

audiencia-classifier

Classifica publicações de audiência judicial por tipo e modalidade. Use quando receber textos de intimações, pautas de audiência ou publicações do diário de justiça e precisar categorizar automaticamente em INICIAL/INSTRUÇÃO/JULGAMENTO/CONCILIAÇÃO × PRESENCIAL/VIRTUAL/HÍBRIDA. Aplicável a publicações de qualquer…

autodevx/legal-skills · 104 tokens

Geração de RIPD (Relatório de Impacto à Proteção de Dados)

Gera o Relatório de Impacto à Proteção de Dados Pessoais (RIPD) conforme exigido pela LGPD (Art. 38), descrevendo o tratamento, identificando riscos, propondo medidas de mitigação e documentando a base legal aplicável.

autodevx/legal-skills · 74 tokens

Triagem e Resposta a Solicitações de Titulares (LGPD)

Classifica solicitações de titulares de dados pessoais recebidas pelo canal de privacidade, verifica prazo legal de resposta, identifica o direito exercido (Art. 18 LGPD) e gera minuta de resposta formal adequada ao pedido.

autodevx/legal-skills · 61 tokens

cnj-parser

Valida, normaliza e extrai componentes de números de processos judiciais brasileiros no formato CNJ (NNNNNNN-DD.AAAA.J.TT.OOOO). Use quando receber números de processo em formatos variados (com ou sem máscara, colados de sistemas diferentes), precisar validar dígitos verificadores, identificar tribunal, instância e…

autodevx/legal-skills · 102 tokens