A objeção, dita antes que você pense nela
“As Skills são oficiais, e já são arquivos meus”
Verdade em todos os pontos, e não vamos fugir disso. Uma Skill é uma pasta com um SKILL.md dentro: duas linhas de front matter — um nome e uma descrição — e depois texto. É markdown, é seu, vive no git, e se você mudar de ideia amanhã, leva junto. Ninguém prendeu você a nada.
O mecanismo também é bem desenhado. Enquanto a Skill não é necessária, só a descrição dela fica na memória — umas cem palavras; o corpo é carregado quando a IA decide que é relevante, e os arquivos de apoio só se ela de fato os abrir. Chama-se divulgação progressiva, e é o jeito certo de dar cem competências a uma IA sem pagar por todas elas em cada frase.
Então não: esta página não existe para dizer que as Skills são mal feitas. Ela existe porque esse mecanismo, que para uma capacidade é uma virtude, para uma identidade é o defeito.
O ponto é quando ela entra no contexto
Uma Skill entra quando é necessária. Essa é toda a sua elegância: não ocupa espaço até haver um motivo, e a IA reconhece o motivo lendo a descrição. Perfeita para “montar uma apresentação segundo as nossas regras”, algo de que se precisa na terça e não na quinta.
Uma identidade não funciona assim. Quem você é não é uma competência que liga quando o assunto pede: é aquilo que já está lá antes de você abrir a boca, e decide como você lê a pergunta. Algo que só aparece quando é chamado não é um caráter, é um manual.
É a mesma diferença que existe entre saber cozinhar e estar com fome. O primeiro é tirado da gaveta quando necessário; o segundo move você mesmo quando você não está pensando em comida.
E há uma coisa que uma Skill não tem
Em um SKILL.md não existe jeito de escrever você não pode reescrever esta parte. Isso não é descuido: uma Skill é algo que você dá à IA para que ela use, e não há nada a defender.
Em um Reminder, por outro lado, há alguém que lê, entende e pode reescrever — e por isso cada bloco declara quanto dele é seu: das regras que só você pode mudar até as anotações que a IA atualiza sem perguntar. É a diferença entre um manual e uma constituição, e é também por isso que o Reminder tem uma estrutura em vez de ser prosa.
Em duas colunas
| | Uma Skill | Um Reminder |
|---|
| O que responde | como se faz uma coisa | quem é quem a faz |
| Quando entra no contexto | quando a IA julga que é relevante | sempre, desde a primeira linha |
| O que contém | um procedimento, alguns exemplos, alguns scripts | núcleos, módulos, memórias, permissões |
| Quem pode reescrevê-lo | você, fora da conversa | depende da zona: está declarado dentro do arquivo |
| Se você o tirar | a IA deixa de saber fazer aquela coisa | a IA deixa de ser alguém |
| O que ela lembra | nada: amanhã é igual a hoje | como foi: na memória associada do módulo |
Onde elas ficam juntas, o que acontece quase sempre
Não é uma coisa ou outra, e não vale a pena transformar nisso. A divisão que funciona é limpa: Skills para as capacidades, o Reminder para a identidade. Mesma conversa, sem conflito — porque elas não disputam o mesmo lugar.
Com agentes de programação a mesma divisão já tem casa: o arquivo que o agente lê ao iniciar — CLAUDE.md, AGENTS.md — é onde vai a identidade, e as Skills continuam sendo os procedimentos que essa identidade sabe executar.
E a fronteira é mais porosa do que parece. Uma Skill que você já tem se traduz em um módulo, quase linha por linha: não há nada a reinventar, porque as duas formas respondem às mesmas quatro perguntas.
- A descrição: o que faz e quando usar
→- ### FUNCTION · ### TRIGGER
- As instruções, os passos a seguir
→- ### ROUTINE
- O que não fazer, os limites
→- ### LIMITI
- Os exemplos de entrada e de saída
→- ### ESEMPIO
Vale também no sentido contrário, e essa é a parte surpreendente. O que é obrigatório em um SKILL.md são duas linhas de front matter — um nome e uma descrição. Abaixo disso você é livre: ninguém prescreve a estrutura do corpo. Que as Skills costumem ser escritas como prosa solta é um hábito difundido, não uma regra — e as próprias diretrizes da Anthropic recomendam passos numerados, modelos de saída e exemplos, que é exatamente a forma que um módulo já tem. Cabe sob o front matter sem reescrever nada.
Só uma coisa não atravessa, e vale dizer. Dentro de um módulo a linha que declara você não reescreve esta parte tem um lugar, e o app a faz valer; dentro de um SKILL.md essa linha não tem onde ficar, e nenhum app está no circuito para defendê-la — os marcadores de zona continuam ali como texto, e ninguém os aplica. Traduzir uma capacidade funciona perfeitamente. Traduzir identidade, não: e é só isso que esta página está dizendo.
O terceiro caminho: não traduzir, enxertar
Traduzir uma Skill em um módulo é um caminho. O outro é não traduzi-la de jeito nenhum. O corpo de um SKILL.md é markdown, e um módulo o hospeda exatamente como está, sob uma linha que declara de quem é aquele pedaço: no Standard ela se chama ### SUB-MODULE:, e embaixo dela vai o texto inteiro da Skill — a função, os passos, os exemplos. Nada é reescrito. Você declara de quem é e onde fica.
## MODULE 07: ...
### FUNCTION
### SUB-MODULE: SKILL_A
#### FUNCTION
#### ROUTINE
### SUB-MODULE: SKILL_B
#### FUNCTION
#### ROUTINE
[P4]
### ASSOCIATED MEMORY
[/P4]
O que o módulo acrescenta ao redor são as duas coisas que um SKILL.md não tem onde pôr. A primeira é a zona de permissão: o texto enxertado fica dentro de um bloco que declara quem pode reescrevê-lo, e essa recusa quem faz é o app, não o modelo. A segunda é ### ASSOCIATED MEMORY, a seção onde se assenta o que você aprende usando-a — que esses passos, para você, vão em outra ordem; que com os seus arquivos aquela etapa não se sustenta; que você quer a saída mais curta. A Skill sabe como se faz. O módulo lembra como foi.
E um módulo comporta mais de uma. Se três Skills trabalham no mesmo ofício — ler um PDF, extrair uma tabela dele, escrever o resumo — você pode enxertá-las no mesmo módulo, uma por ### SUB-MODULE:. A partir daí elas não se acendem mais uma de cada vez: entram no contexto juntas, quando o módulo entra, e enxergam umas às outras. É uma escolha sua, e é o momento em que você deixa de fazer revelação progressiva.
O preço é declarado: você paga pelas três toda vez que aquele módulo está ativo, inclusive no dia em que só precisava de uma. O que você compra é que elas param de se contradizer — uma memória associada em vez de três, uma regra escrita uma vez em vez da mesma frase em três lugares, e nenhum trabalho deixado pela metade porque a IA tinha carregado uma delas e não a outra. Se o ofício é um, o módulo é um. Se são três ofícios, mantenha-os separados e deixe que se acendam quando preciso: esse é exatamente o caso em que uma Skill sozinha cumpre seu papel melhor do que isto.
Uma coisa que hoje você faz à mão, e vale saber de antemão: o enxerto é um copiar e colar, e a partir daquele momento a cópia é sua. Se o autor da Skill publicar uma nova versão, é você quem decide se a traz — o texto está ali à vista, dentro do seu arquivo, e se atualiza do jeito que um arquivo se atualiza. É o mesmo acordo de todo o resto: nada se move debaixo de você sem que você possa ver.
Em uma linha
Uma Skill é algo que a sua IA sabe fazer. Um Reminder é quem ela é enquanto faz. Fique com os dois: eles não se atrapalham, porque não estão no mesmo lugar.