Skills com arquivos de apoio

Além do arquivo principal

O arquivo principal de uma skill é o suficiente para procedimentos simples. Mas skills poderosas costumam ir além, com arquivos de apoio dentro da mesma pasta. Lembre que a skill vive numa pasta com o seu nome; nada impede que essa pasta tenha, além do arquivo principal, outros arquivos que o agente pode usar quando a skill roda. Isso transforma a skill de um simples texto de instruções num pacote completo, capaz de guiar tarefas mais sofisticadas. É a diferença entre dar a alguém uma lista de passos e dar um kit completo com a lista, os modelos, os exemplos e as ferramentas, tudo pronto para a tarefa.

Os tipos de arquivo de apoio mais úteis atendem a necessidades diferentes. Um modelo é uma estrutura pronta para o agente preencher, como um esqueleto de relatório, garantindo que a saída venha sempre no formato certo. Um exemplo mostra o resultado esperado, o que ajuda o agente a acertar o tom e o estilo. Uma referência traz conhecimento detalhado que seria longo demais para o arquivo principal, como uma tabela extensa ou uma documentação específica. E um script é um programa que a skill pode executar como parte do procedimento. Cada um resolve um tipo de necessidade, e juntos permitem skills que fazem coisas realmente elaboradas.

Carregados sob demanda, sem inchar

O mesmo princípio do carregamento progressivo se aplica aos arquivos de apoio, e é isso que os torna viáveis. O arquivo principal da skill menciona os arquivos de apoio e explica quando usar cada um, mas o conteúdo deles só é carregado quando o agente realmente precisa, no meio da tarefa. Assim, uma skill pode ter uma referência de mil linhas sem que essas mil linhas pesem no contexto até o momento em que forem necessárias. É a biblioteca dentro da biblioteca: a skill é um livro que você abre sob demanda, e os arquivos de apoio são apêndices que você consulta só quando a tarefa pede. Nada pesa antes da hora.

Esse mecanismo permite skills de uma profundidade que seria impensável no CLAUDE.md. Você pode empacotar todo o conhecimento de um procedimento complexo, as instruções, os modelos, os exemplos, as referências, numa única skill, e ela continua barata até ser usada. Uma skill de escrever documentação, por exemplo, pode conter o guia de estilo completo da empresa como referência, o modelo de cada tipo de documento e exemplos de documentos bem escritos, tudo isso disponível para o agente no instante em que ele escreve uma documentação, e invisível no resto do tempo. É poder de conhecimento sem o custo de tê-lo sempre presente.

Um cuidado de segurança, ligando com módulos anteriores: skills que executam scripts ou usam ferramentas operam dentro das suas permissões, como tudo no Claude Code. Uma skill não é uma porta para burlar as suas regras; ela roda sob as mesmas checagens. Isso vale especialmente para skills que vêm de fora, de plugins ou da comunidade: como qualquer conteúdo de terceiros, elas merecem uma olhada antes de você confiar, porque uma skill executa instruções. Criar as suas skills é seguro por natureza, já que você as escreveu; adotar skills de fora pede o mesmo cuidado que você teria com qualquer código ou instrução que não é seu.

Quando uma skill precisa crescer

Nem toda skill precisa de arquivos de apoio; muitas resolvem tudo com o arquivo principal. O sinal de que uma skill deve crescer é quando você percebe que ela ficaria melhor com um modelo pronto, um exemplo concreto ou uma referência que não caberia bem no meio das instruções. Comece simples, com só o arquivo principal, e adicione arquivos de apoio quando a necessidade aparecer. É a mesma filosofia de moderação do curso: não construa complexidade antes de precisar. Uma skill enxuta que resolve o problema é melhor que uma inchada de arquivos que ninguém usa. Deixe a skill crescer conforme o procedimento realmente ganha profundidade.

Com os arquivos de apoio, você conhece todo o potencial das skills: de um procedimento simples num arquivo a um pacote rico de conhecimento com modelos, exemplos e referências, tudo carregado sob demanda. A última aula do módulo fecha o quadro, mostrando como skills, comandos e subagentes se relacionam e quando usar cada um, e como os plugins levam tudo isso para o compartilhamento em escala. Você já tem em mãos um dos recursos mais poderosos do Claude Code para moldá-lo aos seus métodos, e sabe usá-lo do jeito simples ao sofisticado, conforme a tarefa merecer.