Skills estão disponíveis para usuários nos planos Pro, Max, Team e Enterprise. Este recurso requer que a execução de código esteja habilitada. Skills 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.
Custom Skills permitem que você melhore 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 seus próprios Skills.
Skills podem ser tão simples quanto algumas linhas de instruções ou tão complexos quanto pacotes multi-arquivo com código executável. Os melhores Skills:
Resolvem uma tarefa específica e repetível
Têm instruções claras que Claude pode seguir
Incluem exemplos quando útil
Definem quando devem ser usados
Focam em um fluxo de trabalho em vez de tentar fazer tudo
Criando um Arquivo Skill.md
Todo Skill consiste em um diretório contendo no mínimo um arquivo Skill.md, que é o núcleo do Skill. 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 Claude ou arquivos de referência, scripts executáveis ou ferramentas.
Campos de metadados obrigatórios
name: Um nome amigável para seu Skill (máximo 64 caracteres)
Exemplo: Diretrizes de Marca
description: Uma descrição clara do que o Skill faz e quando usá-lo.
Isto é crítico—Claude usa isto para determinar quando invocar seu Skill (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 seu Skill.
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 Claude saber quando o Skill deve ser usado 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 Claude acessará isto se necessário após ler os metadados. Dependendo de sua tarefa, Claude pode acessar o arquivo Skill.md e usar o Skill.
Exemplo Skill.md
Skill de Diretrizes de Marca
## Metadados
name: Brand Guidelines
description: Aplicar diretrizes de marca da Acme Corp a todas as apresentações e documentos
## Visão Geral
Este Skill fornece as diretrizes de marca oficiais da Acme Corp para criar materiais consistentes e profissionais. Ao criar apresentações, documentos ou materiais de marketing, aplique estes padrões para garantir que todas as saídas correspondam à identidade visual da Acme. Claude deve fazer referência a estas diretrizes sempre que criar materiais voltados para o exterior ou documentos que representem a Acme Corp.
## Cores de Marca
Nossas cores de marca oficiais são:
- Primária: #FF6B35 (Coral)
- Secundária: #004E89 (Azul Marinho)
- Destaque: #F7B801 (Ouro)
- Neutra: #2E2E2E (Carvão)
## Tipografia
Cabeçalhos: Montserrat Bold
Texto do corpo: Open Sans Regular
Diretrizes de tamanho:
- H1: 32pt
- H2: 24pt
- Corpo: 11pt
## Uso do Logotipo
Sempre use o logotipo em cores completas em fundos claros. Use o logotipo branco em fundos escuros. Mantenha espaçamento mínimo de 0,5 polegadas ao redor do logotipo.
## Quando Aplicar
Aplique estas diretrizes sempre que criar:
- Apresentações PowerPoint
- Documentos Word para compartilhamento externo
- Materiais de marketing
- Relatórios para clientes
## Recursos
Veja a pasta de recursos para arquivos de logotipo e downloads de fontes.
Adicionando 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 Skill. Por exemplo, adicione um arquivo REFERENCE.md contendo informações suplementares e de referência ao seu diretório Skill. Fazer referência a ele em Skill.md ajudará Claude a decidir se precisa acessar esse recurso ao executar o Skill.
Adicionando Scripts
Para Skills mais avançados, anexe arquivos de código executável ao Skill.md, permitindo que Claude execute código. Por exemplo, nossos document skills 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 Skills. 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.
Empacotando Seu Skill
Quando sua pasta Skill estiver completa:
Certifique-se de que o nome da pasta corresponde ao nome do seu Skill.
Crie um arquivo ZIP da pasta.
O ZIP deve conter a pasta Skill como sua raiz (não uma subpasta).
Estrutura correta:
my-Skill.zip
└── my-Skill/
├── Skill.md
└── resources/