Domine Claude Code Skills em 1 post

Se você der o Claude Code para dez pessoas diferentes, nove vão criar um projetinho genérico com cara de template feito por IA, e só uma vai entregar um projeto profissional, daqueles que dá para vender por 10, 15, 20 mil reais. Mesma ferramenta, resultados completamente diferentes. O segredo não está na IA, está em como você ensina a IA a trabalhar. E dentro do Claude Code isso tem nome: skills.

Por que skills importam agora

Durante muito tempo, a corrida das empresas de IA era criar modelos cada vez melhores, mais inteligentes, mais rápidos, com mais parâmetros. Só que os modelos já ficaram tão bons que o jogo mudou. Essa mudança é importante o suficiente para a própria Anthropic, criadora do Claude Code, ter afirmado publicamente: "pare de construir agentes, construa skills".

Hoje a diferença entre uma entrega ruim e uma entrega profissional não está só no modelo usado, está principalmente em como você orienta esse modelo. É aí que entram as skills: uma forma de ensinar o Claude Code a melhor maneira de trabalhar, passando boas instruções, criando padrões e direcionando a ferramenta para executar tarefas específicas com muito mais precisão. Na prática, isso significa projetos melhores, menos retrabalho, menos token desperdiçado e entregas com muito mais cara de projeto profissional.

O que é uma skill, na prática

Skill vem do inglês e significa habilidade. A ideia é essa mesmo: através das skills a gente dá habilidades específicas para o Claude Code. Se você quer que ele fique muito bom em criar páginas de captura, por exemplo, pode criar ou baixar uma skill para isso.

De forma concreta, skills são pacotes de instruções reutilizáveis. É uma pasta no seu computador, ligada ao Claude Code, onde você coloca instruções que orientam como uma tarefa específica deve ser feita.

Pensa em como você ensina um golpe de judô. Na primeira vez que ensina um aluno, dá trabalho: explica o movimento, mostra a posição, corrige detalhes, repete até sair certo. Com o Claude Code é igual. Na primeira vez que você ensina uma tarefa específica, precisa passar várias instruções, corrigir respostas, ajustar padrão.

O problema é quando você faz isso de novo do zero em todo projeto novo. Você já ensinou como entregar um CRM do jeito que você gosta, encerrou o projeto, e uma semana depois precisa entregar um CRM parecido para outro cliente. Sem skill, você começa tudo de novo. Com skill, você ensina uma vez, pede pro próprio Claude Code transformar tudo aquilo, todas as instruções e correções, em uma skill, e da próxima vez ele já carrega esse padrão de entrega sozinho.

Os três tipos de skill

Nem toda skill deve ser reutilizada em todos os projetos, e por isso existem três tipos:

Bundled skills: já vêm disponíveis por padrão no Claude Code, disponibilizadas pela própria Anthropic. Mesmo que você nunca tenha instalado nenhuma skill, elas já estão presentes.
Personal skills: valem para todos os seus projetos, hoje, semana que vem, em qualquer repositório. Ficam salvas na pasta claude/skills da instalação do Claude Code no seu computador.
Skills de projeto: valem só para aquele repositório específico. Ficam dentro da pasta do próprio projeto, em .claude/skills.

Faz sentido criar uma skill de projeto quando a instrução só se aplica àquele contexto específico, por exemplo uma manutenção recorrente que só faz sentido para aquele CRM de um cliente específico. Não vale a pena transformar isso em skill pessoal, porque o modelo sempre lê nome e descrição de todas as skills pessoais disponíveis antes de decidir usar uma, e cada skill a mais nessa lista é um "livro" a mais para ele avaliar.

O arquivo obrigatório: SKILL.md

Toda skill precisa ter um arquivo chamado SKILL.md, um arquivo de texto simples com todas as instruções para realizar aquela tarefa específica. Esse arquivo é obrigatório, mas a pasta da skill pode conter outras coisas também: exemplos, templates, scripts, referências de design.

Como a ativação funciona, em camadas

A ativação de uma skill acontece em camadas, como se fosse uma biblioteca. Sempre que o modelo está executando uma tarefa, ele olha para a estante de skills disponíveis:

