As habilidades estão disponíveis para usuários nos planos gratuito, Pro, Max, Team e Enterprise. Este recurso requer execução de código habilitada. As habilidades também estão disponíveis em beta para usuários do Claude Code e para todos os usuários de API que usam a ferramenta de execução de código.
As habilidades personalizadas permitem aprimorar o Claude com conhecimento especializado e fluxos de trabalho específicos para sua organização ou estilo de trabalho pessoal. Este artigo explica como criar, estruturar e testar suas próprias habilidades.
As habilidades podem ser tão simples quanto algumas linhas de instruções ou tão complexas quanto pacotes com múltiplos arquivos com código executável. As melhores habilidades:
Resolvem uma tarefa específica e repetível
Têm instruções claras que o Claude pode seguir
Incluem exemplos quando útil
Definem quando devem ser usadas
Focam em um fluxo de trabalho em vez de tentar fazer tudo
Criar um arquivo skill.md
Cada habilidade consiste em um diretório contendo no mínimo um arquivo skill.md, que é o núcleo da habilidade. Este arquivo deve começar com um frontmatter YAML para conter os campos de nome e descrição, que são metadados obrigatórios. Também pode conter metadados adicionais, instruções para o Claude ou arquivos de referência, scripts executáveis ou ferramentas.
Campos de metadados obrigatórios
name: Um nome amigável para sua habilidade (máximo 64 caracteres)
Exemplo: Diretrizes de marca
description: Uma descrição clara do que a habilidade faz e quando usá-la.
Isto é crítico—o Claude usa isso para determinar quando invocar sua habilidade (máximo 200 caracteres).
Exemplo: Aplicar diretrizes de marca da Acme Corp a apresentações e documentos, incluindo cores oficiais, fontes e uso de logotipo.
Campos de metadados opcionais
dependencies: Pacotes de software necessários para sua habilidade.
Exemplo: python>=3.8, pandas>=1.5.0
Os metadados no arquivo skill.md servem como o primeiro nível de um sistema de divulgação progressiva, fornecendo apenas informações suficientes para o Claude saber quando a habilidade deve ser usada sem ter que carregar todo o conteúdo.
Corpo Markdown
O corpo Markdown é o segundo nível de detalhe após os metadados, então o Claude acessará isso se necessário após ler os metadados. Dependendo de sua tarefa, o Claude pode acessar o arquivo skill.md e usar a habilidade.
Exemplo skill.md
Habilidade de diretrizes de marca
## Metadata
name: Brand Guidelines
description: Apply Acme Corp brand guidelines to all presentations and documents
## Overview
This skill provides Acme Corp's official brand guidelines for creating consistent, professional materials. When creating presentations, documents, or marketing materials, apply these standards to ensure all outputs match Acme's visual identity. Claude should reference these guidelines whenever creating external-facing materials or documents that represent Acme Corp.
## Brand Colors
Our official brand colors are:
- Primary: #FF6B35 (Coral)
- Secondary: #004E89 (Navy Blue)
- Accent: #F7B801 (Gold)
- Neutral: #2E2E2E (Charcoal)
## Typography
Headers: Montserrat Bold
Body text: Open Sans Regular
Size guidelines:
- H1: 32pt
- H2: 24pt
- Body: 11pt
## Logo Usage
Always use the full-color logo on light backgrounds. Use the white logo on dark backgrounds. Maintain minimum spacing of 0.5 inches around the logo.
## When to Apply
Apply these guidelines whenever creating:
- PowerPoint presentations
- Word documents for external sharing
- Marketing materials
- Reports for clients
## Resources
See the resources folder for logo files and font downloads.
Adicionar recursos
Se você tiver muitas informações para adicionar a um único arquivo skill.md (por exemplo, seções que se aplicam apenas a cenários específicos), você pode adicionar mais conteúdo adicionando arquivos dentro do seu diretório de habilidades. Por exemplo, adicione um arquivo REFERENCE.md contendo informações complementares e de referência ao seu diretório de habilidades. Referenciá-lo em skill.md ajudará o Claude a decidir se precisa acessar esse recurso ao executar a habilidade.
Adicionar scripts
Para habilidades mais avançadas, anexe arquivos de código executável ao skill.md, permitindo que o Claude execute código. Por exemplo, nossas habilidades de documento usam as seguintes linguagens de programação e pacotes:
Python (pandas, numpy, matplotlib)
JavaScript/Node.js
Pacotes para ajudar com edição de arquivos
Ferramentas de visualização
Nota: Claude e Claude Code podem instalar pacotes de repositórios padrão (Python PyPI, JavaScript npm) ao carregar habilidades. Não é possível instalar pacotes adicionais em tempo de execução com API Skills—todas as dependências devem ser pré-instaladas no contêiner.
Empacotar sua habilidade
Depois que sua pasta de habilidades estiver completa:
Certifique-se de que o nome da pasta corresponde ao nome de sua habilidade.
Crie um arquivo ZIP da pasta.
O ZIP deve conter a pasta de habilidades como sua raiz (não uma subpasta).
Estrutura correta:
my-skill.zip
└── my-skill/
├── skill.md
└── resources/
Estrutura incorreta:
my-skill.zip
└── (arquivos diretamente na raiz do ZIP)
Testar sua habilidade
Antes de fazer upload
1. Revise seu skill.md para clareza.
2. Verifique se a descrição reflete com precisão quando o Claude deve usar a habilidade.
3. Verifique se todos os arquivos referenciados existem nos locais corretos.
4. Teste com prompts de exemplo para garantir que o Claude a invoque apropriadamente.
Depois de fazer upload para o Claude
1. Ative a habilidade em Personalizar > Habilidades.
2. Tente vários prompts diferentes que devem acioná-la.
3. Revise o pensamento do Claude para confirmar que está carregando a habilidade.
4. Itere na descrição se o Claude não estiver usando-a quando esperado.
Nota para planos Team e Enterprise: Para disponibilizar uma habilidade a todos os usuários em sua organização, consulte Provisionar e gerenciar habilidades para sua organização.
Melhores práticas
Mantenha o foco: Crie habilidades separadas para diferentes fluxos de trabalho. Múltiplas habilidades focadas se compõem melhor do que uma habilidade grande.
Escreva descrições claras: O Claude usa descrições para decidir quando invocar sua habilidade. Seja específico sobre quando se aplica.
Comece simples: Comece com instruções básicas em Markdown antes de adicionar scripts complexos. Você sempre pode expandir a habilidade depois.
Use exemplos: Inclua entradas e saídas de exemplo em seu arquivo skill.md para ajudar o Claude a entender o que o sucesso parece.
Teste incrementalmente: Teste após cada mudança significativa em vez de construir uma habilidade complexa de uma vez.
As habilidades podem se construir mutuamente: Embora as habilidades não possam referenciar explicitamente outras habilidades, o Claude pode usar múltiplas habilidades juntas automaticamente. Esta composição é uma das partes mais poderosas do recurso de habilidades.
Revise a especificação aberta de Agent Skills: Siga as diretrizes em agentskills.io, para que as habilidades que você criar possam funcionar em plataformas que adotem o padrão.
Para um guia mais aprofundado sobre criação de habilidades, consulte Melhores práticas de autoria de habilidades em nossa Claude Docs.
Considerações de segurança
Tenha cuidado ao adicionar scripts ao seu arquivo skill.md.
Não codifique informações sensíveis (chaves de API, senhas).
Revise todas as habilidades que você baixar antes de habilitá-las.
Use conexões MCP apropriadas para acesso a serviços externos.
Habilidades de exemplo para referência
Visite nosso repositório no GitHub para habilidades de exemplo que você pode usar como modelos: https://github.com/anthropics/skills/tree/main/skills.