LG Salles

IA, vendas, marketing e desenvolvimento

Desenvolvimento

Como usar skills Claude Code: teste antes de acumular

19 de novembro de 2026

Vídeo de David Ondrej · Título original: “Matt Pocock’s Agentic Engineering Workflow (just copy him)”Inscreva-se no canal

Por que isso importa

Instalar uma coleção de skills leva minutos. Descobrir se ela ajuda no seu projeto exige um critério melhor que a qualidade aparente da resposta. O agente pode produzir um plano bonito, escrever mais código e deixar você com mais trabalho para conferir. Minha régua seria outra: quanto esforço humano sobra até aquela mudança estar pronta para entrar no produto?

Na conversa com David Ondrej, Matt Pocock defende procedimentos pequenos, fundamentos de engenharia e controle humano sobre as decisões. A provocação mais útil é começar com menos configuração e observar o comportamento do agente. Eu levaria essa ideia para um experimento reversível: comparar o mesmo trabalho com e sem uma skill, mantendo o restante constante. O roteiro abaixo transforma essa proposta em algo que cabe no cotidiano de quem desenvolve software.

Pontos principais

  • 00:32 A distinção entre programação tática e estratégica desloca a atenção para escopo, interfaces e manutenção. As afirmações sobre ganhos enormes de produtividade são opiniões dos participantes; não vêm acompanhadas de uma medição que permita generalizar esses resultados.
  • 06:08 A skill teach aplica princípios de ensino a uma missão concreta. O ponto interessante é avaliar se a pessoa consegue executar uma tarefa depois da aula, além de achar a explicação convincente.
  • 11:38 O histórico de aprendizagem fica em arquivos locais. Essa memória torna o processo inspecionável: é possível conferir o que foi registrado como aprendido e corrigir uma avaliação prematura.
  • 18:19 O grill-me conduz uma entrevista para esclarecer uma ideia. Seu valor está nas decisões que a conversa resolve; uma entrevista longa pode consumir tempo sem reduzir a incerteza relevante.
  • 25:06 Sandcastle aparece como parte da execução de agentes em ambientes isolados. A separação de ambientes permite delegar tarefas com limites, mas o isolamento depende da configuração de arquivos, credenciais e acesso externo.
  • 27:55 Pocock destaca o ambiente ao redor do modelo, chamado de *harness*. Instruções, ferramentas, permissões e mecanismos de verificação também influenciam o resultado e estão mais diretamente sob controle do desenvolvedor.
  • 32:19 Uma base mais fácil de modificar pode reduzir exploração e tentativas frustradas. A possível economia com modelos mais baratos é uma hipótese a testar no próprio repositório.
  • 45:04 A fila de tarefas organiza o trabalho fora do teclado. Cada item precisa de um resultado verificável e de uma condição de encerramento para que a automação produza entregas delimitadas.
  • 51:07 Revisar também serve para entender como o sistema de desenvolvimento está funcionando. Uma correção recorrente pode indicar uma instrução ruim, uma interface confusa ou uma verificação ausente.
  • 1:00:33 A recomendação final é reduzir a configuração e reintroduzir recursos conforme apareçam necessidades. Eu aplicaria essa limpeza em um ambiente de experimento, preservando a configuração original para comparação.

Como aplicar

Como usar skills Claude Code com uma referência de comparação

Escolha um repositório conhecido e uma mudança pequena. Por exemplo: corrigir uma exportação CSV que interpreta valores monetários brasileiros de forma errada. Defina previamente o comportamento esperado para 1.234,56, campos vazios e valores negativos. Isso permite avaliar a entrega por exemplos concretos.

Prepare duas cópias descartáveis do mesmo estado do projeto. Uma usará a configuração mínima; a outra receberá o procedimento avaliado. Preserve os limites de acesso e as regras obrigatórias da equipe em ambas. Remover instruções opcionais deve ser uma mudança identificável, com caminho de volta.

Registre modelo, versão do agente, instruções carregadas e comandos de verificação. Use sessões novas, sem levar respostas de uma tentativa para a seguinte. Quando possível, fixe a versão das skills: uma atualização no meio da comparação muda o objeto do teste.

Instale um procedimento com uma função clara

Para explorar uma ideia ainda vaga, a documentação atual do grill-me apresenta este comando, que inclui sua dependência grilling:

npx skills@latest add mattpocock/skills --skill=grill-me --skill=grilling

