O que é uma skill do Claude Code?

Como uma skill funciona

O SKILL.md começa com um cabeçalho que dá nome à skill e diz quando ela deve disparar, e segue com os passos que o agente executa. Ele mora numa pasta de skills do projeto ou da sua conta, e o agente o lê quando você chama o comando ou quando a descrição casa com o pedido. Não tem build, não tem pacote: é um arquivo de texto no lugar certo.

Algumas skills trazem scripts junto, e a maioria funciona também em outros agentes que aceitam skills, como Codex e Cursor. O que muda entre uma skill boa e uma ruim é o mesmo que muda num procedimento escrito pra uma pessoa: ela diz o que conferir antes, o que fazer em cada caso e quando parar e perguntar.

Exemplos da casa

Este site é feito com skills. A /implement é a porta de entrada de toda tarefa: isola a sessão num worktree, confere os documentos do projeto, valida o pedido contra o código atual e faz um plano curto. A /test-and-ship roda o gate (typecheck, build e contraste), conserta até ficar verde e só então commita e sobe. A /ship sobe sem o gate, quando a mudança é só de documento. Há ainda as que criam e publicam um infoproduto a partir da pasta dele no repositório.

Os produtos do catálogo seguem a mesma lógica: uma skill que fixa a identidade visual do projeto num arquivo que o agente lê antes de desenhar qualquer tela, e um pacote de coleções de design curadas, com guia em português de qual usar em cada momento.

O cuidado que vem junto

Uma skill não é uma biblioteca. É instrução que o seu agente vai obedecer, com as suas permissões, na sua máquina, dentro dos seus repositórios. Ela pode mandar o agente ignorar uma regra de segurança ou esconder uma ordem em texto invisível no meio de um parágrafo normal, sem uma linha de código executável. Skill de terceiro se lê, ou se passa por um verificador, antes de instalar.

Quando isso importa

• Você viu um comando com barra, tipo /implement, num vídeo ou no Discord e quer saber o que acontece quando ele roda.
• Você repete a mesma sequência de instruções pro agente toda vez e quer escrever isso uma vez só.
• Você encontrou uma pasta de skills num repositório e está decidindo se copia pro seu projeto.

Nossa posição

A gente publica skill quando ela resolve um problema que voltava toda semana, e cada uma diz o que não faz. Skill pra encher catálogo não entra: a página de produtos avisa isso com todas as letras. E toda skill de terceiro passa pelo verificador de segurança antes de entrar numa máquina da casa.