Toda semana alguém me pergunta o que são essas tais "skills" que eu vivo comentando. A resposta curta: é a forma mais simples de ensinar um truque novo pra uma IA — e fazer ela repetir aquilo igualzinho, sempre. Eu uso skills todo dia no Claude Code, desde o jeito que escrevo um commit até como reviso segurança de PHP. Sem enrolação: aqui vai o que são, pra que servem, o que é o tal SKILL.md e como criar a sua — e no fim deixo 4 skills prontas pra baixar.
O que são Skills de IA
Pensa numa skill como uma receita que você entrega pra IA: um conjunto de instruções (e, se quiser, scripts e arquivos de apoio) que ensina o modelo a fazer uma tarefa específica do seu jeito. Em vez de explicar tudo de novo a cada conversa, você guarda esse conhecimento uma vez — e a IA puxa sozinha quando a tarefa aparece.
As Agent Skills são um padrão aberto da Anthropic (a empresa do Claude). O bom: a mesma skill funciona no Claude do navegador, no Claude Code (terminal) e via API. E é só texto — nada de instalar SDK ou framework.
Pra que servem (na prática)
- Padronizar: a IA passa a seguir o seu padrão (de commit, de revisão, de tom de texto) sem você repetir.
- Economizar tempo e contexto: o conhecimento fica guardado; você não cola as mesmas instruções toda santa vez.
- Compartilhar: dá pra versionar no Git e passar pra equipe — todo mundo ganha o mesmo "especialista" embutido.
- Compor: várias skills pequenas e focadas valem mais que um prompt gigante e confuso.
O que é o arquivo SKILL.md
Toda skill é uma pasta com, no mínimo, um arquivo chamado SKILL.md. Ele tem duas partes:
- Um frontmatter YAML no topo (entre
---) com dois campos obrigatórios:name— o identificador, em minúsculas com hifens (ex.:commit-craft);description— o que a skill faz e quando usá-la. É por essa frase que o modelo decide sozinho acionar a skill.
- O corpo em Markdown: as instruções em si — o passo a passo que a IA deve seguir.
Exemplo mínimo de um SKILL.md:
---
name: commit-craft
description: Use ao escrever mensagens de commit a partir de um diff.
---
# Commit Craft
Você escreve mensagens de commit no padrão Conventional Commits...A dica de ouro: capriche na description. É ela que faz o modelo lembrar de usar a skill na hora certa. Descrição vaga = skill que nunca dispara.
Como criar a sua skill, passo a passo
- Crie uma pasta com o nome da skill (ex.:
commit-craft/). - Dentro, crie o
SKILL.mdcom o frontmatter (name,description) e o corpo com as instruções. - (Opcional) Junte scripts, exemplos ou arquivos de referência na mesma pasta — a IA pode executá-los ou consultá-los.
- Mantenha o
SKILL.mdenxuto (a Anthropic recomenda abaixo de ~500 linhas). Skill focada > skill que tenta fazer tudo. - Instale: no Claude Code, jogue a pasta em
~/.claude/skills/(ou no diretório de skills do projeto). Pronto — o Claude passa a considerar a skill quando adescriptioncasar com a tarefa.
No Claude Code também dá pra instalar skills oficiais pelo marketplace de plugins da Anthropic (anthropics/skills), que se atualizam sozinhas. Mas a graça mesmo é criar as suas, com o seu jeito de trabalhar.
O pulo do gato: 4 skills prontas pra baixar
Pra você não começar do zero, deixei 4 skills genéricas e úteis (em português). Baixe, descompacte a pasta dentro de ~/.claude/skills/ e use hoje:
Baixar as 4 de uma vez (pacote)
Cada .zip contém a pasta da skill com o SKILL.md. Abra e leia — é texto puro, dá pra adaptar ao seu gosto em 2 minutos.
Em resumo
Skill = uma pasta + um SKILL.md com name, description e instruções. É a maneira mais limpa de transformar o "jeito que você faz" em algo que a IA repete sozinha, sempre igual. Comece com uma dessas 4, edite, e logo você vai ter um time de especialistas de bolso.
Quero automatizar o meu jeito de trabalhar
Eu faço exatamente isso pra negócios: tiro a tarefa repetitiva da frente das pessoas — com IA, automação e código sob medida. Se isso faz sentido pro seu caso, bora conversar.