Como criar e usar as habilidades do Claude? Guia detalhado com 3 métodos!

O novo de Claude Competências O recurso — lançado recentemente pela Anthropic — permite que equipes e desenvolvedores ensinem a Claude recursos repetíveis e compartilháveis: pense em "kits de ferramentas" compactos e versionados (pastas com instruções, scripts e recursos) que permitem a Claude executar tarefas específicas de domínio com confiabilidade, como gerar apresentações de slides alinhadas à marca, produzir planilhas do Excel com fórmulas ou executar pequenos trechos de código com segurança. Este artigo explica o que são habilidades e por que elas são importantes, então fornece um guia prático passo a passo para usar as Habilidades de três maneiras: nos aplicativos da web de Claude (o caminho sem código), em Código Claude (estilo IDE do desenvolvedor) e por meio do Cláudio API (integração programática). Finalizaremos com segurança, comparação com outros padrões de agentes, práticas recomendadas e dicas de solução de problemas.

O que exatamente são as Habilidades Claude e quais vantagens elas trazem?

Definição curta: A Habilidade é uma pasta/pacote independente que reúne instruções, scripts, recursos e, opcionalmente, auxiliares executáveis ​​que Claude pode carregar dinamicamente quando uma tarefa corresponde aos gatilhos da Habilidade. Na prática, uma Habilidade atua como um "recurso" reutilizável e versionado que ensina Claude a executar uma classe específica de tarefas (por exemplo, formatar planilhas de acordo com os padrões da sua empresa, aplicar diretrizes de marca a apresentações de slides, gerar relatórios seguindo um modelo regulamentado).

Partes principais de uma habilidade (o que você normalmente encontrará)

• manifest / metadata — nome, versão, gatilhos, permissões.
• instructions.md — degraus altos, guarda-corpos, exemplos.
• handlers or scripts — código real para gerar arquivos, chamar ferramentas internas ou transformar dados.
• resources/ — modelos, guias de estilo, dados de amostra.
• tests/ — testes automatizados usados ​​para validar uma Habilidade.

Quais capacidades as Habilidades acrescentam ao Claude?

• Instruções personalizadas e pacotes de conteúdo: As habilidades podem incluir instruções escritas, modelos e arquivos de recursos (guias de estilo, CSVs, etc.) que Claude usa como contexto confiável.
• Componentes executáveis ​​(Ferramenta de execução de código): As habilidades podem incluir scripts ou códigos executados dentro do contêiner de execução de código do Anthropic para operações determinísticas (análise de arquivos, computação numérica, transformações de dados). Isso alivia o trabalho que seria custoso ou pouco confiável se fosse expresso apenas como geração de tokens.
• Ativação automática e uso seletivo: Claude pode selecionar e invocar automaticamente Habilidades relevantes quando a solicitação do usuário corresponde ao escopo da Habilidade e pode explicar por que escolheu uma Habilidade.
• Controle de versão e programático: As habilidades são objetos de API de primeira classe: você pode fazer upload, gerenciar versões e fazer referência skill_ids da API Claude. Isso permite fluxos de trabalho no estilo CI e governança para atualizações.
• Distribuição entre pontos finais: As habilidades funcionam em toda a família de produtos da Claude — os aplicativos da web, o Claude Code e o API/Agent SDK da Anthropic — permitindo tanto a produtividade do usuário final quanto a automação do desenvolvedor.

Como posso usar o Claude Skills nos aplicativos web do Claude (Claude.ai)?

Preciso dos pré-requisitos: (1) Você deve ter um plano pago do Claude que suporte Habilidades (Pro, Max, Team ou Enterprise no lançamento). A disponibilidade e os controles administrativos variam de acordo com o plano e as configurações da organização. (2) Acesse as Configurações e a alternância de recursos "Habilidades" no seu espaço de trabalho (Configurações → Recursos → Habilidades). Os administradores podem precisar habilitar a criação de Habilidades ou limitar a instalação a Habilidades aprovadas.

Guia passo a passo para criar e usar habilidades no Claude Apps Web:

Etapa 1: explore os exemplos integrados e ative as Habilidades

Abra Claude.ai → Configurações → Recursos → Habilidades. Ative a visualização/exemplo de Habilidades para ver a estrutura e o comportamento de ativação. Esta é a maneira mais rápida de aprender a aparência e o comportamento das Habilidades.

Etapa 2: use a interface do criador de habilidades (primeira habilidade)

