📌 Fixar IDs
Novo aqui? Fixar um ID quer dizer dar um nome estável a uma seção, arquivo ou etapa da skill, em vez de se referir a ela por posição ("a segunda regra", "o terceiro passo"). Se alguém reordenar o `skill.md` depois, uma referência por posição quebra; uma referência por nome continua valendo.
✓ Com ID fixo
- ✓"Ver seção `#formato-saida`" — continua certo mesmo se o `skill.md` crescer
✗ Referência por posição
- ✗"Ver o passo 3" — quebra silenciosamente se alguém inserir um passo novo antes
💡 Dica Prática
Na `gerar-ata`, em vez de "veja a seção acima", use um cabeçalho markdown como `## Formato da saída` e referencie por esse título — mais fácil de manter conforme a skill cresce.
📚 Pré-carregar documentação
Lembrando o módulo 3.2: nível 3 (referências) só é lido quando o `skill.md` manda ler. Mas às vezes vale a pena trazer um resumo curto direto pro nível 2 (corpo do `skill.md`) em vez de sempre mandar "ir buscar" — se o dado é pequeno e usado toda vez, cada "ida buscar" é uma volta a mais que custa tempo e tokens à toa.
Exemplo: lista de participantes fixos pré-carregada
## Participantes frequentes (já sei quem são, não precisa perguntar)
- João (financeiro), Marcela (produto), você
## Formato de nomes desconhecidos
Se aparecer nome que não está na lista acima, pergunte o
cargo/área antes de fechar a ata.💡 Dica Prática
Regra prática: se um dado é pequeno (poucas linhas) e usado em quase toda execução, pré-carregue. Se é grande ou raro, deixe em referência separada.
🤝 Delegar a sub-agentes
Novo aqui? Um sub-agente é um "agente auxiliar" que a conversa principal pode acionar pra fazer uma parte do trabalho sozinho, em paralelo, e devolver só o resultado — sem lotar a conversa principal com todos os passos intermediários. Skills mais avançadas delegam a etapas assim quando a tarefa é grande ou pode rodar em paralelo com outra.
Exemplo — trecho de skill.md que delega
## Passo 3 — revisar o texto longo
Se as anotações passarem de 2 páginas, delegue a revisão de
consistência a um sub-agente dedicado, e só incorpore o
resultado final na ata — não processe o texto inteiro na
conversa principal.⚠️ Atenção
Delegar tudo, mesmo tarefa pequena, é exagero — cada sub-agente tem custo próprio de inicialização. Reserve delegação pra pedaços realmente grandes ou paralelizáveis.
🔁 O ciclo honesto: invocar → observar → corrigir → repetir
Verdade sem enfeite: nenhuma skill nasce perfeita. A `gerar-ata` que você testou no módulo 3.6 provavelmente ainda erra em algum caso — nome mal escrito, decisão ambígua, seção vazia. Isso é normal. O que separa uma skill boa de uma abandonada é passar pelo ciclo várias vezes: invocar de novo, observar onde errou, corrigir uma frase do `skill.md`, repetir. Na prática, a maioria das skills só fica realmente confiável lá pela décima execução.
Legenda: as quatro etapas se repetem em círculo — a skill vai ficando mais confiável a cada volta, não na primeira tentativa.
🔗 Skill = workflow + tools do WAT
Fechando o círculo com a Trilha 1: o framework WAT (Workflow, Agent, Tools) descreve qualquer automação como um workflow (o quê fazer, em que ordem) executado por um agente, usando ferramentas (com o quê fazer). Uma skill é exatamente essa dupla workflow+tools, só que empacotada num formato reutilizável: o `skill.md` inteiro é o workflow escrito; os scripts e arquivos de referência são as tools que esse workflow aciona.
Legenda: skill = workflow do WAT empacotado; scripts e referências = as tools que esse workflow usa; o agente é quem executa os dois juntos.
🏁 Fechando a Trilha 3
Você percorreu sete módulos: a anatomia de uma skill (3.1), por que 3 níveis de carregamento fazem 20 skills não pesarem (3.2), o framework de 6 passos pra escrever uma boa (3.3), como a description dispara o uso certo (3.4), quando escolher pasta de projeto ou pasta global (3.5), construiu a `gerar-ata` do zero (3.6), e agora sabe otimizar e ser honesto sobre o ciclo de melhoria (3.7).
✅ Copy-run — auditoria rápida de uma skill sua
Objetivo: pedir ao Claude Code pra revisar uma skill já existente contra tudo que você viu nesta trilha.
Leia a skill em ~/.claude/skills//skill.md e me
diga: a description é específica o bastante? o corpo tem
passo a passo claro? há algo que deveria virar referência
separada? sugira 3 melhorias objetivas. Como verificar: as sugestões devem citar trechos concretos do seu `skill.md`, não conselho genérico.
Checklist final da Trilha 3
- ☐ Sei explicar o que é uma skill sem jargão pra alguém leigo
- ☐ Entendo por que 20 skills instaladas não pesam no contexto
- ☐ Escrevi e testei minha primeira skill
- ☐ Sei quando usar pasta de projeto vs. pasta global
- ☐ Sei o que fixar IDs, pré-carregar e delegar a sub-agentes significam
Exercício de revisão: escolha uma tarefa repetitiva sua fora deste curso e esboce o `skill.md` dela seguindo o framework de 6 passos do módulo 3.3 — não precisa implementar agora, só escrever o esqueleto.