A Anthropic explicou como criar skills para Claude Code e por que as equipes precisam de um marketplace próprio

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

Quais skills funcionam

O ponto principal do guia: uma skill não é apenas um arquivo markdown com instruções, mas uma pasta completa com configs, scripts, templates, dados e até hooks. É por isso que a Anthropic recomenda primeiro determinar o tipo de skill e depois escrever seu conteúdo. Segundo as observações da empresa, as melhores skills geralmente resolvem uma tarefa clara. Aquelas que tentam ser simultaneamente referência, piloto automático, runbook e gerador de código confundem o modelo mais frequentemente do que o ajudam.

• Referências de API, SDK e bibliotecas internas
• Skills para verificação de produto através de browser, 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 operacionais. No primeiro caso, o agente não apenas escreve código, mas executa o cenário ele mesmo, verifica as etapas e registra o resultado. No segundo caso, recebe proteções para ações sensíveis como limpeza de recursos, deploy ou triagem de alertas. Tais skills são especialmente valiosas onde erros são custosos: em produção, pagamentos, onboarding e plataformas internas. Esses cenários mostram melhor se uma skill transforma o modelo em uma ferramenta de trabalho confiável.

Como escrever uma skill

A Anthropic recomenda não desperdiçar espaço com coisas óbvias que o Claude já conhece sobre código e práticas típicas. É muito mais útil reunir em uma skill uma seção com "pegadinhas" reais: falhas típicas, casos extremos não triviais e regras locais da equipe. Outro princípio importante é a divulgação gradual do contexto através do sistema de arquivos. Detalhes de API podem ir para referências, templates para assets, e lógica repetitiva para scripts. Dessa forma 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 antecipadamente a configuração inicial: por exemplo, armazenar parâmetros em config.json e fazer perguntas estruturadas ao usuário se o config estiver vazio. O campo description deve ser escrito não como um resumo de marketing, mas como uma condição de disparo para o próprio modelo. Para memória, você pode usar logs, JSON ou SQLite, mas dados persistentes são melhor mantidos em um diretório estável como `${CLAUDE_PLUGIN_DATA}`. Além disso, a Anthropic promove separadamente a ideia de armazenar código e bibliotecas auxiliares dentro de skills em vez de forçar o modelo a reinventar boilerplate a cada vez. Para simplificar esse processo, a empresa até lançou o Skill Creator.

Como compartilhar dentro de uma equipe

Para distribuir skills, a Anthropic descreve dois cenários básicos: armazená-los diretamente no repositório do projeto ou empacotá-los como plugins para o marketplace do Claude Code. A primeira opção é conveniente para pequenas equipes e alguns poucos repositórios, mas tem um custo: cada skill commitado adiciona contexto ao modelo. Quando há muitas skills, faz sentido movê-las para um catálogo interno separado onde as equipes escolhem o que instalar. Isso é especialmente importante se diferentes projetos vivem em diferentes bases de código e as equipes têm necessidades diferentes.

Dito isto, a Anthropic não possui um único time central que aprova manualmente todas as skills desde o início. Geralmente, desenvolvimentos úteis primeiro aparecem localmente, depois são compartilhados via GitHub e Slack, e após demanda orgânica, são promovidos para o marketplace. O uso pode ser medido através de hooks PreToolUse, e dependências entre skills são atualmente resolvidas por simples links baseados em nome. A ideia é fazer crescer a biblioteca gradualmente, sem entupir o sistema com duplicatas e extensões mal mantidas.

O que isso significa

O guia da Anthropic mostra uma mudança importante: o valor de ferramentas de IA para desenvolvimento cada vez mais reside não apenas no modelo, mas em como a equipe empacota seu conhecimento, verificações e processos seguros ao seu redor. Para usuários do Claude Code, este é um sinal para investir não em "prompts mágicos", mas em uma camada customizada de skills que torna o agente mais previsível, útil e mais próximo das tarefas reais de trabalho no ambiente de engenharia.