📋 Skills = SOPs para IA
Skills sao workflows reutilizaveis em markdown que o Claude pode invocar sob demanda. Em vez de redigitar o mesmo prompt complexo toda vez que precisa de uma tarefa especifica, voce escreve uma vez e chama sempre que necessario. Pense nelas como SOPs (Standard Operating Procedures) para sua IA.
🎯 Conceito Principal
Uma skill e um arquivo markdown com instrucoes estruturadas que o Claude segue passo a passo. Diferente de um prompt avulso, a skill persiste no projeto, e compartilhavel com o time e pode ser invocada com um simples slash command.
- • Escreva uma vez: Voce define o workflow completo no markdown, com objetivo, passos, verificacoes e formato de saida
-
•
Salve como arquivo: O markdown vai para
.claude/commands/no seu projeto ou no diretorio global - • Chame a qualquer momento: Use o slash command correspondente ou referencie naturalmente na conversa
- • Resultado consistente: Como um SOP, a skill garante que o output segue o mesmo padrao toda vez, independente do contexto
💡 Dica Pratica
Comece identificando tarefas que voce repete com frequencia. Se voce ja escreveu o mesmo tipo de prompt 3 vezes, e hora de transformar em skill. Exemplos comuns: code review, criacao de testes, documentacao de API, refatoracao de componentes.
A regra de ouro: se e repetitivo, vira skill. Se precisa de dados externos ao vivo, vira MCP. Se e um pacote completo, vira plugin.
📂 Onde moram as Skills (.claude/commands/)
No Claude Code, skills sao arquivos markdown (.md) armazenados em diretorios especificos. O Claude as descobre automaticamente e as torna disponiveis como slash commands. Existem dois niveis de armazenamento: projeto e global.
🎯 Conceito Principal
A estrutura de diretorios para skills segue um padrao claro e previsivel:
- • Projeto (.claude/commands/): Skills especificas do projeto, versionadas junto com o codigo. Todo o time tem acesso automaticamente
- • Global (~/.claude/commands/): Skills pessoais que funcionam em qualquer projeto. Ideais para workflows que voce usa independente do contexto
💡 Dica Pratica
Use skills de projeto para workflows especificos do codebase (ex: padrao de componentes React do projeto) e skills globais para tarefas universais (ex: template de commit message, code review generico). No Cowork, as skills vem pre-instaladas ou via plugins, sem necessidade de gerenciar arquivos manualmente.
⚖️ Skills vs MCPs vs Plugins
Tres mecanismos de extensibilidade, cada um com um proposito distinto. Confundir os tres e o erro mais comum de quem comeca. Entender quando usar cada um e o que separa usuarios basicos de power users.
🎯 Conceito Principal
| Aspecto | Skills | MCP Servers | Plugins |
|---|---|---|---|
| O que sao | Workflows reutilizaveis em markdown | Integracoes de ferramentas ao vivo | Bundles de skills + MCPs + tools |
| Custo de tokens | Quase zero ate ser chamada | ~20% do contexto so conectado | Varia, carregado sob demanda |
| Melhor para | Workflows repetitivos | Acesso externo ao vivo | Pacotes completos de workflow |
| Funciona em | Claude Code + Cowork | Claude Code + Cowork | Claude Code + Cowork |
| Regra | Repetitivo → Skill | Dados ao vivo → MCP | Workflow completo → Plugin |
💡 Dica Pratica
Antes de criar qualquer coisa, pergunte: "Preciso de dados externos ao vivo?" Se sim, MCP. "E um workflow que vou repetir?" Se sim, Skill. "Preciso de um pacote completo com ferramentas + skills + integracoes?" Se sim, Plugin.
🔍 Como Claude Descobre Skills
O Claude Code tem um mecanismo de auto-discovery que escaneia os diretorios de commands automaticamente ao iniciar uma sessao. Nao e necessario registrar, importar ou configurar nada. Basta colocar o arquivo no lugar certo e ele aparece.
🎯 Conceito Principal
O processo de descoberta funciona em cascata, verificando multiplos niveis:
-
•
Nivel 1 - Projeto: Claude escaneia
.claude/commands/na raiz do projeto aberto. Essas skills tem prioridade e sao especificas do contexto -
•
Nivel 2 - Global: Em seguida verifica
~/.claude/commands/para skills pessoais que funcionam em qualquer projeto - • Nivel 3 - Plugins: Skills instaladas via plugins tambem sao descobertas automaticamente e ficam disponiveis como slash commands
- • Zero configuracao: Nao ha arquivo de registro, nao ha import statement, nao ha build step. Coloque o .md no diretorio e o Claude descobre sozinho
💡 Dica Pratica
Para verificar quais skills estao disponiveis na sessao atual, digite / no prompt do Claude Code e espere o autocomplete listar todas as skills descobertas. Se sua skill nao aparecer, verifique se o arquivo esta no diretorio correto e se tem a extensao .md.
⚡ Invocando com Slash Commands
Uma vez que a skill esta no diretorio correto, voce a invoca com um slash command que corresponde ao nome do arquivo. O nome do arquivo (sem .md) vira o comando. Simples assim.
🎯 Conceito Principal
O mapeamento entre arquivo e comando e direto:
-
•
No Claude Code: Digite
/nome-da-skillno prompt interativo ou passe como argumento no modo nao-interativo -
•
No Cowork: Skills built-in como
/pdf,/docx,/pptx,/xlsxja vem pre-instaladas. Plugins adicionam mais slash commands automaticamente - • Referencia natural: Voce tambem pode mencionar a skill pelo nome na conversa e o Claude a identifica e segue as instrucoes
💡 Dica Pratica
Use nomes descritivos e com hifen para seus arquivos de skill. code-review.md e melhor que cr.md. O nome do comando deve ser autoexplicativo para que qualquer pessoa do time saiba o que faz sem precisar abrir o arquivo.
💰 Token Math: 90% de Economia
Alem da conveniencia, skills representam uma economia massiva de tokens. Cada vez que voce redigita um prompt complexo, esta gastando tokens desnecessariamente. Com skills, o custo por invocacao cai drasticamente.
🎯 Conceito Principal
| Abordagem | Tokens por Uso | 100 Usos |
|---|---|---|
| Redigitar prompt manualmente | ~500 tokens | ~50.000 tokens |
| Invocacao via skill | ~50 tokens | ~5.000 tokens |
Isso representa uma economia de aproximadamente 90% em tokens. Ao longo de meses de uso, a economia composta e significativa, especialmente para times que usam Claude Code diariamente. E mais: skills produzem resultados mais consistentes, o que reduz retrabalho e iteracoes adicionais.
💡 Dica Pratica
Faca o calculo para o seu caso: quantas vezes por semana voce repete prompts similares? Multiplique pelo custo medio em tokens. Essa e a economia que skills vao gerar. Para times de 5+ pessoas, o impacto e ainda maior porque todos compartilham as mesmas skills via repositorio git.
Exercicio Pratico
Hora de criar sua primeira skill seguindo o template padrao. Voce vai configurar o diretorio, escrever o markdown e testar a invocacao.
Exercicio: Criar Primeira Skill
Tempo estimado: 15-20 minutos
Criar o diretorio de commands
Navegue ate seu projeto e crie o diretorio:
Criar a skill em markdown
Crie o arquivo com o template padrao:
# Skill: Criar Componente React
## Purpose
Criar um componente React funcional com TypeScript e testes.
## Steps
1. Criar arquivo do componente
2. Adicionar tipagem TypeScript
3. Criar arquivo de teste
## Quality Checks
- [ ] Componente renderiza sem erros
- [ ] Tipos estao corretos
- [ ] Testes passam
EOF
Testar a invocacao
Abra o Claude Code e invoque a skill:
> /criar-componente Button
Verificar o resultado
Confirme que o Claude seguiu os passos da skill e gerou o componente com tipos e testes conforme especificado.
✅ Criterios de Sucesso
📋 Resumo do Modulo
Proximo Modulo:
5.2 - Anatomia de uma Skill (Template Completo)