Anthropic explica como criar skills para o Claude Code e por que equipes precisam de um marketplace próprio

A Anthropic publicou um guia detalhado sobre skills para o Claude Code: extensões que ajudam o agente a trabalhar melhor com código, dados e processos internos. A empresa afirma que já usa centenas dessas skills e descobriu na prática quais realmente melhoram a qualidade do trabalho e quais apenas incham o contexto.

Quais skills funcionam

A tese principal do guia: uma skill não é só um arquivo markdown com instruções, mas uma pasta completa com configurações, scripts, templates, dados e até hooks. Por isso, a Anthropic aconselha definir primeiro o tipo de skill e só depois escrever seu conteúdo.

Segundo a empresa, as melhores skills costumam resolver uma única tarefa clara. As que tentam ser ao mesmo tempo referência, piloto automático, runbook e gerador de código costumam confundir o modelo mais do que ajudá-lo.

• Referências de APIs, SDKs e bibliotecas internas
• Skills para verificar o produto via navegador, CLI e assertions
• Ferramentas para análise de dados, métricas e monitoramento
• Templates para scaffolding, testes e code review
• Skills para CI/CD, runbooks e operações de infraestrutura

A Anthropic destaca separadamente as skills de verificação e as operacionais. No primeiro caso, o agente não apenas escreve código: ele mesmo executa o cenário, confere as etapas e registra o resultado. No segundo, recebe salvaguardas para ações sensíveis, como limpeza de recursos, deploy ou triagem de alertas. Essas skills são especialmente valiosas onde o erro custa caro: em produção, pagamentos, onboarding e plataformas internas. É nesses cenários que fica mais claro se a skill transforma o modelo em uma ferramenta de trabalho confiável.

Como escrever uma skill

A Anthropic recomenda não gastar espaço com o óbvio, o que o Claude já sabe sobre código e práticas comuns. É bem mais útil reunir na skill uma seção com "armadilhas" reais: falhas típicas, casos extremos não triviais e regras locais da equipe.

Outro princípio importante é a revelação progressiva do contexto por meio do sistema de arquivos. Detalhes da API podem ir para references, templates para assets e lógica repetível para scripts. Assim, o modelo lê apenas o que precisa para a etapa atual.

"A melhor forma de entender skills é começar, experimentar e ver o que

funciona para você."

Os autores também recomendam planejar antes a configuração inicial: por exemplo, guardar parâmetros em config.json e fazer perguntas estruturadas ao usuário se a configuração estiver vazia. O campo description deve ser escrito não como um resumo de marketing, mas como a condição de ativação para o próprio modelo. Para memória, é possível usar logs, JSON ou SQLite, mas dados persistentes é melhor manter em um diretório estável, como `${CLAUDE_PLUGIN_DATA}`.

A Anthropic também defende guardar código e bibliotecas auxiliares dentro das skills, em vez de obrigar o modelo a reinventar o boilerplate toda vez. Para facilitar isso, a empresa chegou a lançar o Skill Creator.

Como compartilhar dentro da equipe

Para distribuir skills, a Anthropic descreve dois cenários básicos: mantê-las diretamente no repositório do projeto ou empacotá-las como plugins para o marketplace do Claude Code. O primeiro é conveniente para equipes pequenas e alguns repositórios, mas tem um custo: cada skill commitada adiciona contexto ao modelo. Quando as skills se multiplicam, faz mais sentido movê-las para um catálogo interno separado, onde as equipes escolhem o que instalar. Isso importa especialmente quando os projetos vivem em bases de código diferentes e as equipes têm necessidades distintas.

Na Anthropic, não há um grupo central único que aprove manualmente todas as skills desde o início. Normalmente, os avanços úteis surgem primeiro localmente, depois são compartilhados via GitHub e Slack e, com a demanda orgânica, vão para o marketplace. O uso pode ser medido com hooks PreToolUse, e as dependências entre skills, por enquanto, são resolvidas com simples referências por nome. A ideia é fazer a biblioteca crescer aos poucos, sem entupir o sistema com duplicatas e extensões mal mantidas.

O que isso significa

O guia da Anthropic aponta uma mudança importante: o valor das ferramentas de IA para desenvolvimento está cada vez mais não só no modelo, mas em como a equipe empacota ao redor dele seu conhecimento, suas verificações e seus processos seguros. Para quem usa o Claude Code, é um sinal para investir não em "prompts mágicos", mas em uma camada própria de skills, que deixa o agente mais previsível, mais útil e mais próximo das tarefas reais de um ambiente de engenharia.