Os Skills do Claude Code são pastas que contêm um arquivo SKILL.md, carregado pelo Claude Code sob demanda quando uma tarefa corresponde à descrição do Skill. Você coloca a pasta em .claude/skills/ no seu projeto (ou em ~/.claude/skills/ para todos os projetos), o Claude Code lê o frontmatter e, a partir daí, incorpora as instruções sempre que elas forem relevantes. Abaixo: onde ficam, como diferem de CLAUDE.md, comandos de barra e MCP, uma instalação em 3 etapas e 15 Skills para desenvolvedores que funcionam no Claude Code atualmente.
O que um Skill do Claude Code realmente é
Um Skill é um diretório com um arquivo obrigatório, SKILL.md, e, opcionalmente, alguns arquivos de apoio (documentos de referência, modelos, scripts pequenos). O SKILL.md começa com um frontmatter YAML que contém dois campos importantes para o Claude Code: nome e description. Abaixo do frontmatter há Markdown simples: a função, o processo, o formato de saída, as regras.
A decisão de design importante é que os Skills são carregados sob demanda. O Claude Code mantém no contexto um índice curto com o nome e a descrição de cada Skill instalado. Quando sua solicitação parece corresponder, ele lê o SKILL.md completo e o segue. Quando não corresponde, o Skill quase não custa nada. É por isso que uma descrição bem escrita importa mais do que qualquer outra coisa no arquivo: é a única coisa que o Claude Code vê antes de decidir se deve abrir o Skill.
O mesmo SKILL.md que você recebe ao comprar um Skill no KissMySkills: um arquivo .md mais um README, idêntico ao que você enviaria para um Claude Project, um GPT personalizado ou um Gemini Gem.
Onde os Skills ficam: nível de projeto versus nível de usuário
O Claude Code procura em dois lugares.
-
Nível de projeto:
<repo>/.claude/skills/<skill-name>/SKILL.md. Faça commit desta pasta, e todos os colegas de equipe que clonarem o repositório terão o Skill. Use-o para tudo relacionado a esta base de código: sua lista de verificação de revisão, seu manual de implantação, seu estilo de documentação de API. -
Nível de usuário:
~/.claude/skills/<skill-name>/SKILL.md. Disponível em todos os projetos da sua máquina, invisível para seus colegas de equipe. Use-o para hábitos pessoais: como você gosta que as mensagens de commit sejam escritas, sua estrutura de testes preferida, uma persona que você usa com diferentes clientes.
Se existir uma skill com o mesmo nome nos dois locais, a cópia no nível do projeto terá prioridade. Mantenha as skills gerais de desenvolvimento no nível do usuário e tudo que tiver regras específicas do projeto no nível do projeto.
Como o Claude Code descobre uma skill
A descoberta é orientada pelo description campo no frontmatter, não pelo nome do arquivo nem pelo nome da pasta. Uma descrição como "Revisão de código para pull requests" é fraca porque só é acionada quando você diz literalmente "revisão". Uma descrição como "Revise alterações, pull requests e arquivos modificados em busca de bugs, problemas de segurança, testes ausentes e nomenclatura pouco clara. Use sempre que o usuário pedir para verificar, revisar, auditar ou criticar código" é acionada pelas formulações que os desenvolvedores realmente usam.
Três coisas para saber:
- As skills são indexadas quando uma sessão começa. Se você adicionar uma pasta durante a sessão, inicie uma nova sessão ou peça ao Claude Code para reler as skills.
- A descrição deve dizer quando usar a skill, não apenas o que ela é. As frases de acionamento devem estar nela.
- Você sempre pode forçar uma skill nomeando-a: "use a skill de revisão de código nesta alteração". A descoberta automática é uma conveniência, não o único caminho.
Skills vs CLAUDE.md vs comandos de barra vs servidores MCP
Esses quatro são constantemente confundidos, mas resolvem problemas diferentes.
| Mecanismo | O que é | Quando é carregado | Mais indicado para |
|---|---|---|---|
| CLAUDE.md | Arquivo de memória do projeto na raiz do repositório (ou ~/.claude/CLAUDE.md) | Sempre, a cada turno | Fatos que Claude nunca pode esquecer: stack, convenções, comandos, áreas que não devem ser tocadas |
| Skill | Pasta com SKILL.md e arquivos de suporte opcionais | Sob demanda, quando a descrição corresponder | Procedimentos especializados de que você precisa às vezes: revisões, auditorias, planos de teste, runbooks |
| Comando de barra | Arquivo Markdown em .claude/commands/, executado com /name | Somente quando você digita o comando | Ações repetíveis que você aciona deliberadamente: /deploy-checklist, /write-pr |
| Servidor MCP | Processo externo que expõe ferramentas (bancos de dados, APIs, navegadores) | As ferramentas ficam disponíveis durante toda a sessão | Dar a Claude a capacidade de fazer algo, não o conhecimento de como fazê-lo bem |
A versão curta: CLAUDE.md é contexto sempre ativo, uma skill é conhecimento especializado que chega quando necessário, um comando de barra é um botão que você pressiona e um servidor MCP é um conjunto de mãos. Uma boa configuração usa os quatro: MCP para que Claude possa agir, uma skill para que ele aja como um engenheiro sênior.
Uma consequência: não cole uma lista de verificação de revisão com 2.000 palavras no CLAUDE.md. Ela estará no contexto quando você estiver renomeando uma variável. Transforme-a em uma skill.
Instale uma skill do Claude Code em 3 etapas
Etapa 1: Obtenha o SKILL.md. Baixe o arquivo .md do seu pedido na KissMySkills (ou escreva o seu próprio). Se o arquivo ainda não se chamar SKILL.md, renomeie-o. O frontmatter precisa ter pelo menos name: e description:; toda habilidade vendida no marketplace já vem com ambos.
Etapa 2: Crie a pasta. Na raiz do seu repositório:
mkdir -p .claude/skills/code-reviewer
mv ~/Downloads/yuri-code-reviewer.md .claude/skills/code-reviewer/SKILL.mdPara uma instalação no nível do usuário, troque por .claude/skills para ~/.claude/skills. O nome da pasta deve corresponder ao nome campo no frontmatter, em letras minúsculas e com hífens.
Etapa 3: Inicie uma nova sessão do Claude Code nesse diretório e peça algo que a descrição abranja. Você deverá ver a estrutura da habilidade na resposta (as seções da revisão, os rótulos de gravidade, seja o que for definido pela habilidade). Nenhum arquivo de configuração, nada mais para reiniciar.
Se quiser um passo a passo mais detalhado, com capturas de tela e o equivalente no Claude.ai, leia como instalar uma habilidade do Claude.
Como testar uma habilidade
Testar leva cinco minutos.
- Teste de acionamento. Faça três solicitações que deveriam ativar a habilidade usando formulações diferentes ("revise isto", "há algo errado com esta função?", "verifique o PR"). Se uma não funcionar, amplie a descrição com essa formulação.
- Teste negativo. Peça algo relacionado, mas que não deveria ativá-la ("renomeie esta variável"). Se a habilidade for carregada mesmo assim, a descrição é abrangente demais.
- Teste de saída. Compare a resposta com o que o SKILL.md promete. Se a habilidade disser "sempre liste a gravidade de cada descoberta" e a saída não tiver níveis de gravidade, as instruções estão sendo lidas, mas não seguidas; encurte-as e torne-as mais precisas.
- Teste explícito. Mencione a habilidade diretamente. Se isso funcionar e a descoberta automática não, o problema está 100% na descrição.
Para ver como é um SKILL.md bem estruturado antes de escrever ou comprar um, 12 arquivos SKILL.md reais são explicados linha por linha aqui.
15 habilidades do Claude Code para desenvolvedores
Tudo abaixo vem da coleção de habilidades do Claude Code. Cada item é uma compra única, com um arquivo de habilidade .md mais um README, e é coberto pela política de reembolso em até 30 dias. Os preços estão corretos no momento da publicação.
Qualidade do código
Yuri - Skill de AI para revisão de código ($29): faz uma revisão estruturada de qualquer diff, arquivo ou PR, com as descobertas agrupadas por gravidade.
Soren - Skill de AI para auditoria de código ($29): audita uma base de código inteira em vez de uma única alteração, procurando dívida estrutural, código morto, padrões inconsistentes e pontos de risco. Ótimo para a primeira semana em um repositório herdado.
Albert - agent de revisão de código com AI ($32): um agent de revisão ajustado para um ciclo rápido, com foco na correção e nos casos extremos das linhas alteradas.
Mira - Skill de AI para engenharia de QA ($29): transforma uma descrição de funcionalidade ou um diff em casos de teste, casos extremos e um plano de testes, depois escreve os testes no seu framework. Útil quando você pede ao Claude Code para "adicionar testes" e quer mais do que o caminho feliz.
Entrega
Rami - Skill de AI para engenharia DevOps ($29): pipelines de CI/CD, Dockerfiles, infraestrutura como código e runbooks de incidentes com a cautela de um verdadeiro engenheiro DevOps. Pergunta sobre rollback antes de escrever uma etapa de deploy.
Max - Skill de AI para desenvolvimento Full Stack ($29): o generalista: cria a estrutura de funcionalidades em toda a API, camada de dados e UI, mantendo as partes consistentes. Se você instalar apenas uma Skill de entrega, esta é a escolha.
Lena - Skill de AI para desenvolvimento Frontend ($29): estrutura de componentes, estado, acessibilidade e comportamento responsivo para stacks modernas de frontend. Impede que o Claude Code entregue uma sopa de divs com estilos inline.
Niko - Skill de AI para desenvolvimento Backend ($29): design de API, modelagem de dados, tratamento de erros e desempenho para código de servidor. Forte nas partes menos empolgantes (validação, paginação, idempotência) que os prompts genéricos deixam de lado.
Elena - Skill de AI para Engenharia de Dados ($29): Pipelines, esquemas, transformações e verificações de qualidade de dados. Use-a quando a tarefa envolver mover dados, em vez de disponibilizá-los.
Documentação e processos
Saoirse - Skill de AI para Redação Técnica ($29): READMEs, descrições de PRs, changelogs, notas de arquitetura e documentos de integração em uma voz consistente. Peça ao Claude Code para "escrever a descrição da PR" com esta Skill instalada e você obterá contexto, alterações, testes e riscos, não uma frase genérica.
Dorian - Agente de Documentação de API com AI ($32): Gera e mantém a documentação de referência da API a partir do código: endpoints, parâmetros, exemplos e respostas de erro. Aponte-o para um arquivo de roteamento e deixe-o preencher as lacunas.
Verity - Skill de AI para Engenharia de Lançamentos e Sistemas de Build ($29): Versionamento, notas de lançamento, convenções de mensagens de commit, configuração de build e reprodutibilidade. A Skill para instalar se sua equipe discute sobre Conventional Commits.
Segurança
Anaya - Skill de AI para Engenharia de Segurança de Aplicações ($29): Analisa o código em busca de injeções, falhas de autenticação, gerenciamento de segredos e riscos de dependências, e explica a correção, em vez de apenas apontar o problema. Execute-a antes de uma versão, não depois.
Selwyn - Skill de Claude para Testes de Penetração ($29): Pensa como um invasor contra sua própria aplicação: modelos de ameaças, caminhos de ataque e uma lista priorizada do que testar.
Cassandra - Skill de Claude para Engenharia de Gestão de Vulnerabilidades ($29): Triagem de resultados de scanners e listas de CVEs: o que importa, o que é ruído e o que corrigir primeiro. Combine-a com uma auditoria de dependências no seu CI.
Não sabe por qual começar? A página do marketplace de Skills do Claude organiza todo o catálogo por função, e a coleção do Claude Code reúne o subconjunto para desenvolvedores.
Perguntas frequentes
Onde fica a pasta de Skills do Claude Code?
As Skills de projeto ficam em .claude/skills/<name>/SKILL.md dentro do seu repositório. As Skills de usuário ficam em ~/.claude/skills/<name>/SKILL.md no seu diretório pessoal e se aplicam a todos os projetos.
As Skills do Claude Code funcionam no ChatGPT?
O arquivo .md sim; a descoberta automática, não. Você pode colar ou enviar o mesmo SKILL.md como instruções para um GPT personalizado, e ele se comportará da mesma forma. O que o ChatGPT não tem é a convenção de pastas e o carregamento baseado em descrição; portanto, você o aciona usando esse GPT, em vez de o Claude Code decidir que ele é relevante.
Qual é a diferença entre uma Skill do Claude Code e o CLAUDE.md?
O CLAUDE.md é carregado a cada interação e deve conter informações curtas e permanentes sobre o projeto. Uma Skill é carregada apenas quando sua descrição corresponde à tarefa e pode ser tão longa quanto o procedimento exigir. Checklists longos devem ficar nas Skills, não no CLAUDE.md.
Posso instalar mais de uma Skill por vez?
Sim. Cada Skill tem sua própria pasta em .claude/skills, e o Claude Code indexa todas elas. Como apenas as descrições permanecem no contexto até que uma Skill seja necessária, ter 15 instaladas custa muito pouco até que uma seja ativada.
Preciso de um servidor MCP para usar Skills?
Não. As Skills são instruções e funcionam com as ferramentas integradas do Claude Code (edição de arquivos, shell, git). Os servidores MCP adicionam ferramentas externas, como um banco de dados ou um navegador; uma Skill pode ensinar o Claude a usar essas ferramentas corretamente, mas não depende delas.
Em resumo
Uma Skill do Claude Code é uma pasta com um SKILL.md, colocada em .claude/skills para o projeto ou em ~/.claude/skills para você, descoberta pela descrição e carregada apenas quando necessário. Mantenha o CLAUDE.md curto, use comandos de barra para ações deliberadas, use MCP para ferramentas e use Skills para conhecimento especializado. Instale uma, teste-a com três formulações e uma negativa e, depois, adicione as demais conforme seu fluxo de trabalho exigir.
Navegue por todas as Skills para desenvolvedores na coleção de Skills do Claude Code da KissMySkills.