Depois, invoque /grill-me em uma conversa nova. Essa é a instalação documentada atualmente; o catálogo evoluiu desde a gravação de junho. Confira as instruções na página oficial do procedimento.

Dê à entrevista uma pergunta real: “Precisamos permitir exportar todos os clientes ou apenas os resultados filtrados?”. Responda com contexto de uso e registre a decisão ao terminar. Se a dúvida depender de ver uma tela funcionando, faça um protótipo curto. Continuar conversando não resolve toda incerteza de interface.

Se o obstáculo for conhecimento, separe o aprendizado da implementação. O teach mantém missão, aulas e registros em um diretório próprio; sua documentação recomenda um espaço dedicado ao assunto. Uma missão útil seria aprender a diagnosticar falhas de autorização no projeto, com um exercício que você consiga repetir sem ajuda. Veja a documentação do teach.

Compare entregas usando a mesma régua

Minha proposta é começar com três tarefas representativas: uma correção, uma pequena funcionalidade e uma alteração interna. Execute cada uma com e sem o procedimento adequado. Sempre restaure o estado inicial antes da próxima tentativa. Repita quando houver uma diferença surpreendente e alterne a ordem das configurações para reduzir o efeito do seu próprio aprendizado.

Use uma ficha simples:

| Medida | O que registrar | |---|---| | Aceitação | Quais exemplos definidos antes da execução passaram | | Intervenção | Quantas vezes foi preciso corrigir o entendimento | | Revisão | Minutos gastos conferindo e ajustando a entrega | | Escopo | Mudanças desnecessárias fora da tarefa | | Consumo | Custo informado, tokens disponíveis e tempo de execução |

Uma assinatura com limite de uso continua tendo um custo de capacidade. Quando não houver cobrança por tarefa, registre o consumo disponível sem inventar uma conversão precisa para reais.

Considere a entrevista, a execução e a revisão no tempo total. Uma skill que acrescenta dez minutos de conversa pode compensar se evitar meia hora de retrabalho. Também pode piorar uma tarefa que já estava completamente especificada.

Dê uma saída definida ao trabalho fora do teclado

Antes de delegar, escreva o que deve mudar, o que fica fora do escopo, como verificar o resultado e quando o agente deve parar. Para o CSV, a entrega poderia conter a correção, exemplos automatizados dos formatos combinados e uma amostra gerada com dados fictícios.

Acrescente um limite de tempo ou consumo compatível com a ferramenta utilizada. Se o agente não conseguir reproduzir o problema ou precisar mudar o contrato da exportação, peça que devolva o diagnóstico e a decisão pendente. Esse retorno também é uma entrega útil.

Mantenha cada skill por um motivo observável

Depois do piloto, associe cada procedimento mantido a um problema concreto: esclarecer escopo, melhorar a verificação ou reduzir ajustes na revisão. Se a melhora não aparecer de forma consistente, retire a skill da configuração experimental e teste novamente quando surgir uma necessidade diferente.

Eu adotaria uma regra simples: todo acréscimo à configuração precisa justificar o trabalho que cria para quem revisa. O resultado procurado é uma mudança correta, compreensível e mais fácil de manter — acompanhada de evidências suficientes para decidir seu destino.

Recursos citados

  • Matt Pocock Skills · Repositório oficial; inclui teach, grill-me e outros procedimentos. O catálogo mudou desde a gravação.
  • Sandcastle · Biblioteca para executar agentes em ambientes isolados; modelos e infraestrutura podem gerar custos.
  • Claude Code (pago) · Ferramenta utilizada no fluxo demonstrado; acesso e cobrança dependem da modalidade contratada.
  • AI Hero — Skills · Documentação e catálogo do autor; oferece também curso por e-mail mediante cadastro.
  • A Philosophy of Software Design (pago) · Livro de John Ousterhout citado na discussão sobre programação estratégica; página oficial do autor.
  • Pro Git · Livro indicado na demonstração do teach; leitura online gratuita, com tradução para pt-BR.
  • Wispr Flow (pago) · Ditado usado por Matt; oferece modalidade gratuita e planos pagos.
  • Superpowers · Coleção apresentada como contraste à preferência de Matt por procedimentos acionados pelo usuário.
  • Ralph — artigo original de Geoffrey Huntley · Referência discutida no trecho sobre loops e trabalho fora do teclado; a execução dos agentes pode gerar custos.