A Anthropic implantou um criador de habilidades guiado dentro dos aplicativos: escolha Criar Habilidade para iniciar um assistente que pergunta o que você deseja que a Habilidade faça, fornece um layout de pasta padrão (README, arquivos de instruções, modelos de exemplo, opcionalmente um script) e ajuda a escrever instruções e gatilhos básicos. Use o conjunto de testes integrado para validar o comportamento com prompts de exemplo.

Etapa 3: Defina a intenção, os exemplos e os recursos da habilidade

• Modelos/recursos: Adicione modelos, exemplos de CSV, especificações de design ou dicionários de entidade que a Habilidade deve referenciar.
• Intenção / descrição: Escreva uma descrição curta e explícita sobre a finalidade da habilidade (isso ajuda Claude a identificá-la).
• Sinais de ativação/gatilhos: Adicione palavras-chave ou exemplos de prompts que devem fazer com que Claude carregue a habilidade.
• Arquivos de instruções: Coloque instruções estáveis ​​(por exemplo, tom da marca, seções obrigatórias) em um único arquivo canônico dentro da Habilidade.

Etapa 4: Baixe e carregue a habilidade

Quando estiver satisfeito, Claude compactará a Habilidade como um arquivo ZIP. Na barra lateral esquerda, clique em "Recursos".

Ou você pode arrastar e soltar o ZIP na área de upload. Claude valida e instala, confirmando a ativação.

Etapa 5: Use habilidades durante conversas reais

Após salvar, experimente prompts naturais que correspondam aos gatilhos da Habilidade (ou mencione a Habilidade pelo nome). O aplicativo indicará quando carregou uma Habilidade e poderá mostrar quais recursos ela utilizou; execute algumas iterações e refine as instruções até que as saídas sejam confiáveis. Quando um usuário solicita que Claude execute a tarefa relevante, ele pode detectar e carregar automaticamente a Habilidade correspondente — ou você pode invocá-la explicitamente. As instruções, os modelos e o código da Habilidade orientam as saídas de Claude.

Dicas para Claude Apps Web

• O sistema inclui habilidades integradas para tarefas comuns, como: geração de documentos; criação de relatórios; apresentação em PowerPoint; cálculo de fórmulas do Excel.
• Os usuários podem personalizar diretamente suas próprias habilidades.
• Claude invoca automaticamente habilidades relevantes, eliminando a necessidade de seleção manual.
• Durante o processo de raciocínio de Claude, os usuários podem ver quais habilidades estão sendo invocadas.
• Prefira tarefas não executáveis ​​no início.** Habilidades da Web que apenas especificam instruções (sem código) são mais fáceis de auditar.

Como posso usar as habilidades do Claude no Claude Code?

Condições

• Acesso ao Código Claude: Claude Code é a interface de assistente de terminal/IDE da Anthropic — frequentemente incluída em planos de desenvolvedor ou acessível por meio de um plugin/marketplace. Alguns recursos de Skill exigem acesso à Ferramenta de Execução de Código ou ao ADK (kit de desenvolvimento de agentes). A CometAPI fornece acesso ao código e à API do Claude. Você pode usar skills no código Claude da CometAPI e consultar documentação usando o código Claude.
• Ambiente de desenvolvedor local: Se uma habilidade incluir conjuntos de testes ou código, você vai querer clonar o repositório da habilidade e executar os testes localmente.

Guia passo a passo para criar e usar habilidades no Claude Code

Etapa 1: Crie uma estrutura de pastas de habilidades:

No Claude Code, as habilidades geralmente ficam como pastas com um manifesto (metadados), arquivos de instruções, entradas de teste, scripts auxiliares (Python/JS) e quaisquer binários ou modelos:

1. Defina o manifesto de habilidades: O manifesto inclui skill_id, nome, descrição, autor, dependências, pontos de entrada e notas de segurança. Isso informa ao Claude Code como e quando carregar a habilidade.
2. Implementar scripts auxiliares e testes: Se sua habilidade usa código para transformar ou gerar arquivos, adicione scripts pequenos e bem definidos e testes unitários que sejam executados dentro do ambiente de execução de código.

Etapa 2: instalar ou adicionar um pacote de habilidades

• No Claude Code, abra o painel de plugin/marketplace e add anthropics/skills (ou o repositório de habilidades específico).
• Como alternativa, clone um repositório de habilidades no seu espaço de trabalho.

Selecione “Habilidades do Agente Antrópico”

