Dê nome à tarefa.
Não aos passos.
Skills reutilizáveis para agentes de programação com IA: procedimentos com nome que o agente invoca em vez de deduzir os passos de novo, para que o quarto passo pare de sumir.
Sem
Encontrei o evento, iniciei o servidor e enviei o payload para o webhook.
Webhook rejeitado: a verificação de assinatura falhou.3 de 5 passos
Com a skill
skill replay-stripe-webhook
- Buscou o evento pelo id
- Carregou o segredo de assinatura local
- Iniciou o servidor com os webhooks ativados
- Reenviou com uma nova chave de idempotência
- Conferiu o log do handler
O handler retornou 200.5 de 5 passos
Os mesmos passos. Toda semana.
- Semana 1você, para o claude code
“Suba a versão, gere o build das duas marcas, faça o upload e depois crie a tag.”
- Semana 2você, para o codex
“Primeiro a versão. Depois as duas marcas, não só uma.”
- Semana 3você, para o claude code
“Você criou a tag antes do upload. De novo.”
- Semana 4você, para qualquer agente
::release-mobile
3 explicações1 skill0 passos esquecidos desde então
O sinal não é a complexidade, e sim você se repetir. Acima de três passos, ou com qualquer ordem obrigatória, deve ser uma skill. Abaixo disso, uma memória dá conta.
A descrição faz o trabalho.
---name: replay-stripe-webhookdescription: Reenvia um evento de pagamento de produção para o servidor local.---# Reenviar um webhook do Stripe1. Buscar o evento pelo id2. Carregar o segredo de assinatura local3. Reenviar com uma nova chave de idempotência
- “Helpers do Stripe”stripe-helpersignorada
- “Reenvia um evento de pagamento de produção para o servidor local”replay-stripe-webhookinvocada
Uma skill que o agente nunca invoca geralmente é um problema de descrição. Nomeie o gatilho, não o assunto, ou o plano do próprio agente vence.
Perguntas frequentes.
O que é uma skill para agentes de IA?
Um procedimento reutilizável e com nome que um agente de programação com IA pode invocar em vez de deduzir os passos de novo: reproduzir localmente um webhook do Stripe, regenerar as fixtures de seed, rodar o checklist de pré-release. O corpo é um pequeno arquivo Markdown cujo frontmatter dá nome à skill e descreve para que ela serve.
Quando algo deve ser uma skill, e não uma memória?
Quando é uma sequência e a ordem importa. Recorra a uma skill quando houver mais de três passos, ou sempre que alguma parte exigir “faça nesta ordem”. Uma ou duas linhas, ou um fato que o agente só precisa saber em vez de executar, é uma memória.
Por que meu agente não usa a skill que eu escrevi?
Na maioria das vezes, a descrição não diz para que a skill serve. As skills são selecionadas pela descrição, então uma descrição vaga perde para o plano padrão do próprio agente: nomeie o gatilho, e não o assunto. As outras causas comuns são um escopo que nunca corresponde aos caminhos onde o trabalho acontece e um procedimento que ainda tem uma decisão de verdade no meio. Leitura longa: por que as skills do Claude Code não são ativadas.
Dá para compartilhar uma skill com a equipe?
Sim, e esse é o motivo de guardá-la fora de um prompt. As skills ficam no nível do espaço de trabalho e são vinculadas aos nós por meio de um join, então uma skill é reutilizada em muitos caminhos, e o agente de cada colega pode invocá-la. A participação na organização e o acesso ao espaço de trabalho são controlados no servidor. Veja funções e permissões.
Posso usar skills publicadas por outras pessoas?
Sim. Uma skill pode ter como fonte uma URL externa do GitHub, e o Pathrule busca o corpo e o mantém em cache. A cópia em cache é o último snapshot servido, e o espaço de trabalho recebe as mudanças upstream na próxima atualização. Use isso para skills publicadas por um ecossistema em que você confia.
Qual é a diferença entre uma skill e um padrão do Pathrule?
Uma skill é um procedimento. Um padrão é um pequeno pacote de memórias, regras e skills para um tema, com cada peça já vinculada ao caminho a que pertence, porque uma convenção real raramente cabe em um arquivo só. Leitura longa: o que é um padrão do Pathrule, e por que ele não é uma skill.
As skills substituem meus prompts?
Não, elas tiram a repetição deles. Vale escrever uma skill quando você percebe que está explicando de novo o mesmo procedimento. O prompt passa a dar nome ao trabalho em vez de descrevê-lo, e os passos param de variar de uma explicação para a outra.