Skills estão disponíveis para usuários nos planos free, 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 name e description, 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: Brand Guidelines
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: Apply Acme Corp brand guidelines to presentations and documents, including official colors, fonts, and logo usage.
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
## 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.
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. Referenciá-lo 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 container.
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/
Estrutura incorreta:
my-Skill.zip
└── (arquivos diretamente na raiz do ZIP)
Testando seu skill
Antes de fazer upload
1. Revise seu Skill.md para clareza
2. Verifique se a descrição reflete com precisão quando Claude deve usar o Skill
3. Verifique se todos os arquivos referenciados existem nos locais corretos
4. Teste com prompts de exemplo para garantir que Claude o invoque apropriadamente
Após fazer upload para Claude
1. Habilite o Skill em Settings > Capabilities.
2. Tente vários prompts diferentes que devem acioná-lo
3. Revise o pensamento de Claude para confirmar que está carregando o Skill
4. Itere na descrição se Claude não estiver usando quando esperado
Nota para planos Team e Enterprise: Para disponibilizar um skill para todos os usuários em sua organização, consulte Provisioning and managing Skills for your organization.
Melhores práticas
Mantenha o foco: Crie Skills separados para diferentes fluxos de trabalho. Múltiplos Skills focados se compõem melhor do que um Skill grande.
Escreva descrições claras: Claude usa descrições para decidir quando invocar seu Skill. 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 o Skill depois.
Use exemplos: Inclua entradas e saídas de exemplo em seu arquivo Skill.md para ajudar Claude a entender como é o sucesso.
Teste incrementalmente: Teste após cada mudança significativa em vez de construir um Skill complexo de uma vez.
Skills podem se construir mutuamente: Embora Skills não possam referenciar explicitamente outros Skills, Claude pode usar múltiplos Skills juntos automaticamente. Esta composabilidade é uma das partes mais poderosas do recurso Skills.
Revise a especificação aberta de Agent Skills: Siga as diretrizes em agentskills.io, para que os skills que você criar possam funcionar em plataformas que adotem o padrão.
Para um guia mais aprofundado sobre criação de skills, consulte Skill authoring best practices 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 qualquer Skills que você baixe antes de habilitá-los.
Use conexões MCP apropriadas para acesso a serviços externos.
Skills de exemplo para referência
Visite nosso repositório no GitHub para Skills de exemplo que você pode usar como templates: https://github.com/anthropics/skills/tree/main/skills.