Como a skill é descoberta e carregada

Só a descrição fica sempre visível

Aqui está o mecanismo que torna as skills tão elegantes: o carregamento progressivo. De cada skill disponível, o Claude Code mantém sempre à vista apenas a descrição, aquele resumo curto do que a skill faz e quando usá-la. O conteúdo completo da skill, que pode ser longo, um procedimento detalhado, um checklist extenso, uma referência grande, não fica no contexto o tempo todo. Ele só é carregado quando a skill é de fato acionada. Isso significa que você pode ter dezenas de skills, algumas bem grandes, e elas custam quase nada de contexto até serem usadas, porque só as descrições curtas estão presentes.

Essa é a diferença crucial em relação ao CLAUDE.md, que você viu carregar sempre por inteiro. Se você colocasse um procedimento de trezentas linhas no CLAUDE.md, ele pesaria em toda sessão. A mesma coisa numa skill pesa zero até o momento em que você precisa dela, quando o conteúdo entra em cena, é usado, e sai. É como uma biblioteca: você não carrega todos os livros na cabeça o tempo todo; você guarda o índice, sabe onde cada assunto está, e abre o livro certo só quando precisa. As skills dão ao Claude Code exatamente essa biblioteca de procedimentos, com um índice barato e o conteúdo sob demanda.

Acionar uma skill: automática ou manual

Como no caso dos subagentes, uma skill entra em ação de duas maneiras. A automática funciona pela descrição: o Claude Code lê as descrições das skills disponíveis e, quando uma tarefa combina, aciona aquela skill, carregando o seu conteúdo e seguindo as suas instruções. A manual é você chamar a skill pelo nome, como um comando, garantindo que ela seja usada naquele momento. As duas convivem e servem a situações diferentes. A automática é ótima para o agente aplicar a skill certa sem você lembrar; a manual é útil quando você quer garantir o uso ou quando a skill é do tipo que você prefere acionar conscientemente.

Você tem controle sobre esse comportamento. Uma skill pode ser configurada para só aceitar a invocação manual, ou seja, para o Claude Code nunca acioná-la sozinho, apenas quando você a chama pelo nome. Isso é útil para procedimentos que você quer disparar de forma deliberada, e não automaticamente, como uma skill de deploy que você só quer rodar quando decidir. Por padrão, porém, as skills podem ser acionadas automaticamente pela descrição, o que é o mais comum e conveniente. Essa flexibilidade deixa você decidir, skill por skill, se prefere que o agente a use por conta própria ou só sob o seu comando explícito.

Assim como nos subagentes, a descrição é o campo que faz o acionamento automático funcionar. Se a descrição de uma skill é vaga, o Claude Code não sabe quando usá-la, e ela fica esquecida. Se é clara e específica sobre o que a skill faz e quando aplicá-la, o agente a aciona na hora certa. Por isso, escrever boas descrições é uma habilidade que se repete: vale para comandos, para subagentes e para skills. A regra é sempre a mesma, ser concreto sobre o serviço prestado e o gatilho de uso, e ela decide se a sua habilidade empacotada realmente entra em ação quando deveria.

O índice barato que muda a escala

O carregamento progressivo muda a escala do que é possível. Como cada skill custa quase nada até ser usada, você não precisa racionar skills com medo de encher o contexto. Pode ter uma biblioteca rica de procedimentos, um para cada tipo de tarefa recorrente, e o agente puxa o certo na hora. Isso é diferente do CLAUDE.md, onde você precisa ser econômico porque tudo carrega sempre. Com skills, a economia é automática: o índice, as descrições, é leve, e o conteúdo só ocupa espaço no instante do uso. Você ganha profundidade sem pagar o preço de contexto, o que é uma combinação rara e valiosa.

Com o carregamento e o acionamento entendidos, você compreende por que as skills são um recurso tão poderoso: elas dão profundidade sem peso e são acionadas na hora certa pela descrição. A próxima aula mostra o lado prático, como criar a sua própria skill, que, como você já imagina pelos comandos, é surpreendentemente simples, um arquivo com uma descrição e um corpo de instruções. Você vai transformar aquele procedimento que repete toda semana numa habilidade permanente do agente, empacotada e sob demanda, exatamente como uma boa skill deve ser.