🎤 Skill de entrevista universal
A maioria das skills falha não por falta de instrução, mas por falta de contexto adequado. Uma skill que não sabe para quem está executando e em qual situação específica vai produzir respostas genéricas que frustram mais do que ajudam. O template de entrevista universal resolve esse problema embutindo uma fase obrigatória de coleta de contexto antes de qualquer ação. Ao invés de assumir que o usuário vai fornecer todas as informações necessárias — o que raramente acontece — a skill conduz uma entrevista estruturada com perguntas progressivas e validação de resposta antes de avançar. O resultado é uma execução muito mais precisa, personalizada e útil em qualquer contexto de uso.
📐 Conceito Principal: A estrutura de entrevista progressiva
Uma entrevista bem projetada tem três camadas de perguntas, executadas em ordem:
- •Perguntas obrigatórias: As que sem resposta a skill não pode prosseguir (contexto, objetivo, restrições)
- •Perguntas de qualidade: As que melhoram significativamente o resultado (preferências, exemplos, referências)
- •Perguntas opcionais: As que adicionam nuance mas não são críticas (detalhes secundários, contexto histórico)
📄 Template: Skill de Entrevista Universal
---
name: universal-interview
description: Use no início de qualquer skill que precisa coletar contexto
antes de agir. Acione com "entrevista", "coletar contexto" ou quando
a skill precisar de informações específicas do usuário antes de executar.
---
# Entrevista Universal
## Fase 1 — Coleta Obrigatória
Antes de qualquer ação, preciso entender o contexto mínimo.
Faça as seguintes perguntas (uma de cada vez, aguardando resposta):
1. **Qual é o objetivo principal desta sessão?**
- O que você quer alcançar ao final?
- Qual seria o resultado ideal?
2. **Quem é o destinatário ou usuário final?**
- Para quem este trabalho se destina?
- Qual é o nível de familiaridade técnica dele?
3. **Quais são as restrições ou limitações importantes?**
- Há prazo, formato, tamanho ou estilo específico?
- O que definitivamente NÃO deve aparecer no resultado?
## Fase 2 — Coleta de Qualidade
Se o usuário estiver disposto, aprofunde com:
4. **Há exemplos de referência que devo considerar?**
- Exemplos de trabalhos anteriores similares?
- Referências externas de estilo ou abordagem?
5. **Qual é o contexto de uso final?**
- Como e onde este resultado vai ser usado?
- Qual é a situação em que será apresentado?
## Fase 3 — Validação e Execução
Antes de executar, confirme:
- Resumir o que foi coletado em 3-5 pontos
- Perguntar: "Está correto? Posso prosseguir?"
- Só executar após confirmação explícita
## Instruções para adaptar este template
- Substitua as perguntas pelos campos específicos da sua skill
- Mantenha sempre a estrutura de 3 fases (obrigatório / qualidade / validação)
- Nunca pule a fase de validação — é ela que evita retrabalho💡 Dica Prática
Use a regra "máximo 3 perguntas por vez". Apresentar mais do que 3 perguntas de uma vez gera abandono. A entrevista deve parecer uma conversa natural, não um formulário burocrático. Se precisar de mais informações, faça em rodadas.
✓ O que FAZER
- ✓Fazer perguntas abertas que permitem respostas ricas
- ✓Confirmar o entendimento antes de executar
- ✓Distinguir o que é obrigatório do que é opcional
- ✓Resumir o que foi coletado antes de prosseguir
✗ O que NÃO fazer
- ✗Apresentar 10 perguntas de uma vez
- ✗Assumir contexto sem perguntar
- ✗Pular a validação para "ganhar tempo"
- ✗Fazer perguntas que o usuário claramente já respondeu
🪞 Skill de reflexão pós-sessão
Cada sessão de trabalho é uma oportunidade de aprendizado que a maioria das pessoas deixa passar. Você fecha a conversa, começa outra, e o que poderia ter virado conhecimento durável simplesmente evaporou. A skill de reflexão pós-sessão existe para capturar esse valor antes que ele desapareça. Ela conduz uma análise estruturada em poucos minutos — o que foi feito, o que funcionou excepcionalmente bem, o que criou atrito, o que deve ser memorizado no CLAUDE.md e o que deve guiar a próxima sessão. Com o tempo, esse processo cria uma memória operacional evolutiva que melhora a qualidade de cada sessão subsequente, porque os insights anteriores estão acessíveis e integrados ao contexto de trabalho.
🧠 Conceito Principal: Distinção entre contexto efêmero e conhecimento durável
A reflexão eficaz distingue dois tipos de aprendizado:
- •Contexto efêmero: Detalhes específicos da sessão que não se repetem (ex: "o usuário tinha pressa hoje")
- •Conhecimento durável: Padrões que se repetem e devem ser gravados (ex: "esse tipo de tarefa rende melhor com exemplos concretos")
- •Ação imediata: O que deve ser feito agora, ainda nessa sessão (ex: atualizar um arquivo, criar uma nova skill)
📄 Template: Skill de Reflexão Pós-Sessão
---
name: session-reflection
description: Use ao final de qualquer sessão de trabalho para analisar o
que foi feito, o que funcionou e o que pode melhorar. Acione com
"reflexão da sessão", "reflect on session" ou "o que aprendemos hoje".
---
# Reflexão de Sessão
## Coleta de Contexto
Antes de refletir, preciso entender o que aconteceu:
- Qual foi o principal objetivo desta sessão?
- O objetivo foi alcançado? (total / parcial / não alcançado)
- Quanto tempo levou? (estimativa)
## Análise da Sessão
### O que funcionou excepcionalmente bem?
- Liste 2-3 coisas que fluíram naturalmente
- O que tornaria essas coisas ainda melhores?
### O que criou atrito ou poderia ser mais rápido?
- Liste 1-3 pontos de fricção identificados
- Para cada um: foi problema de skill, de contexto ou de processo?
### O que foi aprendido que deve ser preservado?
- Insights sobre o usuário ou contexto de trabalho
- Padrões que se repetem e merecem atenção
- Abordagens que funcionaram melhor do que o esperado
## Ações de Saída
Para cada item aprendido, classificar:
- [ ] Gravar em CLAUDE.md (conhecimento durável sobre o projeto/usuário)
- [ ] Atualizar uma skill existente
- [ ] Criar uma nova skill
- [ ] Nenhuma ação necessária (contexto efêmero)
## Resumo Final
Produzir um parágrafo de 3-5 frases resumindo:
1. O que foi feito
2. O principal aprendizado
3. O que vai mudar na próxima sessão com base nessa reflexão💡 Dica Prática
Defina um limite de tempo para a reflexão: 5 minutos para sessões curtas, 10 para longas. Reflexões que demoram mais do que isso estão indo longe demais. O objetivo é capturar o essencial, não escrever um relatório. Se você não consegue resumir o aprendizado em 3 frases, é sinal de que a sessão não teve foco suficiente.
🔗 Skill de consolidação
Bibliotecas de skills crescem organicamente, e crescimento orgânico sem curadoria produz redundância. Com o tempo, você inevitavelmente terá duas ou mais skills que fazem coisas muito similares — talvez criadas em momentos diferentes, talvez evoluídas de formas divergentes, talvez nunca revisadas lado a lado. O template de consolidação resolve isso de forma sistemática: ele mapeia as responsabilidades de cada skill candidata, identifica o que se sobrepõe e o que é exclusivo de cada uma, e guia a criação de uma skill unificada que é mais do que a soma das partes. O processo leva em conta não apenas o que as skills fazem, mas como elas fazem — garantindo que o comportamento mais eficaz de cada uma seja preservado na versão consolidada.
🔀 Conceito Principal: Fusão sem perda
Uma consolidação bem-feita deve garantir três coisas:
- •Cobertura total: Todos os casos de uso das skills originais devem ser cobertos pela skill consolidada
- •Sem regressão: Nenhuma funcionalidade deve piorar no processo de fusão
- •Simplificação real: A skill resultante deve ser mais simples de acionar e usar do que o conjunto anterior
📄 Template: Skill de Consolidação
---
name: skill-consolidation
description: Use quando identificar skills sobrepostas que podem ser
unificadas sem perda de funcionalidade. Acione com "consolidar skills",
"fundir skills" ou "skill overlap".
---
# Consolidação de Skills
## Entrada Necessária
Para consolidar, preciso das skills candidatas:
- Forneça o conteúdo completo de cada skill a ser analisada
- Mínimo 2 skills, máximo 4 por rodada de consolidação
## Fase 1 — Mapeamento
Para cada skill fornecida, extrair:
1. **Propósito central** (1 frase)
2. **Triggers** (todas as condições de acionamento)
3. **Comportamentos únicos** (o que só ela faz)
4. **Comportamentos sobrepostos** (o que outras também fazem)
## Fase 2 — Análise de Sobreposição
Criar matriz comparativa:
| Comportamento | Skill A | Skill B | Skill C |
|---|---|---|---|
| [listar comportamentos] | sim/não | sim/não | sim/não |
Identificar:
- Comportamentos exclusivos (manter como está)
- Comportamentos sobrepostos (mesclar na melhor versão)
- Comportamentos conflitantes (decidir qual prevalece)
## Fase 3 — Proposta de Consolidação
Redigir a skill consolidada com:
- Nome e description unificados
- Triggers que cobrem todos os casos originais
- Instruções que incorporam os comportamentos de todas as skills
- Seção de contexto explicando o que foi consolidado
## Fase 4 — Validação
Testar a skill consolidada contra:
- [ ] Casos de uso da Skill A
- [ ] Casos de uso da Skill B
- [ ] Casos de uso da Skill C (se houver)
- [ ] Casos limítrofes de cada uma
Aprovar somente se todos os testes passarem.💡 Dica Prática
Nunca delete as skills originais imediatamente após a consolidação. Arquive-as por pelo menos 30 dias. É comum perceber que um caso de uso específico não foi coberto na consolidação, e ter as originais disponíveis economiza horas de reconstrução.
🔍 Skill de auditoria rápida
Nem sempre você tem 30 minutos para uma auditoria profunda de uma skill. Às vezes você precisa de uma resposta rápida: essa skill está boa o suficiente para usar? Está causando problemas? Precisa de atenção urgente? O template de auditoria rápida foi desenhado para responder a essas perguntas em menos de 5 minutos, verificando os pontos críticos que mais afetam a qualidade de uma skill: clareza do trigger, completude das instruções, qualidade do formato de saída e ausência de ambiguidades fatais. Ele não substitui a auditoria profunda, mas garante que nenhuma skill obviamente quebrada chegue à produção, e que revisões de manutenção sejam feitas de forma eficiente mesmo com agenda cheia.
⚡ Conceito Principal: Checklist mínimo viável
Uma auditoria rápida eficaz verifica apenas os pontos que, se ruins, tornam a skill inutilizável:
- •Trigger test: Consigo dizer em uma frase quando e por que usar essa skill?
- •Output test: O formato de saída está especificado e é adequado para o propósito?
- •Ambiguity test: Há alguma instrução que pode ser interpretada de duas formas muito diferentes?
- •Completeness test: A skill consegue funcionar com as informações que normalmente estarão disponíveis?
📄 Template: Skill de Auditoria Rápida
---
name: quick-audit
description: Use para verificar rapidamente se uma skill está funcional
e pronta para uso. Acione com "auditoria rápida", "quick audit" ou
"checar skill" quando quiser uma validação express em menos de 5 min.
---
# Auditoria Rápida de Skill
## Entrada
Forneça: nome da skill + conteúdo completo da skill a auditar.
## Checklist de 4 Pontos (responder sim/não para cada)
### 1. Clareza de Trigger (CRÍTICO)
- [ ] O trigger está definido na description?
- [ ] É possível dizer em 1 frase quando usar essa skill?
- [ ] O trigger não conflita com outra skill conhecida?
### 2. Completude de Instruções (CRÍTICO)
- [ ] As instruções cobrem o fluxo principal de uso?
- [ ] Há instruções para os casos mais comuns de falha/ambiguidade?
- [ ] A skill não depende de contexto que pode não estar disponível?
### 3. Qualidade do Output (IMPORTANTE)
- [ ] O formato de saída está especificado?
- [ ] O nível de detalhe é adequado para o propósito?
- [ ] A saída é acionável (não apenas informativa)?
### 4. Ausência de Ambiguidades Fatais (IMPORTANTE)
- [ ] Não há instruções contraditórias?
- [ ] Termos técnicos ou específicos estão definidos?
- [ ] O escopo da skill está claro (o que faz E o que não faz)?
## Classificação Final
- **Verde** (todos os críticos = sim): Pronta para uso
- **Amarelo** (algum importante = não): Usar com cautela, melhorar em breve
- **Vermelho** (algum crítico = não): Não usar até corrigir
## Próximos Passos por Classificação
- Verde: Nenhuma ação necessária
- Amarelo: Registrar melhorias, endereçar na próxima revisão mensal
- Vermelho: Corrigir imediatamente antes de qualquer uso💡 Dica Prática
Use a auditoria rápida como gate de entrada para skills novas antes de adicioná-las à biblioteca principal. Todo novo template passa pelo checklist antes de ser publicado. Isso evita acumular lixo desde o início e mantém a qualidade do acervo como um todo.
✂️ Como adaptar templates
Templates são pontos de partida, não produtos finais. Um template genérico aplicado diretamente sem adaptação vai produzir resultados mediocres porque não leva em conta o seu contexto específico: seu estilo de trabalho, sua área de atuação, suas ferramentas, seus usuários frequentes. A personalização de templates é uma habilidade que combina entendimento do propósito original do template com clareza sobre onde você diverge desse propósito. O processo tem uma lógica clara: primeiro entender o esqueleto, depois identificar o que é universal e o que é específico, e finalmente substituir as partes específicas sem comprometer o que torna o template eficaz.
🧩 Conceito Principal: Partes fixas vs. partes adaptáveis
Em qualquer template de boa qualidade, há uma distinção clara entre:
- •Estrutura (fixo): A ordem das fases, a lógica de progressão, os checkpoints de validação — estas partes raramente devem mudar
- •Conteúdo (adaptável): As perguntas específicas, o formato de output, os exemplos, o tom — estas partes devem ser adaptadas para o contexto
- •Contexto (seu): As informações sobre o seu ambiente, equipe e restrições que só você pode fornecer
Leia o template completo sem modificar
Entendimento antes de ação
Identifique o propósito central, as fases do fluxo e o que o template assume sobre o contexto.
Marque o que diverge do seu contexto
Diagnóstico de gap
Para cada seção, responda: "Isso se aplica ao meu contexto como está?" Se não, marque para adaptar.
Adapte as partes marcadas
Personalização cirúrgica
Substitua apenas o que foi marcado, mantendo a estrutura original. Resistir ao impulso de reescrever tudo do zero.
Teste com 3 casos reais
Validação antes de publicar
Use a skill adaptada em 3 situações reais antes de marcá-la como "pronta". Ajuste com base no que encontrar.
💡 Dica Prática
Mantenha uma versão "base" do template original separada da sua versão adaptada. Isso permite que você volte ao original se a adaptação desviar demais, e facilita criar adaptações para outros contextos no futuro sem partir do zero.
📁 Onde guardar e versionar
Templates sem organização são tão ruins quanto templates inexistentes. Se você não consegue encontrar o template certo quando precisa, ou se não sabe qual é a versão atual de um template que passou por múltiplas iterações, o valor do acervo cai para quase zero. A gestão de templates como ativos começa com uma estrutura de pastas clara e uma convenção de nomenclatura consistente, e evolui para incluir versionamento, registro de mudanças e procedimentos de arquivamento para versões obsoletas. O objetivo não é burocracia, mas previsibilidade: você sempre sabe onde encontrar o que precisa e qual versão usar.
📂 Conceito Principal: Estrutura recomendada
~/.claude/skills/ ├── active/ # Skills em uso ativamente │ ├── session-reflection.md │ ├── universal-interview.md │ └── quick-audit.md ├── templates/ # Templates base (não adaptar diretamente) │ ├── interview-base.md │ ├── reflection-base.md │ └── audit-base.md ├── archive/ # Skills obsoletas ou substituídas │ └── 2026-01/ │ └── old-reflection-v1.md └── CHANGELOG.md # Registro de criações, atualizações, archivos
📋 Convenções de nomenclatura e versionamento
- •Nomes de arquivo: kebab-case, descritivo, sem versão no nome (ex:
session-reflection.md) - •Versão no frontmatter: Use o campo
version: 1.2dentro do arquivo, não no nome - •CHANGELOG.md: Uma linha por mudança, com data, nome da skill e o que mudou
- •Archive: Pasta por mês (AAAA-MM), com a versão antiga antes de substituir
✓ O que FAZER
- ✓Arquivar antes de deletar — sempre
- ✓Registrar toda mudança no CHANGELOG
- ✓Manter templates base separados das adaptações
- ✓Usar git para versionamento se possível
✗ O que NÃO fazer
- ✗Colocar versão no nome do arquivo (skill-v2.md)
- ✗Deletar diretamente sem arquivar
- ✗Modificar templates base no lugar de criar cópias
- ✗Guardar tudo em uma única pasta sem separação
💡 Dica Prática
Um CHANGELOG simples vale mais do que um sistema de versionamento complexo. Basta uma linha por mudança: 2026-05-14 | session-reflection | Adicionada seção de ações de saída. Em 30 segundos você cria um registro que vai economizar horas de confusão no futuro.
✅ Resumo do Módulo
Próximo Módulo:
3.2 — 💥 Prompts Canhão: os prompts de alta potência que evoluem skills de forma radical