As habilidades estão disponíveis para usuários nos planos Free, 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
Gravar uma habilidade
Gravar uma habilidade está disponível nos planos Pro, Max e Team, no Cowork no Claude para Mac. Não está disponível no chat, no Windows ou nos planos Free e Enterprise.
Em vez de escrever uma habilidade manualmente, você pode gravar a si mesmo realizando uma tarefa e deixar o Claude construir a habilidade a partir do que observa. Você envia ao Claude um vídeo de sua tela, cliques, digitação e voz, e o Claude propõe uma habilidade para você revisar antes de salvá-la.
Antes de gravar
Atualize para a versão mais recente do Claude para Mac.
Conceda as permissões do macOS que o Claude solicita na primeira vez que você grava: Acessibilidade para rastreamento de mouse e teclado, e Gravação de tela para visibilidade de tela. O macOS pode pedir que você reinicie o Claude.
Feche todos os arquivos, aplicativos ou conversas que você não deseja capturar.
Aviso: Não digite senhas ou segredos, nem exiba informações sensíveis ou conversas privadas durante a gravação. Tudo na sua tela é capturado durante toda a sessão, junto com tudo o que você disser.
Grave seu fluxo de trabalho
Abra o Cowork no Claude para Mac.
Inicie uma gravação de uma de duas maneiras:
Clique no botão "+" no compositor e selecione "Gravar uma habilidade."
Vá para Personalizar > Habilidades, clique em "Adicionar" e selecione "Gravar sua tela."
Clique em "Iniciar gravação." Para narrar enquanto trabalha, deixe o microfone ligado. Use o controle de microfone para silenciá-lo ou escolher uma entrada diferente.
Faça a tarefa da forma como você normalmente faria. A barra de captura mostra que a gravação está em andamento e conta as etapas que capturou.
Clique em "Concluído" quando terminar ou "Descartar" para descartar a gravação sem criar nada.
Uma gravação pode durar cerca de 10 minutos. Uma contagem regressiva aparece na barra de captura quando você tem cerca de um minuto restante. Quando chega a zero, a gravação para e tudo o que você capturou até esse ponto é enviado ao Claude, da mesma forma que se você tivesse clicado em "Concluído."
Dica: Fale sobre o que você está fazendo enquanto grava. A narração dá ao Claude contexto que ele não consegue obter apenas da sua tela, como por que você pula uma etapa ou como escolhe entre duas opções.
O que acontece depois que você clica em Concluído
O Claude inicia uma tarefa do Cowork e revisa a gravação, depois propõe uma habilidade. Dependendo do que encontra, você verá uma de duas coisas:
Uma nova habilidade, marcada como NOVA no cartão de proposta. Clique em "Salvar" para mantê-la ou "Descartar" para descartar a proposta.
Uma atualização para uma habilidade existente. Se a gravação se sobrepõe a uma habilidade que você já tem, o Claude propõe alterações nessa habilidade. O cartão mostra em qual habilidade a proposta se baseia. Clique em "Atualizar" para aplicar as alterações ou "Descartar" para descartá-las.
Expanda Conteúdo no cartão de proposta para ler a habilidade antes de decidir.
As habilidades que você salva de uma gravação aparecem em Personalizar > Habilidades e funcionam como qualquer outra habilidade. Você pode editá-las, compartilhá-las e deletá-las nos mesmos termos.
O que é mantido de uma gravação
O vídeo e o áudio da sua gravação não são retidos. Depois que você envia sua gravação ao Claude, o Claude revisa a gravação para construir a habilidade. O que é salvo depois é um conjunto de capturas de tela da sessão, que você pode visualizar expandindo a etapa Demonstração gravada na tarefa.
Como essas capturas de tela vivem na tarefa do Cowork, deletar a tarefa as remove. Veja Comece com o Claude Cowork para saber como funcionam a exclusão e retenção de tarefas.
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 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 habilidade (máximo de 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 de 200 caracteres).
Exemplo: Aplique as 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 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, portanto Claude acessará isso se necessário após ler os metadados. Dependendo da sua tarefa, Claude pode acessar o arquivo skill.md e usar a 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.
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 skill. Por exemplo, adicione um arquivo REFERENCE.md contendo informações complementares e de referência ao seu diretório de skill. Referenciá-lo em skill.md ajudará Claude a decidir se precisa acessar esse recurso ao executar a skill.
Adicionar 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.
Empacotar sua skill
Quando sua pasta de skill estiver completa:
Certifique-se de que o nome da pasta corresponde ao nome da sua skill.
Crie um arquivo ZIP da pasta.
O ZIP deve conter a pasta de 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)
Testar sua 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 a skill.
3. Verifique se todos os arquivos referenciados existem nos locais corretos.
4. Teste com prompts de exemplo para garantir que Claude a invoque apropriadamente.
Após fazer upload para Claude
1. Ative a skill em Personalizar > Skills.
2. Tente vários prompts diferentes que devem acioná-la.
3. Revise o pensamento de Claude para confirmar que está carregando a skill.
4. Itere na descrição se Claude não estiver usando-a quando esperado.
Quando você estiver iterando em uma skill com Claude no chat, você pode editar os arquivos de skill diretamente onde eles abrem ao lado da conversa. Destaque o texto que deseja alterar, clique em "Editar com Claude" e digite sua solicitação. Para skills com vários arquivos, deixe solicitações de edição nos arquivos e envie-as juntas, e Claude as aplica em uma única passagem. Saiba mais sobre edição de artefatos.
Nota para planos Team e Enterprise: Para disponibilizar uma skill a todos os usuários da sua organização, consulte Provisionar e gerenciar skills para sua organização.
Melhores práticas
Mantenha o foco: Crie skills separadas para diferentes fluxos de trabalho. Múltiplas skills focadas funcionam melhor do que uma skill grande.
Escreva descrições claras: Claude usa descrições para decidir quando invocar sua skill. Seja específico sobre quando ela se aplica.
Comece simples: Comece com instruções básicas em Markdown antes de adicionar scripts complexos. Você sempre pode expandir a skill depois.
Use exemplos: Inclua exemplos de entrada e saída em seu arquivo skill.md para ajudar Claude a entender como o sucesso se parece.
Teste incrementalmente: Teste após cada mudança significativa em vez de construir uma skill complexa de uma vez.
Skills podem se basear uma na outra: Embora skills não possam referenciar explicitamente outras skills, Claude pode usar múltiplas skills juntas automaticamente. Essa composição é uma das partes mais poderosas do recurso de skills.
Revise a especificação aberta de Agent Skills: Siga as diretrizes em agentskills.io, para que as skills que você criar possam funcionar em plataformas que adotem o padrão.
Para um guia mais aprofundado sobre criação de skills, consulte Melhores práticas de autoria de skills 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 habilidade que você baixar antes de ativá-la.
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.