Em seguida, escolha entre “document-skills” (para geração de arquivos) ou “example-skills” (para demonstrações). Para este tutorial, opte por “document-skills” — ele apresenta recursos como a criação de documentos do Word. Clique em “Instalar agora”; o Claude Code baixa e registra as habilidades.

Etapa 3: Crie manipuladores de código avançados

• Implemente manipuladores que operem em arquivos ou chamem ferramentas externas (por exemplo, gere .pptx com python-pptx, crie .xlsx com openpyxl).
• Se a habilidade exigir execução remota de código, certifique-se de que ela esteja em conformidade com o modelo de contêiner da Anthropic (a documentação da API descreve como as habilidades usam contêineres para execuções de código).

Etapa 4: Carregar e testar no Claude Code

• Inicie uma sessão do Claude Code e peça para ele executar sua habilidade (por exemplo, “Use a habilidade ReportGen para criar slides de receita do terceiro trimestre”).
• Observe logs, saídas e quaisquer artefatos gerados no espaço de trabalho.

Etapa 5: Empacotar e publicar

Envie a habilidade para o registro de habilidades da sua organização ou envie para um repositório GitHub aprovado. Use tags de versão e inclua conjuntos de testes para governança.

Dicas para Claude Code

• Trate as habilidades como projetos de código: use CI para executar testes de habilidade quando o código ou os modelos forem alterados.
• Isolar efeitos colaterais: se uma habilidade puder executar scripts, execute-os em contêineres descartáveis ​​ou sandboxes para evitar vazamentos acidentais de dados.
• Documente entradas/saídas de forma clara para que colegas de equipe que não sejam desenvolvedores possam usar a habilidade no aplicativo da web mais tarde.

Como posso usar as habilidades do Claude na API do Claude?

Condições

Acesso ao Anthropic's API de mensagens com o ferramenta de execução de código habilitado (as habilidades se integram à API de mensagens por meio de um parâmetro de contêiner). Você também precisará de credenciais de API e quaisquer permissões de tempo de execução necessárias para executar o código da habilidade em contêineres.

Guia passo a passo para criar e usar uma habilidade via API:

Etapa 1: Prepare o pacote de habilidades localmente

Crie uma pasta Skill que siga o formato de manifesto esperado da API (nome, versão, arquivos de instrução, gatilhos, caminhos de recursos opcionais e scripts auxiliares). A documentação da Anthropic fornece o esquema e os exemplos.

Etapa 2: Carregue ou registre a habilidade

Habilidade gerenciada antrópica: referência a skill_id e versão opcional na sua chamada de API (não é necessário upload). Use sua chave de API para autenticar e chamar o ponto de extremidade de criação de habilidade (por exemplo, um POST /v1/skills ou ponto final semelhante.

curl -X POST "https://api.anthropic.com/v1/skills" \  
-H "x-api-key: $ANTHROPIC_API_KEY" \  
-H "anthropic-version: 2023-06-01" \  
-H "anthropic-beta: skills-2025-10-02" \  
-F "display_title=My Excel Skill" \  
-F "files=@excel-skill/process_excel.py;filename=excel-skill/process_excel.py"

Carregue a carga útil da Skill ou aponte a API para um artefato compactado. A API validará e armazenará a Skill para o seu espaço de trabalho.

Independentemente da origem, as habilidades são integradas à API de mensagens da mesma forma. Você pode especificar a versão da habilidade usando o skill_id, o tipo e, opcionalmente, o parâmetro skill_version, que será executado no ambiente de execução de código:

Etapa 3: chamar a API de mensagens com um parâmetro de contêiner

Na sua solicitação da API de mensagens, inclua um container campo especificando o skill_id, type (anthropic or custom), e opcionalmente version. O ponto de extremidade de mensagens encaminha a execução para o ambiente de código onde a habilidade é executada.

Exemplo (conceitual):

   {
     "model": "claude-sonnet-4-5-20250929",
     "messages": }],
     betas=,
     "container": {"type":"custom","skill_id":"skill_01AbCdEf","version":"latest"}
   }

Etapa 4: Baixando os arquivos gerados

Quando uma habilidade cria um documento (Excel, PowerPoint, PDF, Word), ela retorna uma propriedade file_id na resposta. Você deve usar a API File para baixar estes arquivos:

def extract_file_ids(response):
file_ids = []
for item in response.content:
if item.type == 'bash_code_execution_tool_result':
content_item = item.content
if content_item.type == 'bash_code_execution_result':
for file in content_item.content:
if hasattr(file, 'file_id'):
file_ids.append(file.file_id)
return file_ids

