🩼 Skill como muleta
À medida que você domina a criação de skills, existe um efeito colateral previsível: você começa a usar skills para tudo. Precisa de um comportamento consistente? Cria uma skill. Precisa de contexto global? Cria uma skill. Precisa de uma tarefa repetível? Cria uma skill. O resultado é uma biblioteca inflada com dezenas de skills onde metade poderia ser substituída por uma ferramenta mais simples e eficaz. Usar a ferramenta certa para cada trabalho não é um detalhe — é a diferença entre um sistema que funciona e um que se torna difícil de manter.
🩼 Sinais de que você está usando skill como muleta
- •Você tem skills para comportamentos que deveriam ser sempre ativados
- •Você tem skills para contexto que não muda entre projetos
- •Você tem skills para tarefas que um script CLI resolveria em 2 segundos
- •Você tem mais de 20 skills e usa menos de 5 regularmente
📏 Skill vs Rule
Uma Rule é uma instrução que o Claude sempre segue, em toda interação, independente do contexto — sem precisar ser acionada. Se você quer que o Claude sempre responda em português, nunca use m-dash, sempre formate código de determinada forma ou mantenha um tom específico em todas as respostas, isso é uma Rule, não uma skill. Skills são acionadas contextualmente; Rules são sempre ativas. Para comportamentos globais e consistentes, a Rule é mais eficaz com menos overhead.
✓ Use Rule quando...
- ✓O comportamento deve se aplicar a TODA interação
- ✓É uma proibição ou restrição permanente
- ✓Não depende do tipo de tarefa
- ✓Exemplos: idioma, formatação global, tom padrão
✓ Use Skill quando...
- ✓O comportamento é específico a um tipo de tarefa
- ✓Requer instrução detalhada e estruturada
- ✓O output varia significativamente por contexto
- ✓Exemplos: copywriting, análise, diagnóstico
📄 Skill vs Claude.md
O CLAUDE.md carrega contexto persistente sobre o projeto atual — informações que devem estar disponíveis em toda interação sem precisar de ativação. Quem é o usuário, quais são as tecnologias do projeto, qual é o estilo de código preferido, quais são as convenções do time. Se a informação é sobre "quem você é" ou "qual é o projeto", vai no CLAUDE.md. Se é sobre "o que fazer em determinada situação", vai na skill. Colocar contexto de projeto em uma skill significa que ele só está disponível quando a skill é acionada — uma limitação desnecessária.
📄 Divisão de Responsabilidades
CLAUDE.md
- • Quem é o usuário
- • Qual é o projeto
- • Tecnologias em uso
- • Convenções do time
- • Preferências persistentes
Skill
- • O que fazer em X situação
- • Como gerar determinado output
- • Processo de análise específico
- • Instruções detalhadas de tarefa
- • Workflows com múltiplos passos
💻 Skill vs CLI
Para tarefas determinísticas — onde a entrada e a saída são previsíveis e não variam — um alias de linha de comando ou script é dramaticamente mais eficiente que uma skill. Skills têm overhead de interpretação: o modelo precisa ler a skill, interpretar as instruções e gerar o output. Para tarefas mecânicas que um script executa em milissegundos com 100% de consistência, esse overhead não faz sentido. O critério é simples: se você pode escrever o output esperado em um script, use um script.
✗ Não crie skill para isso
- ✗Converter arquivos de formato (JSON → CSV)
- ✗Renomear arquivos em massa seguindo uma regra
- ✗Extrair dados de logs seguindo padrão fixo
- ✗Gerar boilerplate sempre idêntico
✓ Crie skill para isso
- ✓Análise de código que requer julgamento
- ✓Geração de documentação que varia por contexto
- ✓Diagnóstico de problemas com múltiplas variáveis
- ✓Comunicação que precisa de tom adaptativo
🤖 Skill vs Automação
Quando um processo se repete regularmente com as mesmas entradas e o mesmo resultado esperado, e precisa rodar sem interação manual, a resposta certa é automação — não skill. Skills são para decisões que requerem julgamento contextual e ativação manual. Processos regulares e predefinidos (relatórios semanais, processamento de formulários, notificações automáticas) pertencem ao domínio de ferramentas como n8n, Make ou scripts agendados. Usar skill para isso seria como usar uma faca cirúrgica para cortar papel.
🤖 Critérios para Automação
Recorrência previsível — acontece na mesma frequência com as mesmas condições
Sem julgamento necessário — o resultado correto é sempre o mesmo para a mesma entrada
Pode rodar sem supervisão — não precisa de aprovação ou revisão humana a cada execução
Múltiplos passos determinísticos — sequência de ações fixas que não variam por contexto
🗺️ O fluxo de decisão
Com quatro perguntas simples, você escolhe a primitiva certa em menos de 30 segundos. O fluxo elimina a análise desnecessária e torna a escolha uma decisão automática. Memorize o fluxo e você vai parar de criar skills por inércia — cada nova adição à sua biblioteca será intencional e na primitiva correta.
🗺️ Fluxo de Decisão em 4 Perguntas
"Deve acontecer em TODA interação, sem ativação?"
→ SIM: Use Rule
→ NÃO: Próxima pergunta
"É contexto sobre o projeto ou o usuário que não muda?"
→ SIM: Use CLAUDE.md
→ NÃO: Próxima pergunta
"É uma tarefa determinística que um script executa melhor?"
→ SIM: Use CLI ou Automação
→ NÃO: Próxima pergunta
"Requer julgamento contextual e instrução detalhada?"
→ SIM: Use Skill
→ NÃO: Reconsidere se é necessário criar qualquer coisa
💡 Dica Prática
Imprima ou salve o fluxo de decisão e use antes de criar qualquer nova skill. Nos primeiros 30 dias, a fricção de consultar o fluxo vai automaticamente criar o hábito de escolha consciente de primitivas.
🔀 Resumo do Módulo
Próximo Módulo:
2.8 — 🔍 Auditoria Séria: use o agente claude-code-guide para auditar estruturalmente toda a sua biblioteca