Documentação

O que são Claude Agent Skills?

Uma Claude Agent Skill é um arquivo SKILL.md que ensina ao Claude conhecimento de domínio, convenções, fluxos de trabalho e boas práticas — tudo em texto simples.

Como as Skills funcionam

  1. 1 Coloque um arquivo SKILL.md no seu projeto (ou no diretório ~/.claude/skills/).
  2. 2 O Claude o lê no início de cada sessão — absorvendo o conhecimento sem prompts repetidos.
  3. 3 As Skills usam carregamento lazy: o Claude vê primeiro apenas o nome e a descrição, lendo o arquivo completo somente quando relevante — economizando tokens.

Exemplos

  • ▸Uma skill Laravel que conhece a arquitetura, convenções de nomenclatura e padrões comuns do seu app.
  • ▸Uma skill de auditoria de segurança com checklists OWASP e procedimentos de revisão de código.
  • ▸Uma skill de diretrizes de marca para que o Claude sempre escreva com a voz da sua empresa.

Carregamento Lazy

As Skills são eficientes em tokens. O Claude vê primeiro apenas o nome e uma descrição de uma linha. Ele só lê o SKILL.md completo quando a tarefa atual é relevante — assim você pode ter muitas Skills instaladas sem sobrecarregar o contexto.

Skills vs Ferramentas MCP

Skills e ferramentas MCP (Model Context Protocol) são complementares — resolvem problemas diferentes.

Skills

  • ✓Fornecem conhecimento, expertise e fluxos de trabalho
  • ✓Texto simples — sem execução de código
  • ✓Funcionam na web, desktop e CLI
  • →Ideal para: convenções, conhecimento de domínio, estilo de escrita

Ferramentas MCP

  • ✓Conectam a APIs, bancos de dados e ferramentas externas
  • ✓Executam código e fazem chamadas de rede
  • ✓Requerem desktop ou CLI (não web)
  • →Ideal para: dados em tempo real, operações de arquivo, integrações
Primeiros passos → Explorar catálogo