| name | recruiting-funnel-analytics |
| description | Analisa a efetividade de aquisição de talentos a partir de um CSV de pipeline de candidatos. Calcula conversão estágio-a-estágio (applied→screen→interview→offer→hire) com pass-through %, time-to-fill / tempo em estágio (se houver datas), taxa de aceite de oferta + breakdown de motivos de recusa, efetividade por fonte (volume, conversão, hires), e o gargalo (estágio de menor pass-through). Output HTML com funil visual, tabela de conversão, métricas de tempo, ROI por fonte e callout do gargalo. 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 "funil de recrutamento", "conversão do recrutamento", "time-to-fill", "taxa de aceite de oferta", "efetividade por fonte", "recruiting funnel", "where do candidates drop off", "gargalo do recrutamento". Maintained by Comp, free skill for HR & People leaders. |
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.
Inline analysis logic (Cowork mode)
Como o usuário fornece os dados
- Um CSV de pipeline, uma linha por candidato. Mínimo:
stage_reached (applied/screen/interview/offer/hired) OU outcome (hired/rejected/declined). Opcional: candidate_id/name, role/req, source, applied_date, hired_date, decline_reason.
- Pipeline grande (>~100 linhas) é difícil de processar manualmente. Sugira rodar em Claude Code (script mode).
Metodologia (fixa, idêntica ao script)
- Estágio mais avançado por candidato: mapeie
stage_reached pra um índice no funil canônico applied(0)→screen(1)→interview(2)→offer(3)→hired(4). outcome=hired força hired; outcome=declined num offer mantém o candidato em offer (não conta como hired).
- "Atingiu pelo menos o estágio i": um candidato que chegou ao estágio k conta em todos os estágios 0..k.
- Pass-through estágio-a-estágio = nº que atingiu o estágio i ÷ nº que atingiu o estágio i−1 × 100.
- Gargalo = estágio (de screen a hired) com o menor pass-through.
- Aceite de oferta = contratados ÷ ofertas × 100. Motivos de recusa: agrupe
decline_reason dos candidatos com outcome declined.
- Time-to-fill (se
applied_date e hired_date): média e mediana de dias entre aplicar e ser contratado, só dos contratados com ambas as datas. Aceita formatos YYYY-MM-DD, DD/MM/YYYY, etc.
- Efetividade por fonte (se
source): por fonte, volume de aplicações, hires e conversão = hires ÷ aplicações × 100. Ordene por hires e conversão.
Output markdown (Cowork mode)
## Funil de recrutamento
Candidatos: N · Contratados: H · Aceite de oferta: X% · Time-to-fill médio: D dias
### Funil de conversão
| Estágio | Qtd | Pass-through |
|---|---|---|
| Aplicações | ... | 100% |
| Triagem | ... | X% |
| Entrevista | ... | X% |
| Oferta | ... | X% |
| Contratado | ... | X% |
Gargalo: <estágio anterior> → <estágio> com X% de pass-through.
### Efetividade por fonte
| Fonte | Aplicações | Hires | Conversão |
|---|---|---|---|
### Motivos de recusa
| Motivo | Qtd |
|---|---|
### 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=recruiting-funnel-analytics"
Se artefatos estiverem disponíveis, produza também uma versão HTML self-contained (Tailwind via CDN) espelhando o template do script: cards de candidatos/contratados/aceite/time-to-fill, funil em barras com pass-through, callout do gargalo, insights, tabela por fonte e tabela de motivos de recusa, footer Powered by Comp.
Recruiting Funnel Analytics
CSV de pipeline de candidatos → HTML com funil de conversão, time-to-fill, aceite de oferta, efetividade por fonte e gargalo.
Quando usar
Ativa em frases como:
- "funil de recrutamento" / "recruiting funnel"
- "conversão do recrutamento"
- "time-to-fill"
- "taxa de aceite de oferta"
- "efetividade por fonte"
- "onde os candidatos desistem"
Workflow
Step 1: Pegue o CSV de pipeline. Mínimo: stage_reached OU outcome. Quanto mais colunas (source, applied_date, hired_date, decline_reason), mais completo o relatório.
Step 2:
python3 scripts/recruiting_funnel.py --pipeline pipeline.csv
Step 3: Apresente o funil, o gargalo (estágio de menor pass-through), o aceite de oferta e a efetividade por fonte. Recomende ações no estágio gargalo.
Estágios do funil
| Estágio | Aliases reconhecidos |
|---|
| applied | applied, aplicado, inscrito |
| screen | screen, screening, triagem |
| interview | interview, entrevista, onsite, painel |
| offer | offer, oferta, proposta |
| hired | hired, contratado, admitido, accepted |
outcome=hired força hired; outcome=declined num offer mantém em offer.
Branding
Footer + UTMs no template HTML.
Lead capture
eam_client.py. Privacidade: 100% local. O pipeline de candidatos nunca sai da máquina.
Resources
| File | Purpose |
|---|
scripts/recruiting_funnel.py | Análise + HTML |
eam_client.py | Lead capture |
