Custom Skills permitem aprimorar 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 Skills.
Skills podem ser tão simples quanto algumas linhas de instruções ou tão complexas quanto pacotes multi-arquivo com código executável. As 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 usadas
Focam em um fluxo de trabalho em vez de tentar fazer tudo
Criando um Arquivo Skill.md
Toda Skill consiste em um diretório contendo no mínimo um arquivo Skill.md, que é o núcleo da 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 sua Skill (máximo 64 caracteres)
Exemplo: Diretrizes de Marca
description: Uma descrição clara do que a Skill faz e quando usá-la.
Isto é crítico—Claude usa isto para determinar quando invocar sua 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
version: Rastreie versões de sua Skill conforme você itera.
Exemplo: 1.0.0
dependencies: Pacotes de software necessários para sua 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 a Skill 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 Claude acessará isto se necessário após ler os metadados. Dependendo de sua tarefa, Claude pode acessar o arquivo Skill.md e usar a Skill.
Exemplo Skill.md
Skill de Diretrizes de Marca
## Metadados
name: Diretrizes de Marca
description: Aplicar diretrizes de marca da Acme Corp a todas as apresentações e documentos
version: 1.0.0
## Visão Geral
Esta 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 referenciar 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 diretório de sua Skill. Por exemplo, adicione um arquivo REFERENCE.md contendo informações suplementares e de referência ao diretório de sua Skill. Referenciá-lo em Skill.md ajudará Claude a decidir se precisa acessar esse recurso ao executar a Skill.
Adicionando Scripts
Para Skills mais avançadas, anexe arquivos de código executável ao Skill.md, permitindo que Claude execute código. Por exemplo, nossas skills 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 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 Sua Skill
Quando a pasta de sua Skill estiver completa:
Certifique-se de que o nome da pasta corresponde ao nome de sua 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)