5 skills para Claude Code testadas em um projeto real

O que muda na prática

1. 01Skill é um arquivo com instruções

   Na documentação do Claude Code, uma skill é um arquivo chamado skill.md com instruções. O agente adiciona essas instruções ao repertório e as usa quando for relevante, e você também pode invocá-las diretamente pelo nome. Um detalhe importante: o corpo da skill só é carregado quando ela é usada, então uma instrução longa quase não ocupa espaço parada. No repositório elas aparecem em dois tipos, as que só funcionam quando você digita o nome e as que o próprio agente invoca quando a tarefa pede.

2. 02A armadilha da instalação

   O comando que está no texto do repositório instala o pacote pelo catálogo oficial de plugins, e o texto diz que ele se atualiza automaticamente. Mas o catálogo não acompanha o repositório: quando o autor preparou o vídeo, ele apontava para a versão 1.2.3. Numa instalação limpa, o comando nem encontrou o pacote porque o catálogo não estava registrado. O caminho que funcionou foi adicionar o próprio repositório como catálogo e instalar o pacote a partir dali, em dois comandos. A versão 1.3.1 chegou com as habilidades novas na pasta.

3. 03O interrogatório antes do código

   É a segunda mais instalada e a versão mais completa da família. Antes de escrever qualquer código, o agente faz perguntas em rodadas, numera cada uma e traz uma resposta recomendada para você confirmar ou corrigir. A regra da skill é que descobrir fatos é trabalho do agente e as decisões cabem a você. A versão com documentação monta um glossário do projeto durante a conversa. No teste, foram três rodadas e 18 perguntas, um glossário com sete termos e a especificação dividida em cinco tarefas. O autor respondeu sim a todas as recomendações, inclusive quando o agente perguntou se podia transformar a conversa em tarefas e se podia começar a implementar, e em poucos minutos o agente implementou as cinco tarefas numa única sessão. Ele descartou esse código.

4. 04Teste antes do código

   É a quarta mais instalada, também com mais de 1 milhão de instalações. O ciclo é escrever um teste que falha e depois o código suficiente para ele passar: vermelho, então verde. Antes do primeiro teste, o agente combina com você em que pontos os testes ficam. Um bom teste verifica o comportamento pela interface pública, não pelos detalhes internos, e a skill também lista o que evitar, como o teste que recalcula o resultado do mesmo jeito que o código. No teste do erro de maiúscula, o caso tinha 10 com M maiúsculo e cinco em minúsculo, esperando 15 em uma única categoria. O teste falhou, veio a correção mínima e os três testes, tudo em 36 segundos. Desta vez ele não parou para combinar o ponto de teste antes.

5. 05A especificação inteira de uma vez

   É a mais instalada das três habilidades novas da versão 1.3. Ela lê as tarefas como um gráfico de dependências e manda cada uma para um subagente, numa cópia de trabalho separada. Cada subagente implementa com a skill de testes, e o trabalho é reunido numa branch de integração. No fim, uma revisão de código passa pela branch. O próprio autor diz que isso é pior do que um loop feito por script, mas é uma boa forma de deixar o agente trabalhando enquanto você está longe do teclado. No teste restavam quatro tarefas: dois subagentes em paralelo e depois mais dois. A revisão achou um erro real de arredondamento, e a correção passou a comparar tudo em centavos. Foram 8 minutos e 57 segundos, com 23 testes no fim.

6. 06A retrospectiva da sessão

   É a segunda das habilidades novas e, segundo o autor, a que ele viu explodir nas redes sociais. Ela não altera o código: analisa uma sessão que já aconteceu e sugere melhorias no ambiente de trabalho em sete categorias. Se o erro for mecânico, a preferência é criar uma verificação automática antes de escrever uma regra. No fim vem uma lista do mais sério para o menos grave. No teste ela rodou na própria sessão da implementação e apontou seis pontos. O primeiro foi o defeito dos centavos: os subagentes escreveram os testes só com valores inteiros porque nada no projeto dizia como comparar valores monetários. O autor não recomenda automatizar, porque o agente entra num loop de falsos positivos.

7. 07Arquitetura e o módulo profundo

   É a terceira mais instalada do repositório e parte de um problema: como aceleramos a escrita de código, também aceleramos a desordem. A skill percorre o projeto atrás de módulos que podem ser mais profundos, ou seja, que dão acesso a muita funcionalidade por uma interface simples. Ela começa pelo histórico de alterações e entrega uma página visual salva fora do projeto com cada candidato. Depois pergunta qual você quer explorar e só então entra no interrogatório. No teste a página veio com quatro candidatos, e o mais forte era o arquivo do terminal, que só dá para testar abrindo um processo novo. O autor é honesto quanto às limitações: em um projeto antigo, encontrar candidatos não resolve o desastre.

Nas palavras dele

Perguntas

Continue por aqui

• O que mudou no Claude: 12 novidades e o plano de cada uma
• Diagram Design e Archify: qual skill de diagrama usar
• Como transformar um livro em skill do Claude Code