Nome e descrição: primeiro ele lê o nome e a descrição de todas as skills disponíveis, para identificar se alguma ajuda na tarefa pedida.
SKILL.md: se identificar que faz sentido, ele ativa a skill e lê o arquivo obrigatório com as instruções completas.
Arquivos extras: se o SKILL.md referenciar exemplos, imagens ou outros documentos, ele só chega até aqui se a etapa anterior indicar que faz sentido.
Scripts auxiliares: por último, se existirem scripts na pasta da skill, ele executa o que for necessário.

Isso deixa claro por que uma boa skill precisa ter um nome e uma descrição claros: é o que permite o modelo decidir sozinho, sem você precisar citar a skill manualmente, se ela é útil para a tarefa que você pediu.

Baixando skills prontas

Você não precisa criar toda skill do zero. Existem pessoas que já gastaram horas criando, testando e refinando skills, e a Anthropic disponibiliza um repositório oficial no GitHub com várias delas prontas, como uma de front-end design e uma de MCP builder, para ajudar a conectar o Claude Code a outras ferramentas.

A forma mais prática de instalar as skills oficiais é direto pelo Claude Code, sem precisar ir no GitHub manualmente:

/plugins

Esse comando abre o gerenciador de plugins, onde aparecem skills, subagentes e outras extensões disponíveis. Nessa lista está, por exemplo, a skill creator, uma skill que ajuda a criar outras skills seguindo boas práticas. Vale a pena instalar ela também, porque melhora a forma como o próprio Claude Code estrutura uma skill nova quando você pede.

Ao instalar, você escolhe o escopo: para você (todos os projetos), para esse projeto (compartilhando com colaboradores) ou apenas localmente nesse repositório.

Vendo uma skill em ação

Depois de instalar a skill de front-end design, um pedido simples já é suficiente para ela entrar em ação sozinha, sem precisar ser citada:

Eu gostaria de criar uma página de captura para captar nome, e-mail e telefone do lead. Essa página pode ser simples, mas eu quero ela com design bonito e sofisticado.

O modelo identifica que a tarefa é de front-end, ativa a skill automaticamente e entrega um resultado já seguindo boas práticas de design, sem precisar de um prompt gigante especificando cada detalhe. Isso não substitui um prompt bem escrito, quanto mais detalhado o pedido, melhor o resultado, mas a skill potencializa a entrega ao carregar de antemão as melhores práticas para aquele tipo de tarefa.

Se você quiser garantir que uma skill específica seja usada, dá para forçar de duas formas: pedindo explicitamente no prompt ("ative a skill tal para resolver isso") ou digitando / seguido do nome da skill.

Criando uma skill nova a partir do que já foi feito

Depois de ajustar algo no projeto, por exemplo, definir que toda página deve usar uma fonte específica, dá para pedir pro próprio Claude Code transformar essa preferência em skill:

Eu gostaria que você criasse uma skill para que sempre que a gente for fazer qualquer projeto envolvendo texto e fontes, seja usada a fonte X e suas variações.

Com a skill creator instalada, o Claude Code identifica sozinho que deve usar essa skill para estruturar a nova, cria a pasta correspondente dentro de claude/skills e o SKILL.md com as instruções. Vale lembrar de reiniciar a sessão (abrir um novo chat) depois de instalar uma skill nova, para que ela seja carregada.

Skills existentes também podem ser atualizadas com um pedido simples, por exemplo pedindo para adicionar uma nova regra dentro de uma skill de front-end já criada. O Claude Code edita o SKILL.md correspondente sem você precisar mexer no arquivo manualmente.

Um cuidado com skills não oficiais

Skills de repositórios não oficiais no GitHub também podem ser boas, e tem muita coisa de qualidade por aí. Mas vale checar as avaliações e o uso daquele repositório antes de instalar, porque, como qualquer código de terceiros, uma skill mal-intencionada pode representar um risco de segurança para o projeto. É uma exceção, a maioria das skills disponíveis são seguras e funcionam bem, mas o cuidado básico vale a pena.

Resumindo

Sem skills, todo projeto novo começa do zero: você repete o contexto, reexplica os padrões, corrige as mesmas coisas de novo. Com skills, o Claude Code já sabe o padrão de entrega que você quer, já carregou as convenções, e você só precisa pedir o resultado. É a diferença entre treinar o mesmo golpe todo dia com um aluno novo e ter um aluno que já sabe o golpe de cor.