Guia de Skills do Claude

Problema: Colas as mesmas linhas no Claude Code em cada nova sessão. "Segue as nossas diretrizes de marca." "Usa o nosso processo de deployment." "Verifica os padrões de segurança primeiro." Tokens queimados. Minutos perdidos. Metade das regras esquecidas de qualquer forma.

Vitória rápida: Cria a tua primeira skill em menos de um minuto:

.claude/skills/my-skill/SKILL.md

---
name: code-review
description: Reviews code for security and performance issues
---
 
# Code Review Process
 
1. Check for SQL injection vulnerabilities
2. Verify input validation exists
3. Confirm error handling patterns

Isso é uma skill completa. Coloca a pasta no teu projeto. O próximo pedido de revisão vai puxá-la automaticamente.

O que São Skills?

Uma skill é uma pasta de instruções que o Claude encontra e carrega a pedido. Pensa num armário de manuais de referência curtos, abertos apenas quando o tema encaixa.

Os prompts desaparecem depois de um turno. Os servidores MCP ligam o Claude a ferramentas externas. As skills ficam no meio: ensinam como fazer as coisas. Conhecimento processual. Fluxos de trabalho, checklists, estilo da casa, know-how de domínio.

Simon Willison colocou um número nisso: "Each skill only takes up a few dozen extra tokens, with the full details only loaded in should the user request a task that the skill can help solve."

Como Funciona a Divulgação Progressiva

O carregamento acontece em duas fases para manter a janela de contexto leve.

Fase 1 - Apenas Metadados (~100 tokens): O Claude vê apenas o nome e a descrição curta de cada skill. Suficiente para perceber o que está disponível.

Fase 2 - Instruções Completas (quando necessário): O corpo entra no momento em que o Claude decide que uma skill encaixa na tua tarefa. Esse corpo normalmente fica abaixo dos 5.000 tokens.

my-skill/
├── SKILL.md              # Core instructions (loads when needed)
├── scripts/              # Automation scripts
├── references/           # Documentation Claude can read
└── assets/               # Templates and files

Podes carregar dezenas de skills desta forma sem sobrecarregar a memória de trabalho do Claude.

Skills vs Tudo o Resto

Aqui está como as skills se comparam com o resto da stack:

Distinção principal: Projects dizem "aqui está o que precisas de saber." Skills dizem "aqui está como fazer as coisas." MCP diz "aqui está como ligar."

Quando Criar uma Skill

A regra: Qualquer instrução que coles em mais de uma conversa deve tornar-se uma skill.

Bons candidatos para skills:

• Diretrizes de marca e regras de estilo
• Checklists de revisão de código
• Procedimentos de deployment
• Padrões de auditoria de segurança
• Templates de documentação
• Convenções de commit do git

Não ideal para skills:

• Pedidos pontuais
• Contexto específico do projeto (usa Projects em vez disso)
• Acesso a APIs externas (usa MCP em vez disso)

Escrever um SKILL.md Eficaz

Três partes entram em cada skill:

---
name: my-skill
description: What it does and WHEN to trigger it
allowed-tools: "Read,Write,Bash"
---
 
# Clear Purpose Statement
 
## Step-by-Step Instructions
 
1. First action
2. Second action
3. Expected output

Crítico: O campo description é o que o Claude analisa para decidir se a tua skill dispara. Sê específico sobre o gatilho. "When user requests code review" bate "Helps with code."

Skills Pré-Construídas da Anthropic

A Anthropic publica um conjunto oficial de skills prontas a usar:

• pdf: Extrai texto e tabelas de documentos PDF
• docx: Cria e edita documentos Word com alterações rastreadas
• xlsx: Manipula folhas de cálculo Excel
• pptx: Gera apresentações PowerPoint
• brand-guidelines: Aplica estilização consistente

Obtém-nas em github.com/anthropics/skills, ou cria as tuas com o mesmo padrão. O Claude Code também traz /simplify e /batch como integrados para revisões e migrações em toda a base de código. Configuração zero.

Erros Comuns

Descrições vagas: "This skill helps with documents" nunca vai disparar de forma fiável. Nomeia o gatilho em voz alta.

Instruções sobrecarregadas: O teu SKILL.md deve ficar abaixo das 5.000 palavras. Empurra docs longos para ficheiros de referência que a skill pode apontar.

Limites em falta: Diz em voz alta o que a skill não deve tocar. Isso evita que dispare em prompts para os quais não foi feita.

Próximos Passos

1. Cria uma skill que cubra a instrução que repetes mais
2. Testa o disparo usando pedidos do mundo real, não apenas comandos explícitos
3. Itera quando sessões reais mostrarem o que precisa de ser afinado
4. Aprofunda a gestão de contexto para mais rendimento por skill
5. Lê sobre context engineering para ver onde as skills se encaixam numa stack de AI em produção

O Claude passa de generalista a especialista quando as skills estão em uso, e o imposto de contexto nas explicações repetidas desaparece. A tua expertise torna-se portátil. Para um kit de trabalho em vez de uma pasta em branco, o Code Kit da ClaudeFast traz 20+ skills de produção em 21 categorias (padrões React a operações de base de dados), mais um SkillActivationHook que escolhe a skill certa em cada prompt.

Um dos cinco movimentos que os melhores engenheiros agentic fazem todos os dias. O conjunto completo vive no nosso guia de melhores práticas do Claude Code.