Criando uma skill

Um arquivo com descrição e corpo

Depois de comandos e subagentes, o formato da skill vai soar familiar: é um arquivo de texto. Uma skill fica numa pasta com o nome dela, e dentro dessa pasta há o arquivo principal que a define. Esse arquivo tem duas partes, como os subagentes. A primeira é um cabeçalho, com a descrição, aquele texto que diz o que a skill faz e quando usá-la, e que guia o acionamento. A segunda é o corpo, escrito em texto normal, com as instruções que o agente segue quando a skill é acionada, o procedimento em si. Cabeçalho com a descrição, corpo com o passo a passo: essa estrutura simples é o coração de qualquer skill.

O nome da pasta tem um papel duplo: identifica a skill e vira o jeito de chamá-la manualmente. Uma skill numa pasta chamada revisar-seguranca pode ser acionada por você digitando esse nome, como um comando. Assim, a mesma skill funciona das duas formas que você viu: automaticamente, quando o agente casa a tarefa com a descrição, e manualmente, quando você a chama pelo nome. Essa unificação com os comandos não é coincidência: como você aprendeu, os comandos personalizados são a forma mais simples de skill. Um comando é uma skill de um arquivo só; uma skill completa pode ter mais, como a próxima aula mostra.

Escopo e organização das skills

O escopo das skills segue a mesma lógica que você já domina da memória, dos comandos e dos subagentes. Uma skill pode ficar na pasta de skills do projeto, sendo compartilhada com o time pelo controle de versão, ou na sua área pessoal, valendo em todos os seus projetos. Skills que codificam procedimentos específicos de um projeto, como o padrão de documentação daquela base, vão no projeto. Skills genéricas, que refletem o seu jeito de trabalhar em qualquer lugar, vão na sua área pessoal. A pergunta é sempre quem mais se beneficia disto, e colocar cada skill no escopo certo mantém a sua coleção organizada e relevante.

Skills de projeto têm o mesmo poder de espalhar boas práticas que você viu nos comandos e subagentes. Uma skill de projeto que empacota o método de revisão da equipe fica disponível para todos que abrem o projeto, garantindo que qualquer pessoa, com a ajuda do Claude Code, siga o mesmo procedimento. É uma forma de transformar o conhecimento tácito do time, aquele jeito de fazer que só os veteranos conhecem, em algo explícito e reutilizável por qualquer um. Colocar as boas práticas da equipe em skills de projeto é um investimento que se paga sempre que alguém novo chega e já herda os métodos consolidados, sem precisar de um longo período de aprendizado informal.

Vale saber que o Claude Code costuma já vir com algumas skills prontas, criadas pela Anthropic, e que outras podem chegar por meio dos plugins, tema do horizonte deste módulo. Isso significa que, mesmo antes de criar as suas, você já pode ter habilidades úteis à disposição. Ainda assim, as skills mais valiosas costumam ser as suas, porque elas capturam os seus procedimentos específicos, aquilo que nenhuma skill genérica conhece. Por isso, aprender a criar as próprias é o que realmente destrava o poder desse recurso: transformar os seus métodos em habilidades permanentes do agente.

O jeito fácil: pedir ao Claude Code

Como nos subagentes, você não precisa escrever o arquivo da skill à mão. O caminho mais fácil e recomendado é pedir ao próprio Claude Code para criá-la. Você descreve o procedimento que quer empacotar, algo como crie uma skill que gera um relatório de mudanças no formato que eu vou descrever, e o agente monta o arquivo, com a descrição e o corpo bem estruturados. Depois, você lê o que ele gerou, refina a descrição para garantir o acionamento certo, ajusta as instruções e está pronto. É a mesma filosofia do curso inteiro: você decide a intenção, o agente cuida da mecânica, e o resultado sai a quatro mãos.

Com a sua primeira skill criada, você tem uma habilidade nova e permanente no Claude Code, empacotada e sob demanda. A próxima aula mostra como levar as skills além de um arquivo só, enriquecendo-as com arquivos de apoio, como modelos para o agente preencher, exemplos do formato esperado e referências detalhadas. É aí que a skill deixa de ser um simples procedimento e vira um pacote completo de conhecimento, capaz de guiar tarefas mais sofisticadas. Você vai ver que a estrutura simples que aprendeu aqui é a base sobre a qual skills poderosas são construídas.