for file_id in extract_file_ids(response):
file_metadata = client.beta.files.retrieve_metadata(
file_id=file_id,
betas=
)
file_content = client.beta.files.download(
file_id=file_id,
betas=
)

file_content.write_to_file(file_metadata.filename)
print(f"Downloaded: {file_metadata.filename}")

Dicas para uso da API

• Prefira habilidades gerenciadas pela Anthropic para formatos comuns (pptx/xlsx/docx) para evitar reinventar a roda.
• Use o campo de versão. Fixe uma versão de habilidade em produção para evitar comportamento inesperado.
• Implementar guarda-corpos no seu sistema: higienize entradas, limite tamanhos de arquivos e execute validações pós-geração antes de expor artefatos externamente.

Por que usar o Claude Skills — quais são os benefícios e as desvantagens?

Benefícios

• Consistência e qualidade: As habilidades codificam as melhores práticas organizacionais (regras de marca, redação jurídica), para que os resultados sejam consistentes e reduzam o retrabalho manual.
• Produtividade: Automatizar tarefas repetíveis (preparação de dados, criação de slides, aplicação de modelos) encurta os ciclos — os primeiros clientes relataram um tempo de produção mais rápido em testes beta.
• Reutilização e governança: As habilidades se tornam artefatos versionados que podem ser revisados, testados e implementados como software, simplificando auditorias e conformidade.
• Menor custo de token/computação para fluxos complexos: Como Claude carrega apenas as partes relevantes de uma Habilidade quando necessário, você pode evitar o envio constante de longos prompts do sistema, reduzindo custos e o inchaço do contexto.

limitações:

• Trabalho inicial: Desenvolver habilidades robustas exige design, documentação e testes — você está trocando engenharia rápida por engenharia de produto.
• Risco executável: Habilidades que executam código ou acessam dados aumentam a área de superfície de segurança; as empresas devem limitar quem publica e aprova habilidades executáveis.
• Disponibilidade de planos e recursos: As Habilidades foram lançadas nos planos Pro, Max, Team e Enterprise no anúncio; usuários gratuitos podem não ter acesso às Habilidades por padrão. Verifique seu plano.

Como o Claude Skills se compara a outras plataformas e padrões de agentes?

Habilidades = artefatos mais ricos e versionados.** São mais estruturados do que chamadas de ferramentas ou modelos únicos: Habilidades reúnem instruções, ativos, scripts e manifestos em um pacote reutilizável. Isso as torna mais próximas de um microagente implantável do que de uma única invocação de ferramenta.

Habilidades vs. prompts de sistema ad-hoc e bibliotecas de prompts

Os prompts do sistema são efêmeros e devem ser fornecidos a cada sessão; as habilidades são persistentes, versionadas e gerenciadas centralmente. Portanto, as habilidades são melhores para escala empresarial e reprodutibilidade.

Habilidades vs. agentes baseados em ferramentas (chamadas de ferramentas / chamadas de funções)

Agentes baseados em ferramentas (por exemplo, padrões de chamada de função) concentram-se em fornecer aos modelos habilidades externas concretas (APIs, invocação de ferramentas). As habilidades combinam instruções + recursos + ajudantes opcionais e têm como objetivo ensinar o modelo como para realizar uma tarefa (incluindo quando usar ferramentas). Em suma: ferramentas são atuadores; Habilidades codificam procedimentos e políticas que podem usar ferramentas.

Habilidades vs. AgentKit da OpenAI e estruturas de agentes semelhantes

Lançamentos recentes (por exemplo, no OpenAI DevDay) enfatizam agentes empacotados e kits de ferramentas para desenvolvedores para passar do protótipo à produção. Claude Skills desempenha um papel semelhante, mas com ênfase em instruções + recursos em pastas e forte integração cruzada entre aplicativos, código e API do Claude. As duas abordagens são convergentes: ambas visam habilitar agentes de produção, mas os detalhes de implementação (APIs de SDK, controles de governança, padrões de marketplace) diferem. Se você já usa uma estrutura de agente, as Habilidades podem frequentemente ser os "módulos de capacidade" que você carrega nesses agentes.

Quando você deve escolher Skills em vez de um agente personalizado?

• Use habilidades quando você precisa de recursos padronizados, compartilháveis ​​e de baixo atrito entre usuários e interfaces de usuário (benefício para quem não é desenvolvedor).
• Use agentes personalizados quando Você precisa de uma orquestração complexa de múltiplas ferramentas com lógica de controle personalizada, fora do modelo de execução de Habilidades de Claude. Habilidades são excelentes para tarefas de domínio organizadas; agentes são para orquestração pesada.

