Conteúdo detalhado
🖐️ Comece manual: faça à mão, depois capture
A camada de Habilidades começa do jeito menos óbvio: à mão. Você executa a tarefa de verdade uma primeira vez — às vezes digitando por uma hora todo o seu raciocínio sobre como atacar o problema — e só depois captura aquilo numa skill. A meta é simples: ao fim daquela sessão, nunca mais ter que repetir aquele nível de instrução.
🌱 Novo aqui?
Uma skill (habilidade) é uma tarefa empacotada para rodar igual toda vez — pense num cartão de receita. No Claude Code ela costuma virar um slash command (um comando que começa com barra, ex.: /monthly-review), guardado num arquivo SKILL.md dentro da pasta skills/ do seu OS. Você "cozinha no feeling" algumas vezes e só então escreve a receita.
Como ler: a skill não nasce do nada. Ela é o último passo de um caminho que começa fazendo a tarefa à mão — é por isso que uma skill de algo que você nunca executou sai genérica.
✓ Manual primeiro
- ✓Você prova que a tarefa funciona antes de empacotá-la.
- ✓A receita reflete os detalhes reais que só aparecem fazendo.
- ✓Você sabe exatamente o que verificar no fim.
✗ Skill fantasma
- ✗Escrever uma skill de algo que você nunca fez à mão.
- ✗Resultado genérico que quebra no primeiro caso real.
- ✗Você não tem critério para saber se deu certo.
Por que aprender
Porque é o que separa skill viva de skill morta. Fazer à mão primeiro injeta no seu contexto todos os detalhes finos — exceções, ordem dos passos, o que verificar — que uma skill inventada do zero não tem. Capturar depois transforma esse trabalho num ativo que você nunca mais refaz.
Conceitos-chave
🔁 Reverse meta-prompting
Depois de fazer a tarefa à mão, vem a captura. O mecanismo se chama reverse meta-prompting: em vez de você escrever a skill, você pede à IA para destilar a conversa que acabaram de ter num comando reutilizável. É escrever a receita depois de cozinhar, não antes.
🌱 Novo aqui?
"Meta-prompting" comum é você dar instruções para a IA. Reverse meta-prompting inverte: a IA olha para o que vocês já fizeram juntos e extrai as instruções — o critério, a ordem, os cuidados — e os materializa num arquivo. Você vira editor de uma receita que a IA rascunhou a partir da sua própria ação.
💡 A sacada
Peça sempre um slash command que aceita um argumento. Esse argumento é uma frase em linguagem natural que enriquece o que o comando faz — assim a mesma skill serve a vários casos sem você reescrevê-la. Por baixo, ela deve ter um SOP (procedimento operacional padrão): exatamente o que acontece, em que sequência.
Por que aprender
Porque é o atalho que transforma esforço único em capacidade permanente. Sem reverse meta-prompting, cada tarefa recomeça do zero. Com ele, a primeira execução à mão "paga" por todas as próximas — e você ainda aprende a estruturar o pedido (destilar critério → materializar → aceitar argumento).
Conceitos-chave
♾️ O sinal do infinito: nunca se termina uma skill
Quando você tem uma V1 da skill, você a lança (ship). Mas a camada de habilidades é a que mais confunde: muita gente acha que se "começa e termina" uma skill. Não. Tem um sinal de infinito aqui. O autor mantém uma skill que afina quase todos os dias há seis meses.
Como ler: não há "fim" no canto direito. A skill gira: lança, usa, faz o post-mortem, ajusta — e volta a usar. O símbolo ∞ no centro é o ponto: a skill é viva enquanto você a usa.
🔎 A exceção que vira regra
Há um caso em que a skill "termina": quando ela dispara 100% autônoma, sempre com a mesma entrada e saída. Aí surge a pergunta certa — isso ainda deveria ser uma skill, ou já é um script determinístico? (É o tópico 5.)
Por que aprender
Porque calibra a expectativa. Quem espera "terminar" uma skill abandona-a no primeiro atrito e ela apodrece. Quem entende o ∞ volta, ajusta e fica com uma skill cada vez melhor — exatamente a mentalidade "cultive, não instale" aplicada à camada de ação.
Conceitos-chave
🧪 Post-mortem ao fim da sessão (com rubrica)
Como, na prática, você gira o ∞ do tópico anterior? Com um post-mortem no fim da sessão. Você pergunta ao Claude Code: "com base em como foi esta sessão, como — se for o caso — deveríamos afinar a skill?". E entrega uma rubrica: o critério de quando mudar algo e quando deixar como está.
Por que aprender — o post-mortem em 4 passos
Termina a sessão
Você usou a skill numa tarefa real. Antes de fechar, ela ainda está fresca na memória do contexto.
Pergunta o ajuste
"Dado como foi, deveríamos mudar a skill? O quê e por quê?" A IA propõe afinos pontuais.
Aplica a rubrica
A rubrica diz quando vale mudar (erro recorrente, passo faltando) e quando não (foi caso isolado).
Persiste o aprendizado
O ajuste entra na skill (ou numa regra). Na próxima vez, a skill já chega melhor.
💡 Por que a rubrica importa
Sem rubrica, a IA muda a skill a cada vento — e você acumula mudanças impulsivas que se contradizem. A rubrica é o freio: ela só muda quando o critério justifica. Pode parecer meticuloso demais, e há outras formas de avaliar, mas é o que mantém a skill estável.
Conceitos-chave
⏰ Skill vs job agendado (cron)
Nem tudo que repete deve ser skill. Se algo roda 100% autônomo — mesma entrada, mesma saída, sem julgamento — talvez devesse ser um script determinístico (um Python ou JavaScript que a própria IA escreve), possivelmente disparado por um cron.
🌱 Novo aqui?
Um cron (ou "job agendado") é um relógio do sistema que roda um comando sozinho num horário fixo — ex.: toda segunda às 8h. Determinístico quer dizer: dada a mesma entrada, sempre a mesma saída, sem a IA "decidir". É o oposto de uma skill que pede julgamento a cada uso.
✓ Deixe como skill quando
- ✓Cada uso pede algum julgamento ou contexto novo.
- ✓O argumento muda o que ela faz a cada vez.
- ✓Você ainda está afinando o processo.
→ Vire script/cron quando
- →Dispara 100% autônoma, sempre igual.
- →Não precisa estar no contexto toda sessão.
- →Você quer economizar tokens e janela de contexto.
Por que aprender
Porque skill não é a resposta para tudo — e tratar tudo como skill encarece o OS. Um processo 100% previsível roda mais barato e confiável como script: não consome contexto, não precisa carregar a cada nova sessão do Claude Code, e não corre o risco de a IA "improvisar".
Conceitos-chave
⚠️ O erro comum: 10 skills de uma vez / skill nunca-feita
A camada de habilidades tem três armadilhas clássicas: gente subutiliza skills, gente acumula skills demais, e gente se acha esperta e cria muitas skills de uma vez — que ficam stale (mortas) sem nunca serem usadas. Some a isso a pior: escrever skill de algo que você nunca fez à mão.
⚠️ O erro a evitar
Sentar num fim de semana e gerar 10 skills "porque parecem úteis". Sem uso real, elas envelhecem, contradizem-se e poluem a pasta skills/. Você passa a confiar em receitas que nunca foram testadas no fogo.
✓ Hábito saudável
- ✓Comece com UMA skill: a tarefa que você mais repete.
- ✓Toda skill nasce de algo já feito à mão.
- ✓Crie a próxima só quando a dor aparecer de novo.
✗ Anti-padrões
- ✗10 skills de uma vez "porque parecem úteis".
- ✗Skill de algo que você nunca executou.
- ✗Acumular receitas que nunca rodam (stale).
Por que aprender
Porque a tentação de "skillar tudo" é forte e cara. Uma pasta enxuta de skills vivas — cada uma nascida de uma dor real e mantida pelo uso — vale mais que uma biblioteca de receitas mortas. Menos, melhor, e sempre a partir do que você já faz.
Conceitos-chave
📝 Copy-run: destile esta conversa num slash command
Hora da mão na massa. Faça uma tarefa à mão com o Claude Code (qualquer uma — categorizar uns arquivos, redigir uma resposta padrão). Ao terminar, cole o prompt abaixo: ele aplica o reverse meta-prompting e materializa a sua primeira skill — um slash command que aceita um argumento.
Copie e rode no Claude Code
Objetivo: destilar a conversa que você acabou de ter num slash command reutilizável que aceita um argumento em linguagem natural.
Cole no fim da sessão (troque o que está entre < >):
Com base em TODA esta conversa, destile o critério exato que eu te dei e materialize-o como um slash command reutilizável. Crie a skill em: skills/<nome-da-skill>/SKILL.md O comando deve: - chamar-se /<nome-da-skill> e ACEITAR UM ARGUMENTO (uma frase em linguagem natural que enriquece o que ele faz); - ter um procedimento operacional padrão (SOP): exatamente o que acontece, em que sequência; - listar, no fim, um "done-check": como eu verifico que deu certo. Antes de escrever o arquivo, me mostre o SOP em bullets e espere meu OK.
Como verificar: rode /<nome-da-skill> "um caso de teste" numa nova sessão. Se o comando reproduz o que você fez à mão e respeita o argumento que você passou, a skill está viva. Confira também que o arquivo skills/<nome-da-skill>/SKILL.md existe e tem o SOP + done-check.
💡 Dica
Note o "espere meu OK" no fim do prompt. Pedir o SOP em bullets antes de gravar o arquivo deixa você corrigir a receita enquanto a conversa ainda está fresca — é o reverse meta-prompting com um portão de revisão embutido.
Por que aprender
Porque é a diferença entre ler sobre skills e ter uma. Ao rodar este prompt você experimenta o ciclo inteiro — manual → captura → V1 — e sai do módulo com um artefato real na pasta skills/ do seu OS.
Conceitos-chave
📄 Anatomia de um SKILL.md
Para fechar, vamos abrir a receita por dentro. Um SKILL.md é só um arquivo de texto (Markdown) com quatro partes que importam: nome, quando usar (o gatilho), o passo a passo (SOP) e como verificar. Saber essa anatomia te deixa ler, depurar e melhorar qualquer skill.
Como ler: de cima para baixo é a ordem de leitura da própria IA: ela vê o nome, decide se o gatilho casa, segue o SOP e confere o done-check. As três do meio são em ciano; o done-check (em roxo) é o que você mais esquece — e o que mais importa.
Esqueleto ilustrativo — um SKILL.md mínimo
--- name: monthly-review description: Revisa o extrato do mês e gera um resumo categorizado. --- ## Quando usar Quando eu pedir a revisão mensal de gastos, ou passar um extrato novo. ## Passo a passo (SOP) 1. Ler o extrato em <arquivo> (argumento). 2. Categorizar cada transação. 3. Apontar gastos fora do padrão. 4. Gerar o resumo em resumo-<mes>.md. ## Done-check - Todas as transações têm categoria. - O resumo lista os 3 maiores gastos do mês.
Por que aprender
Porque a anatomia é a linguagem comum de toda a camada. Quando você lê uma skill (sua ou de outro), procurar essas quatro partes te diz na hora se ela está completa — e o done-check ausente é a falha número um. Com isso, você fecha a Trilha 3.1 pronto para a próxima camada: Ferramentas.
Conceitos-chave
✅ Resumo do módulo
Próximo módulo:
3.2 — Ferramentas & Conexões: os fios pra fora 🔌