🎯 O que é uma Skill
Bloco de instruções + recursos que o modelo invoca quando reconhece um padrão de pedido. Reutilizável entre projetos — DRY do prompting.
🧠 Por que skills?
Sem skills: você copia a mesma orientação em 10 projetos diferentes. Muda algo? edita em 10 lugares.
Com skills: orientação vive numa skill nomeada; usa onde precisa; muda num lugar só.
⚙️ Anatomia de uma skill
Três partes: nome curto, descrição clara, conteúdo. A descrição é o que dispara — se ela for vaga, modelo não acha a skill.
NOME:
revisao-pr-backend
DESCRIÇÃO (o trigger):
Use quando o usuário pede revisão de Pull Request backend Node.js/TS.
Aciona em frases como "revisa esse PR", "code review", "olha esse código".
CONTEÚDO (procedimento):
1. Identifica o tipo de mudança (feature, bug, refactor)
2. Lista problemas em ordem: segurança > correção > manutenibilidade
3. Cada finding tem [SEVERIDADE] arquivo:linha + sugestão
4. Não comenta estilo (linter resolve)/ Slash Commands
Quando você sabe exatamente o que quer, slash é mais rápido que prosa. Comandos prefixados com `/` invocam comportamento direto.
🤖 Quando vira agent
Caso pede execução autônoma multi-passo (ler/escrever arquivos, rodar comandos)? Passa de Cowork pra Code ou API com tool use.
✓ Skill no Cowork
- ✓ Procedimento conversacional
- ✓ Modelo guia humano
- ✓ Humano executa as ações
- ✓ Output é texto
→ Agent (Code/API)
- → Procedimento autônomo
- → Modelo executa diretamente
- → Acessa filesystem, shell, APIs
- → Output é ação no mundo
📚 Reuso entre projetos
Skill criada uma vez atende múltiplos projetos. Em Team/Enterprise, fica compartilhada e curada centralmente.
Library compartilhada
Workspace mantém uma biblioteca de skills do time. Cada projeto opt-in nas relevantes.
Manutenção centralizada
Muda em 1 lugar, propaga pra todos os projetos que usam. Como dependência.
Versionamento
Skills críticas têm changelog. Mudança breaking = nova versão; antiga fica disponível pra rollback.
⚠️ Anti-padrão: skill pra tudo
Time cria 50 skills, modelo fica confuso na hora de escolher, performance cai. Curadoria vence acúmulo.
🛑 Sinais de biblioteca inchada
- • Skills com descrição muito parecida
- • Skills que ninguém usa há 3 meses
- • Skills que fazem 3 coisas diferentes
- • Owner = "todo mundo / ninguém"
✓ Biblioteca enxuta
- ✓ 10-20 skills bem definidas
- ✓ Cada skill tem owner e changelog
- ✓ Revisão trimestral; deprecar antigas
- ✓ Onboarding documenta as principais
✅ Resumo do Módulo
Próximo módulo:
3.5 — Manutenção e drift