Claude Skills: pare de reensinar a mesma tarefa

A primeira vez que eu escrevi uma Claude Skill foi de puro saco cheio. Eu tinha colado os mesmos três parágrafos de "é assim que a gente formata uma release note" numa conversa pela quarta vez naquele mês. Uma Skill é a solução exata pra essa sensação: você escreve as instruções uma vez só, e o Claude carrega elas sozinho quando a tarefa aparece.

O que uma Skill é de verdade

Tirando toda a embalagem, uma Skill é só uma pasta com um arquivo SKILL.md dentro. O arquivo tem um cabeçalho curto — um nome e uma descrição de quando usar — seguido das instruções, de exemplos e de scripts que a tarefa precisar. O Claude lê a descrição, decide que a tarefa bate e só então puxa o resto. Essa última parte é o ponto: você não está inchando toda conversa com instruções que raramente precisa. Elas ficam dormindo até serem relevantes.

A descrição é o jogo inteiro. Se ela for vaga, o Claude nunca vai buscar a Skill na hora certa. Escreva ela como você faria o briefing de alguém recém-contratado — "use isso quando pedirem pra fazer X" — um gatilho concreto, não um rótulo de assunto. O repositório oficial de Agent Skills da Anthropic está cheio de exemplos que funcionam — abra um e copie o formato antes de escrever a sua.

Quando vale a pena

Minha regra de bolso: escreva uma Skill na terceira vez que você explicar a mesma coisa. Uma vez é acaso, duas é coincidência, três é padrão — e padrão é o que se codifica. Bons candidatos têm um formato fixo e uma entrada variável: formatar um documento pro padrão da casa, transformar uma exportação de dados num relatório padronizado, rodar um checklist antes de subir algo.

Como uma Skill se parece

Aqui está uma Skill inteira — a das release notes que começou tudo. A description é o gatilho; o corpo é aquilo que você para de redigitar:

---
name: release-notes
description: Use when someone asks to write or format a release note,
  changelog entry, or "what shipped" update from a list of merged changes.
---

Turn the raw change list into a release note in our house style.
Group items under Added / Fixed / Changed, one plain-language line each
(what the user notices, not the commit message). Lead with the biggest
change. End with an upgrade note only if something breaks.

O que uma Skill não é

Uma Skill não é um depósito de tudo que você sabe. Problemas genuinamente novos, que acontecem uma vez só, não entram numa — você gastaria mais tempo mantendo a Skill do que fazendo o trabalho. Reserve elas pros serviços chatos e repetitivos que drenam alguns minutos toda semana sem você perceber.

Essa semana

Abra o seu histórico de conversas e ache a instrução que você mais colou. Aquele parágrafo é a sua primeira Skill. Passe ele pra um SKILL.md, escreva uma descrição afiada de uma linha sobre quando ele se aplica, e nunca mais digite aquilo na mão.

Fontes

• Anthropic — Agent Skills repository
• Anthropic — skill-creator SKILL.md