O Claude Code é a única interface do Claude que realmente instala Skills a partir do disco, o que significa que as orientações para ele são diferentes de tudo o que foi escrito sobre Instruções personalizadas. Este é um guia prático: como a pasta funciona, o que faz uma Skill valer a pena e onde as pessoas desperdiçam tempo.
Como as Skills funcionam no Claude Code
As Skills ficam em um diretório .claude/skills/. Cada Skill é uma subpasta com um arquivo SKILL.md dentro dela. Dois locais são importantes:
-
Projeto -
.claude/skills/dentro do repositório. A Skill acompanha o código, então toda a equipe a recebe. É aqui que deve ficar tudo o que é específico do projeto. - Pessoal - o mesmo caminho no seu diretório pessoal. Aplica-se a tudo em que você trabalha. É aqui que devem ficar os seus próprios hábitos.
Diferentemente das Instruções personalizadas, que armazenam uma coisa por vez, o Claude Code pode armazenar muitas Skills e carregar aquela que corresponde ao que você está fazendo. Isso muda o que caracteriza uma boa Skill: ela precisa ter uma descrição precisa o suficiente para que a correta seja escolhida e específica o bastante para não ser escolhida para tudo.
O que faz uma Skill realmente merecer seu lugar
Depois de criar muitas delas, o padrão é consistente. Boas Skills codificam decisões, não informações.
Uma Skill que lista o que é uma API REST desperdiça tokens com algo que o modelo já sabe. Uma Skill que diz "neste repositório, todo endpoint retorna erros no formato RFC 7807, e os três lugares que não fazem isso são legados e não devem ser copiados" vale a pena manter para sempre, porque essa é uma decisão que o modelo não consegue deduzir.
O teste é: se um engenheiro competente que entrasse para a sua equipe precisasse ser informado disso, coloque em uma Skill. Se ele já soubesse, deixe de fora.
As categorias que vale a pena ter
Revisão de código com um padrão interno
Comentários genéricos de revisão são ruído. Uma Skill de revisão que contenha as convenções reais da sua equipe, aquelas sobre as quais vocês discutiram e chegaram a um acordo, transforma a revisão de opinião em uma lista de verificação.
Convenções de testes
Qual framework usar, como um teste é nomeado, o que é simulado e o que nunca é, e o que conta como cobertura suficiente para esta base de código. Sem isso, você obtém testes no estilo mais comum nos dados de treinamento.
Depuração e trabalho com incidentes
Onde estão os logs, qual painel responde a cada pergunta, as quatro coisas a verificar antes de escalar o problema. Esta é a Skill que se paga às 3h da manhã.
Infraestrutura e implantação
A sequência de implantação, o que é seguro executar em produção e o que não é, quais migrações exigem uma janela de manutenção. Codificar as partes perigosas é o objetivo.
Documentação e redação técnica
Onde a documentação fica, qual estrutura uma página segue, a diferença, no estilo da sua empresa, entre um tutorial e uma referência.
O que deixar de fora
Tutoriais de linguagem. Uma Skill que explica a sintaxe do Python ao Claude é uma Skill que explica a sintaxe do Python para algo que já conhece a sintaxe do Python.
Skills enormes que abrangem tudo. Uma única Skill que cobre frontend, backend, testes e implantação é carregada o tempo todo e, na maioria das vezes, é irrelevante. Divida-a.
Qualquer coisa que ficará desatualizada em um mês. Números de versão, metas do sprint atual, o nome de quem está de plantão. Skills servem para decisões duradouras.
Descrições vagas. Se a descrição não disser claramente quando a Skill se aplica, ela nunca será selecionada ou será sempre selecionada. As duas opções são inúteis.
Começar com um modelo em vez de uma página em branco
A parte mais difícil não é a ideia, mas o formato: quão específico ser, o que deixar de fora, como escrever a descrição para que a seleção funcione. Essa é a parte que vale a pena copiar de algo já testado.
Publicamos arquivos de Skills baseados em funções para desenvolvedores, DevOps e arquitetos, escritos em .md simples e utilizáveis tanto como uma Skill do Claude Code quanto colados nas Instruções personalizadas:
Skills do Claude Code →
Skills para desenvolvedores →
Skills de DevOps →
Skills para arquitetos →
Se você não usa o Claude Code e chegou aqui mesmo assim, o equivalente para o Claude na web são as Instruções personalizadas.
KissMySkills é um marketplace independente e não tem afiliação, endosso ou conexão com a Anthropic, a OpenAI ou qualquer outra empresa de AI. O Claude Code é um produto da Anthropic.
