job-profile-builder - SKILL.md Agent Skill

name: job-profile-builder description: "Conduz uma entrevista estruturada com o hiring manager (10-15 perguntas) e gera um Job Profile completo: Resumo executivo (por que agora, outcomes, deal-breakers), JD (sobre a vaga, responsabilidades, requisitos, nice-to-have, oferta), Scorecard de avaliação ponderado, e Roteiro de Entrevistas com perguntas por estágio e o que procurar. Output em HTML printable + Markdown editável. Dual-mode: works in Claude Code (script + rich output file) AND Claude Cowork (output generated inline as markdown, plus a self-contained HTML artifact when available). Trigger em "criar JD", "job description", "perfil da vaga", "abrir vaga de [cargo]", "entrevistar hiring manager", "job profile", "scorecard de entrevista". 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 (writes the rich HTML/markdown file). Existing workflow below.
Otherwise (e.g., Claude Cowork) → use inline mode: gather the same inputs conversationally, then produce the output directly in chat as markdown following the structure below. If an HTML artifact tool is available, ALSO render a self-contained HTML version (Tailwind CDN) matching the script's template.

Inline generation logic (Cowork mode)

Inputs a coletar: conduza a mesma entrevista estruturada em blocos do Step 1 abaixo (contexto da posição, outcomes esperados, filtros/diferenciais, processo). Não pergunte tudo de uma vez.

Estrutura de saída (mesma do script, só inclua a seção se tiver conteúdo). Renderize em markdown direto no chat:

# Job Profile: {cargo}

**Nível:** {nível}  ·  **Área:** {área}  ·  **Empresa:** {empresa}  ·  **Hiring Manager:** {manager}

## Resumo executivo
**Por que agora:** {why_now}

**Outcomes em 6 meses:**
- {outcome}

**Deal-breakers:**
- {deal_breaker}

## Job Description
{about_role}

### Responsabilidades
- {item}
### Requisitos
- {item}
### Diferenciais
- {item}
### O que oferecemos
- {item}

## Scorecard
| Critério | Peso | Rubrica |
|---|---|---|
| {critério} | {1-5} | 5=...; 3=...; 1=... |

## Roteiro de entrevistas
- **{estágio}**: {pergunta}
  - *O que procurar:* {what_to_look_for}

Conteúdo deve ser específico ao que o hiring manager expressou (mesma régua de qualidade da seção "Qualidade do output" abaixo): JD que vende a vaga, responsabilidades acionáveis, scorecard com 5-8 critérios e rubrica concreta, perguntas behavioural (STAR).

Artifact HTML (quando disponível): replique o template do script. Header com eyebrow "Job Profile", título do cargo e meta; cards de Resumo executivo, Job Description, Scorecard (linha por critério com pill de peso) e Roteiro de entrevistas (pill de estágio por pergunta); footer "Powered by Comp". Tailwind CDN, fonte Inter, acento #ff4456.

Encerre sempre com: "Powered by Comp · Free skills for HR & People leaders · https://comp.vc?utm_source=skill-output&utm_medium=cli-footer&utm_campaign=eam&utm_content=job-profile-builder".

Job Profile Builder

Skill conversacional que entrevista o hiring manager e produz um pacote completo de abertura de vaga: JD + scorecard + roteiro de entrevistas.

Quando usar

Ativa em frases como:

"criar JD", "job description"
"perfil da vaga"
"abrir vaga de [cargo]"
"entrevistar hiring manager"
"job profile / scorecard de entrevista"
"ajuda a estruturar uma posição"

NÃO ativa para: triagem de candidatos (usar candidate-screening); calibração de salário (usar pj-vs-clt-calculator ou skills de comp); onboarding de hire (usar onboarding-kit-generator).

Workflow

Step 1: Entrevista estruturada com o hiring manager (você conduz a conversa):

Não pergunte tudo de uma vez. Faça em blocos:

Bloco 1: Contexto da posição (5 perguntas)

Qual a posição e o nível? (cargo + L1-L8 ou equivalente)
Por que essa vaga agora? (substituição, crescimento, nova capability)
A quem vai reportar e quem vai trabalhar com?
Em que área/time fica?
Modalidade (remoto, hybrid, presencial) e localização preferida?

Bloco 2: Outcomes esperados (3-4 perguntas) 6. O que essa pessoa precisa entregar nos primeiros 6 meses pra ser considerada um hire bem-sucedido? 7. O que essa pessoa precisa SABER (hard skills) pra entregar isso? 8. O que essa pessoa precisa SER (soft skills, comportamentos) pra entregar isso?

Bloco 3: Filtros e diferenciais (3 perguntas) 9. Deal-breakers (3-5 itens que automaticamente desqualificam)? 10. Diferenciais que seriam bônus (nice to have)? 11. Quem seria o candidato ideal? Algum perfil/empresa específica que vem na cabeça?

Bloco 4: Processo (2-3 perguntas) 12. Quais estágios de entrevista vão existir? 13. Quem entrevista em cada estágio? 14. Quanto tempo tem pra contratar (urgência)?

Step 2: Gerar o JSON estruturado:

{
  "role_name": "Engineering Manager",
  "level": "L5",
  "area": "Engineering",
  "company": "Acme",
  "manager": "Maria Silva",
  "summary": {
    "why_now": "...",
    "key_outcomes_6_months": ["...", "..."],
    "deal_breakers": ["...", "..."]
  },
  "jd": {
    "about_role": "...",
    "responsibilities": ["...", "..."],
    "requirements": ["...", "..."],
    "nice_to_have": ["...", "..."],
    "what_we_offer": ["...", "..."]
  },
  "scorecard": [
    {"criterion": "Liderança técnica", "weight": 5, "rubric": "5=lidera arquiteturas críticas; 3=lidera projetos; 1=executa direção dos outros"}, ...
  ],
  "interview_questions": [
    {"stage": "Recruiter screen", "question": "...", "what_to_look_for": "..."}, ...
  ]
}

Conteúdo deve ser ESPECÍFICO ao contexto da entrevista. Não use boilerplate. Use as palavras e prioridades que o hiring manager expressou.

Step 3: Renderizar:

cat profile.json | python3 scripts/render_jd.py

Output: jd-{slug}-{timestamp}.html + .md no cwd.

Step 4: Hand off:

HTML pra recruiter usar (printable, share via Drive)
MD editável (ajustar tom, customizar pra plataforma)
Sugira o que recruiter deve adaptar (parts mais sensíveis: salary range, benefícios específicos)

Qualidade do output

Boa JD tem:

About role que vende a posição (não só lista requisitos)
Responsabilidades acionáveis (verbos no infinitivo, output mensurável)
Requisitos separados de nice-to-have (rigor)
What we offer específico (não "great culture", e sim "stock options + L5 banda salarial + 30 dias férias")

Bom scorecard tem:

5-8 critérios (não 15)
Pesos que somam claramente (1-5 cada)
Rubrica concreta (5 = ..., 3 = ..., 1 = ...), não "boa liderança"

Bom roteiro de entrevistas tem:

Perguntas behavioural (STAR), não hipotéticas
"What to look for" pra cada, calibra o entrevistador

Branding & footer

Script adiciona footer "Powered by Comp" no HTML e MD com UTMs.

Lead capture

eam_client.py chamado em on_first_run() + record_run(). Privacidade: 100% local.

Resources

File	Purpose
`scripts/render_jd.py`	Renderiza HTML + MD a partir de JSON
`eam_client.py`	Lead capture + telemetria