Onde outros padrões ainda vencem

• Tarefas leves e de baixa latência:Para tarefas pequenas ou quando você não precisa de saídas reproduzíveis, chamadas de função ou prompts do sistema ainda são mais simples.
• Ecossistemas de ferramentas personalizadas:Se você já tem uma grande infraestrutura de ferramentas personalizadas exposta via APIs, chamadas de funções/plugins integrados com camadas de orquestração podem ser uma opção melhor.

Exemplos e receitas práticas e reais

Exemplo 1 — Formatador de slides de marca (habilidade de aplicativo da web)

• O que faz: Converte marcadores de slides brutos em slides com a marca da empresa (fontes, tom, ordem dos slides).
• Criar no aplicativo web: Use o Criador de habilidades → adicione um guia de estilo da marca, um modelo de slide e exemplos de entrada/saída. Habilite para a equipe de design. Teste perguntando "Formate estas notas usando o Formatador de Slides da Marca".

Exemplo 2 — Auditor de Dados CSV (Claude Code Skill)

• O que faz: Valida colunas de dados CSV, executa verificações leves do Python (valores ausentes, incompatibilidades de tipos) e retorna um relatório resumido.
• Criar em código: Desenvolva habilidades com validators.py auxiliar, testes unitários e CSVs de exemplo. Teste iterativamente no notebook de Claude Code, depois compacte e publique.

Exemplo 3 — Assistente de Redline de Contrato (Habilidade de API)

• O que faz: Aplica os padrões legais da empresa ao texto do contrato e produz uma linha vermelha e uma justificativa.
• Criar via API: Arquivos de instruções do autor e biblioteca de cláusulas, upload via POST /skills, então ligue do seu sistema de gerenciamento de contratos com skill_id para produzir saídas padronizadas de linhas vermelhas.

Conclusão

As Habilidades do Claude são uma ponte prática entre instruções ad hoc e a engenharia completa de agentes: elas permitem que as equipes capturem o conhecimento institucional, imponham estilo e segurança e automatizem tarefas recorrentes em interfaces de usuário e superfícies programáticas. Seja você um gerente de produto não técnico que utiliza o criador de habilidades web, um engenheiro que implementa ferramentas de desenvolvimento repetíveis no Claude Code ou uma equipe de plataforma que integra habilidades em aplicativos com a API de mensagens, seguir práticas pequenas e disciplinadas — controle de versão, testes, privilégios mínimos e implementações em etapas — tornará suas habilidades confiáveis ​​e auditáveis ​​em produção.

Começando a jornada

A CometAPI é uma plataforma de API unificada que agrega mais de 500 modelos de IA de provedores líderes — como a série GPT da OpenAI, a Gemini do Google, a Claude da Anthropic, a Midjourney e a Suno, entre outros — em uma interface única e amigável ao desenvolvedor. Ao oferecer autenticação, formatação de solicitações e tratamento de respostas consistentes, a CometAPI simplifica drasticamente a integração de recursos de IA em seus aplicativos. Seja para criar chatbots, geradores de imagens, compositores musicais ou pipelines de análise baseados em dados, a CometAPI permite iterar mais rapidamente, controlar custos e permanecer independente de fornecedores — tudo isso enquanto aproveita os avanços mais recentes em todo o ecossistema de IA.

O CometAPI fornece acesso ao código Claude e à API Claude. Você pode usar habilidades no código Claude do CometAPI e consultar documentação usando o código Claude.

Por que usar o código Claude através do CometAPI?

Principais recursos de inteligência artificial: gere, depure e otimize código facilmente usando modelos criados especificamente para desenvolvedores.

• Seleção flexível de modelos: nossa ampla gama de modelos permite que você desenvolva com mais facilidade.
• Integração perfeita: APIs sempre disponíveis. Integre o Claude Code diretamente ao seu fluxo de trabalho atual em minutos.
• Usar o Claude Code via CometAPI economizará mais custos. A API Claude fornecida pela CometAPI tem 20% de desconto sobre o preço oficial e é atualizada com o modelo mais recente pelo fabricante oficial. O modelo mais recente é API do Claude Haiku 4.5.

Pronto para ir?→ Inscreva-se no CometAPI hoje mesmo !

Se você quiser saber mais dicas, guias e novidades sobre IA, siga-nos em VK, X e  Discord!