O que são Claude Skills?
Instruções reutilizáveis, ensinando seu fluxo ao Claude
⏱ Estim. ~7 min
01 · Ler
Você vem usando o Claude Code para construir projetos. Mas, a cada nova conversa, precisa explicar de novo as suas preferências — estilo de código, formato de mensagens de commit, jeito de testar, convenções do projeto.
E se o Claude pudesse lembrar do seu fluxo de trabalho para sempre?
É isso que são as Claude Skills. Uma skill é um arquivo de instruções reutilizável que diz ao Claude exatamente como você quer que ele trabalhe. Você escreve as regras uma vez e o Claude segue em todas as conversas — automaticamente.
Chega de repetir tudo. Chega de saída inconsistente. É o Claude trabalhando do seu jeito.
💡 Imagine assimPense em uma skill como treinar um colega novo. Em vez de explicar as convenções do time toda manhã, você escreve um manual do time. A skill é o manual do Claude — permanente, reutilizável, atualizável quando precisar.
Pontos-chave
- Cada nova conversa do Claude Code começa do zero — não lembra das preferências anteriores
- Uma skill é um arquivo de instruções reutilizável que o Claude carrega automaticamente
- Uma vez escrita, a skill vale em todas as conversas daquele projeto
- Skills transformam suas regras implícitas em instruções permanentes e compartilháveis
02 · Ler
Uma Claude Skill é uma pasta com um arquivo SKILL.md dentro. Só isso.
O SKILL.md contém instruções escritas em linguagem natural e, opcionalmente, metadados em YAML no topo. Você também pode incluir arquivos de referência — como um style guide ou um schema de banco de dados — para dar contexto extra ao Claude.
Skills moram em pastas específicas que o Claude procura: - Skills de projeto ficam em .claude/skills/ — só são carregadas naquele projeto - Skills de usuário ficam em ~/.claude/skills/ — são carregadas em todos os projetos da sua máquina
Quando uma skill é ativada, o Claude lê as instruções dela e segue, como se você as tivesse digitado na conversa.
Pontos-chave
- Skill = uma pasta contendo um arquivo SKILL.md
- SKILL.md tem duas partes: frontmatter YAML (metadados) + corpo em markdown (instruções)
- Opcional: arquivos de referência na mesma pasta fornecem contexto adicional
- Skills de projeto: .claude/skills/ — skills de usuário: ~/.claude/skills/
03 · Exemplo de código
Abaixo está como uma skill mínima aparece no disco — só uma pasta e um arquivo.
Estrutura de pastas
.claude/skills/my-skill/
└── SKILL.md
Conteúdo do SKILL.md
---
name: My First Skill
description: A simple example skill
---
When working on this project, always use TypeScript strict mode.
Prefer functional components over class components.
Use camelCase for variables and PascalCase for components.
As linhas --- delimitam o frontmatter YAML — os metadados da skill. Tudo abaixo do --- de fechamento é o corpo das instruções — as regras em linguagem natural que o Claude segue quando essa skill está ativa.
04 · Quiz
Pense no que acontece no começo de cada nova conversa do Claude Code. Qual é o principal problema que uma Claude Skill resolve?
- Você precisa repetir suas preferências a cada nova conversa
- O Claude Code roda muito devagar
- O Claude Code não consegue ler arquivos sem skills
- O Claude Code não suporta TypeScript
05 · Preencher
O arquivo principal em cada pasta de skill se chama _____.md
06 · Ler
O Claude Code procura skills em locais específicos. Quando você digita /skill em uma conversa, o Claude lista todas as skills disponíveis para você ativar.
Mas as skills também podem ser carregadas automaticamente conforme onde estão guardadas: - Skills de projeto vão em .claude/skills/ dentro do repo — ótimas para convenções de time que todo dev do projeto precisa seguir - Skills de usuário vão em ~/.claude/skills/ no seu diretório home — ótimas para preferências pessoais que andam com você por todos os projetos
Skills de projeto funcionam bem para coisas como "nossa API usa URLs em kebab-case" ou "usamos Conventional Commits". Skills de usuário funcionam para coisas como "explique as coisas" ou "sempre sugira testes".
Pontos-chave
- O comando /skill lista e ativa as skills disponíveis
- Skills de projeto (.claude/skills/) são compartilhadas com o time via git
- Skills de usuário (~/.claude/skills/) são pessoais e valem em todos os projetos
- Skills de projeto = convenções do time; skills de usuário = preferências pessoais
07 · Quiz
A regra do seu time é que toda rota de API use URLs em kebab-case. Você quer que todo dev siga isso automaticamente quando usar o Claude Code. Onde essa skill deve ficar?
- ~/.claude/skills/ aplicada a todos os seus projetos
- .claude/skills/ dentro do repo do projeto
- Um arquivo de texto na área de trabalho
- Um comentário no código-fonte
08 · Preencher
Para guardar uma skill que vale em todos os projetos da sua máquina (preferências pessoais), coloque em ~/._____/skills/
Outras lições deste capítulo
⚠ A experiência interativa completa precisa de JavaScript. Ative-o e recarregue a página.
※ Este é um projeto educacional independente — não é um produto oficial da Anthropic. Claude™ é uma marca registrada da Anthropic, PBC.