O que são as Claude Skills (Agent Skills)? Como funcionam, como criar uma e como diferem do MCP

"Explicar o mesmo procedimento ao Claude vez após vez é cansativo" — se isso soa familiar, as Claude Skills (Agent Skills) são exatamente o mecanismo criado para resolver esse problema. A Anthropic as anunciou em 16 de outubro de 2025 e, em poucos meses, elas se tornaram a forma padrão de dar ao Claude capacidades específicas de domínio no Claude Code e na API.

Este artigo explica o que são as Skills, por que importam e como criar uma — escrito para iniciantes — e vai até as diferenças em relação ao MCP e aos subagentes, com os quais costumam ser confundidas.

1. O que são as Claude Skills (Agent Skills)?

As Claude Skills são uma forma de empacotar "como executar uma tarefa específica" em uma única pasta e entregá-la ao Claude. Dentro da pasta fica um manual chamado SKILL.md, que contém o procedimento, além de scripts de execução e materiais de referência opcionais.

Pense nisso como um manual de integração que você entrega a um novo contratado. "Como gerar um PDF de fatura", "a convenção de mensagens de commit da empresa", "o formato das atas de reunião" — depois que você transforma esses procedimentos fixos em um manual, o Claude pode consultá-lo toda vez e produzir a mesma qualidade. É como acoplar habilidades especializadas a um agente de IA depois do fato.

2. Por que importam: chega de recolar prompts

Até agora, fazer o Claude realizar um trabalho especializado geralmente significava colar um prompt de instruções longo a cada vez. Mas essa abordagem tem fraquezas.

• Baixa reprodutibilidade: ajuste o prompt levemente e o resultado se desvia
• Sobrecarrega o contexto: instruções longas ocupam permanentemente a janela de contexto
• Difícil de compartilhar: é complicado atingir a mesma qualidade em toda a equipe

As Skills substituem isso por um manual dobrável que se abre apenas quando necessário. Na maior parte do tempo, tudo o que o Claude vê é a breve descrição de cada skill (uma ou duas linhas). O procedimento real só se desdobra no momento em que você pede aquela tarefa. Assim, mesmo com dezenas de skills instaladas, seu contexto do dia a dia mal é tocado.

No lançamento, o desenvolvedor Simon Willison disse que elas "talvez sejam algo maior que o MCP" — precisamente por causa dessa leveza e reutilização. Seu conhecimento de engenharia de prompts passa a ser um ativo que você acumula, em vez de algo descartável após cada uso.

3. Como funcionam: SKILL.md e divulgação progressiva

O coração de uma skill é um arquivo chamado SKILL.md. No topo você escreve um name (nome) e uma description (descrição) e, abaixo deles, escreve o procedimento em Markdown comum.

---
name: pdf-filler
description: Preenche formulários PDF a partir de dados. Use quando o usuário quiser preencher um formulário de inscrição ou modelo em PDF.
---

# Preenchendo um formulário PDF

1. Obtenha os nomes dos campos com `pdftk form.pdf dump_data_fields`
2. Mapeie os dados do usuário para esses nomes de campos
3. Grave-os com `pdftk form.pdf fill_form data.fdf output filled.pdf flatten`

Consulte reference/fdf-format.md para detalhes do formato FDF.

O ponto-chave é a description. No início de uma sessão, o Claude lê apenas a description de cada skill. Ele então decide por conta própria se a tarefa que você acabou de pedir combina com aquela descrição e, somente quando combina, carrega o corpo, os scripts e os arquivos de referência. Esse mecanismo de "abrir o que você precisa, quando precisa, em etapas" é chamado de divulgação progressiva.

4. Como criar uma (com um exemplo mínimo)

Há duas formas. (1) Deixar a skill oficial "skill-creator" da Anthropic criá-la para você ou (2) montar a pasta você mesmo. Uma estrutura mínima fica assim.

.claude/skills/
└── pdf-filler/
    ├── SKILL.md          ← obrigatório: nome, descrição, passos
    ├── reference/
    │   └── fdf-format.md ← detalhe extra, lido só quando necessário
    └── scripts/
        └── fill.py       ← código que o Claude pode executar

