📦 O que é uma skill
Uma skill é uma pasta com um arquivo SKILL.md (instruções) e opcionalmente uma pasta references/ (material extra). O Claude carrega a skill quando detecta um gatilho descrito no seu frontmatter.
Estrutura da fs-seis-chapeus
fs-seis-chapeus/
├── SKILL.md # ← corpo + frontmatter
└── references/
├── variants.md # ← 7 ordens de chapéus
├── divergence-frameworks.md # ← 10 marcos divergentes
├── anti-patterns.md # ← erros comuns
└── examples.md # ← casos aplicados📝 Frontmatter YAML
Metadados entre --- no topo do SKILL.md. Dois campos: name e description.
---
name: fs-seis-chapeus
description: Análise estruturada pelos Seis Chapéus de De Bono
com sistema anti-âncora integrado e isolamento estrito entre fases.
Use SEMPRE que o usuário quiser analisar uma funcionalidade complexa,
avaliar uma decisão difícil, desbloquear um conflito de equipe...
---
# fs-seis-chapeus — Seis Chapéus + Anti-Âncora
...💡 O frontmatter é sempre lido
O description é a única parte da skill que o Claude sempre tem em contexto. É ele que decide se a skill ativa. O corpo só é carregado depois.
🔑 O campo name
Nome único da skill. Kebab-case, descritivo mas curto. Deve casar com o nome da pasta.
✓ Bons nomes
- fs-seis-chapeus
- fs-code-review
- fs-pre-mortem
- fs-decision-personal
✗ Nomes ruins
- ThinkingMethod (camelCase)
- six_hats (underscore)
- method (muito genérico)
- my-super-amazing-skill (verboso)
💡 Padrão com prefixo
Se você tem múltiplas skills, prefixo fs- (ou outro) ajuda a agrupar no filesystem. Quando você tem 20 skills, aparece junto na listagem.
🎯 O campo description (o roteador)
Texto de 200-400 palavras que descreve QUANDO a skill deve ativar. É o único texto sempre carregado — use bem cada palavra.
As partes do description
📄 O corpo (SKILL.md)
Markdown com todas as regras operacionais. Só carregado quando a skill ativa. Pode ser mais verboso que o description, mas cada linha tem custo em contexto.
Seções típicas do corpo
- 1.Título + frase resumo
- 2.Quando NÃO usar (reforça exclusões)
- 3.Fluxo/Fases — o processo que a skill executa
- 4.Regras não-negociáveis
- 5.Formato de saída — template
- 6.Checklist final antes de entregar
- 7.Referências aos arquivos em
references/
📁 A pasta references/
Material carregado sob demanda. O Claude só abre esses arquivos quando o SKILL.md referencia explicitamente (ex: "ver references/variants.md").
💡 Regra prática
Tudo que toda sessão precisa vai no SKILL.md. Tudo que só às vezes precisa vai em references/. Economia de contexto.
📝 Resumo do Módulo
Próximo Módulo:
3.2 - A description como roteador