SkillProgramaçãoCriação
Escrever Skills (TDD para Processos)
Trata a autoria de skills como TDD aplicado a documentação de processo: rode um cenário de pressão com um subagente antes, documente as falhas, escreva a skill mínima que as resolve e feche as brechas. Use ao criar, editar ou validar skills antes do deploy.
Ações
PerfilHíbrido
ProfundidadeAlta
IdiomaInglês (skill original)
Objetivo
Em uma frase.
Escrever skills usando Test-Driven Development aplicado a documentação de processo. Primeiro rode um cenário-baseline de pressão com um subagente (RED) e observe-o falhar; depois escreva a skill mínima que ataca exatamente aquelas falhas (GREEN); por fim, feche as brechas de racionalização (REFACTOR). Lei de ferro: nenhuma skill sem um teste que falha antes — vale tanto para skills novas quanto para edições de skills existentes.
Aplicação
Quando
faz sentido.
Usar
- Criar uma skill nova no catálogo.
- Editar uma skill existente (ainda exige teste-baseline).
- Validar que uma skill funciona antes do deploy.
Não usar
- Soluções pontuais que você não vai reutilizar.
- Práticas padrão já bem documentadas em outro lugar — referencie-as.
- Convenções específicas do projeto (coloque no CLAUDE.md, não em uma skill).
- Restrições mecânicas que regex ou lint conseguem impor — automatize, não documente.
Prompt
Instruções
para a IA.
### Ciclo RED-GREEN-REFACTOR
No RED, rode o cenário de pressão com o subagente SEM a skill e documente o comportamento real: que escolhas ele fez, quais racionalizações usou (literalmente) e quais pressões dispararam violações. Você precisa ver o que os agentes fazem naturalmente antes de escrever a skill. No GREEN, escreva a skill mínima que ataca aquelas racionalizações específicas — sem conteúdo para casos hipotéticos — e rode os mesmos cenários COM a skill até obter conformidade. No REFACTOR, a cada nova racionalização adicione um contraponto explícito e re-teste até ficar à prova de balas.
### Description não é resumo de workflow
O campo
### Blindagem contra racionalização
Skills que impõem disciplina (TDD, debugging) precisam resistir a desculpas. Não basta declarar a regra — proíba os atalhos específicos. Adicione cedo o princípio "violar a letra da regra é violar o espírito da regra", monte uma tabela de racionalizações (desculpa vs. realidade) capturadas no baseline e crie uma lista de red flags para autoverificação.
### Eficiência de tokens
Mire em menos de 200 palavras para skills carregadas com frequência e menos de 500 para as demais. Um exemplo de código excelente vale mais que cinco medíocres em linguagens diferentes.
No RED, rode o cenário de pressão com o subagente SEM a skill e documente o comportamento real: que escolhas ele fez, quais racionalizações usou (literalmente) e quais pressões dispararam violações. Você precisa ver o que os agentes fazem naturalmente antes de escrever a skill. No GREEN, escreva a skill mínima que ataca aquelas racionalizações específicas — sem conteúdo para casos hipotéticos — e rode os mesmos cenários COM a skill até obter conformidade. No REFACTOR, a cada nova racionalização adicione um contraponto explícito e re-teste até ficar à prova de balas.
### Description não é resumo de workflow
O campo
description decide se a skill é carregada. Ele deve responder "devo ler esta skill agora?", contendo apenas as condições de gatilho, nunca um resumo do passo a passo. Descrições que resumem o workflow criam um atalho que o agente toma em vez de ler o corpo da skill.### Blindagem contra racionalização
Skills que impõem disciplina (TDD, debugging) precisam resistir a desculpas. Não basta declarar a regra — proíba os atalhos específicos. Adicione cedo o princípio "violar a letra da regra é violar o espírito da regra", monte uma tabela de racionalizações (desculpa vs. realidade) capturadas no baseline e crie uma lista de red flags para autoverificação.
### Eficiência de tokens
Mire em menos de 200 palavras para skills carregadas com frequência e menos de 500 para as demais. Um exemplo de código excelente vale mais que cinco medíocres em linguagens diferentes.
Constelação
Onde
ela vive.
Bundles que incluem
Execução
Como usar
com IA.
- 01Copie a skill (botão "Copiar skill para IA", no topo): o texto copiado já é a skill completa, não um resumo.
- 02Abra o Claude ou Claude Code e cole — a IA recebe todas as instruções e fica pronta para a tarefa.
- 03Prefere usar como arquivo reutilizável? Baixe o .zip e coloque o
SKILL.mdem.claude/skills/(Claude Code) ou anexe o arquivo no Claude (claude.ai).