Claude Skills: como criar uma habilidade simples para automatizar tarefas

Se você repete o mesmo processo no Claude — como organizar notas, revisar um texto ou preparar um resumo — pode transformar suas instruções em uma skill (habilidade). Uma skill é um conjunto de instruções e, opcionalmente, arquivos de apoio ou scripts que ajuda o assistente a seguir um procedimento. Ela não treina o modelo nem altera seus parâmetros: fornece contexto reutilizável para tarefas específicas.

A Anthropic descreve skills como pastas que contêm um arquivo SKILL.md e podem incluir recursos adicionais. O Claude carrega primeiro o nome e a descrição e consulta as instruções completas quando a skill parece relevante. Essa organização, chamada divulgação progressiva, permite manter informações detalhadas fora do contexto até que sejam necessárias. Os recursos disponíveis variam conforme o produto e a configuração usada.

Quando vale a pena criar uma skill?

Uma boa candidata é uma tarefa recorrente, com entrada e resultado relativamente previsíveis. Por exemplo: transformar anotações de reunião em decisões, tarefas e dúvidas. Se cada pedido depende de regras completamente diferentes, talvez seja mais simples escrever as instruções no próprio chat.

Antes de criar arquivos, faça a tarefa uma vez e anote quais instruções realmente mudaram o resultado. Em seguida, defina o que a skill deve fazer, quando deve ser usada e o que ela não pode presumir. Isso evita uma skill genérica que promete resolver qualquer problema.

Exemplo mínimo de SKILL.md

Este exemplo organiza notas de reunião. Salve o texto abaixo como SKILL.md dentro de uma pasta chamada resumo-de-reuniao. Ele é um modelo didático; não foi executado ou testado dentro de uma conta Claude.

---
name: resumo-de-reuniao
description: Organiza notas de reunião em decisões, tarefas e dúvidas. Use quando a pessoa fornecer notas e pedir um resumo estruturado.
---

# Resumo de reunião

Use somente informações presentes nas notas fornecidas.

Entregue estas seções:
1. Resumo em até cinco tópicos
2. Decisões tomadas
3. Tarefas, com responsável e prazo apenas quando informados
4. Dúvidas ou pontos pendentes

Não invente nomes, prazos ou decisões. Quando um dado não estiver nas notas, escreva "não informado". Se as notas estiverem ambíguas, destaque a dúvida em vez de concluir por conta própria.

Os campos name e description ficam no cabeçalho YAML. A descrição ajuda o Claude a reconhecer quando aquela skill se aplica. O corpo contém as instruções. Use um nome curto, único e fácil de identificar.

Como testar antes de confiar

Separe três exemplos: uma reunião simples, uma com tarefa sem responsável e outra com informação ambígua. Use dados fictícios ou autorizados.
Compare com uma lista fixa: o resumo preservou as decisões? Inventou algum prazo? Marcou o que estava ausente?
Corrija a instrução: se o Claude inferiu um responsável, acrescente uma regra explícita para não inferir.
Repita os mesmos exemplos: mantenha as entradas iguais para perceber se a alteração melhorou o resultado.
Revise cada saída: uma skill orienta o modelo, mas não garante que ele sempre siga o procedimento corretamente.

Exemplo de nota fictícia: “Decidimos testar a nova página na terça. Ana vai preparar a versão inicial. Ainda não definimos quem aprova.” Um resultado adequado lista a tarefa de Ana, registra a terça como prazo somente se o contexto deixar claro a que tarefa ela se refere e mantém a aprovação como pendência. Se houver dúvida, a skill deve sinalizá-la.

O que as oito boas práticas significam na prática

Comece com uma tarefa observada: registre o processo que você realmente executa, em vez de imaginar requisitos.
Prefira um objetivo por skill: resumir reunião é diferente de enviar convites ou tomar decisões.
Use exemplos como testes: entradas e saídas demonstram o formato esperado, mas precisam cobrir também casos incompletos.
Divida instruções longas: deixe no arquivo principal as regras essenciais e consulte materiais adicionais quando fizer sentido.
Melhore por ciclos: mantenha uma cópia da versão anterior e altere uma regra de cada vez.
Controle ações externas: para enviar mensagens, alterar arquivos ou executar scripts, exija autorização e revisão apropriadas.
Escolha como a skill será ativada: alguns produtos podem selecionar skills automaticamente; confira a configuração da sua experiência antes de depender desse comportamento.
Reavalie periodicamente: atualize exemplos e instruções quando o processo ou a ferramenta mudar.

Cuidados de segurança

Skills podem incluir código e ampliar o que um agente faz. A Anthropic recomenda instalar skills apenas de fontes confiáveis e revisar os arquivos antes de usar uma skill de terceiros. Confira scripts, dependências, instruções de rede e qualquer pedido de acesso a dados. Para começar, use uma skill de texto que não execute ações nem acesse informações confidenciais.

Também não coloque senhas, chaves de API ou dados pessoais desnecessários dentro dos arquivos. Uma skill é uma forma de organizar instruções, não um cofre de segredos nem uma garantia de privacidade.

Conclusão

Uma skill útil é pequena, específica e fácil de avaliar. Documente um processo repetido, escreva regras claras, teste com exemplos e mantenha a revisão humana onde erros possam causar impacto. O ganho vem de reduzir instruções repetidas, não de presumir que o Claude executará todas as etapas sem supervisão.

Fontes oficiais

Anthropic — Introducing Agent Skills: apresentação das skills e dos produtos em que podem ser usadas.
Anthropic Engineering — Equipping agents for the real world with Agent Skills: estrutura do SKILL.md, divulgação progressiva, avaliação e segurança.

Vídeo de referência

O vídeo serviu como referência para o tema. O exemplo e as recomendações deste artigo foram reestruturados com base na documentação oficial da Anthropic. Assistir ao vídeo original no YouTube.