No Claude Code, basta soltar a pasta no .claude/skills/ do seu projeto (apenas aquele projeto) ou em ~/.claude/skills/ (compartilhado entre todos os projetos) e ela é reconhecida automaticamente. Uma atualização de janeiro de 2026 fez com que pastas adicionadas ou editadas entrem em vigor imediatamente, sem reinicialização, o que torna a experimentação muito mais fácil. A coleção oficial de exemplos está publicada em github.com/anthropics/skills.

Como primeiro passo, a melhor jogada é escolher um "procedimento padrão" que você vive explicando ao Claude e escrevê-lo como um SKILL.md. Comece pequeno — o formato dos posts da sua equipe no Slack, como você escreve notas de versão — e você pega o jeito rapidamente.

5. Skills vs. MCP vs. subagentes

As Skills não são a única forma de estender o Claude. Vamos organizar, por função, como elas diferem do MCP e dos subagentes, com os quais são frequentemente confundidas. Os três não são concorrentes — eles ficam em camadas diferentes.

Uma regra prática simples: se o pedido envolve "buscar, consultar, estado atual", você quer MCP. Se for "faça do nosso jeito de sempre", você quer uma Skill. Se for "entregue a uma unidade separada para rodar em paralelo", você quer um subagente. E, na prática, você combina os três (por exemplo, um subagente busca dados via MCP e depois os transforma em um relatório usando o procedimento de uma Skill).

6. Onde funcionam: um padrão aberto

As Skills não são um recurso preso a um único produto — elas foram publicadas como um padrão aberto. Desde que você siga o formato compartilhado do SKILL.md, a mesma skill roda em várias ferramentas.

Em outras palavras, uma skill que você escreve uma vez pode ser reutilizada em agentes além do Claude. A mesma mudança que tornou o MCP o padrão comum para conexões de ferramentas está acontecendo agora também no mundo dos "procedimentos de trabalho". Quanto mais você faz malabarismo com várias ferramentas de programação, maior o retorno.

7. Para que usar? Exemplos reais

É difícil imaginar no abstrato, então aqui vão alguns usos comuns.

• Geração de documentos: produzir arquivos Word, PowerPoint, PDF e Excel conforme seus próprios modelos (também incluído nos exemplos oficiais)
• Imposição de regras internas: aplicar convenções de mensagens de commit, checklists de revisão de código e regras de nomenclatura toda vez
• Relatórios rotineiros: resumos semanais de vendas, atas de reunião e notas de versão no mesmo formato
• Fluxos de trabalho especializados: validação de dados, como chamar uma API específica, passos para montar um gráfico ou diagrama

O suporte do lado de terceiros também está crescendo: Box, Canva e Notion oferecem suas próprias operações como skills. No contexto da eficiência empresarial, a ideia de "transformar o trabalho que você faz com frequência em uma skill, como um ativo reutilizável" está a caminho de se tornar a norma.

Resumo

As Claude Skills (Agent Skills) são uma forma de empacotar "como executar uma tarefa específica" em uma pasta e entregá-la ao Claude. Vamos reduzir isso a três pontos.

• O que é: uma pasta centrada no SKILL.md (nome, descrição, passos). Muito parecida com um manual de integração para um novo contratado
• Por que é inteligente: normalmente, apenas a descrição; o corpo expande quando uma tarefa combina — a "divulgação progressiva" que economiza contexto
• Até onde alcança: como padrão aberto, é reutilizável em agentes além do Claude e se combina com MCP e subagentes

Comece escrevendo como um SKILL.md um procedimento que você vive explicando ao Claude. Depois de criá-lo, aquela tarefa se torna um "ativo" que dispensa novas explicações. Se você quiser se aprofundar na mecânica, veja também nossos textos sobre MCP e engenharia de harness. Outra nova forma de saída do Claude Code, ao lado das Skills, é o Claude Code Artifacts, que transforma uma sessão de programação em uma página ao vivo que você pode compartilhar.

FAQ