Pular para o conteúdo
Pathrule

skills

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.

Claude Codeexemplo
Reproduza localmente o pagamento que falhou ontem.

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.

  1. 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.”

  2. Semana 2você, para o codex

    “Primeiro a versão. Depois as duas marcas, não só uma.”

  3. Semana 3você, para o claude code

    “Você criou a tag antes do upload. De novo.”

  4. 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.

SKILL.md
---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
prompt“Reproduza o pagamento que falhou ontem”
  • “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.

Uma skill. Todo caminho que precisa dela.

replay-stripe-webhook

Escrita uma vez, no nível do espaço de trabalho. Vinculada onde quer que a tarefa aconteça, nunca copiada.

  • /services/billingvinculada
  • /services/webhooksvinculada
  • /apps/admin/paymentsvinculada
  • /apps/mobilenão aqui
chega a
  • Claude Code.claude/skills
  • Codex.agents/skills
  • Cursor, Copilot, Windsurfvia MCP
manual
Escrita no Pathrule
template
Um modelo inicial, copiado para cá
github_ref
Buscada e depois mantida em cache

O colega que entrar no mês que vem recebe a skill sem que ninguém precise avisar que ela existe. Skills desatualizadas ou conflitantes aparecem como sugestões, e uma pessoa aprova a correção.

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.

Escreva os passos uma vez.
Depois, dê nome à tarefa.