As Skills do Claude Code são pastas de instruções, scripts e recursos que o Claude Code descobre e ativa por conta própria quando sua tarefa corresponde a elas - assim, seu agent de programação com AI deixa de esquecer sua stack, suas convenções e seu fluxo de trabalho entre as sessões. Você explica suas preferências uma vez; Claude as aplica sempre, sem precisar ser lembrado.
Este guia explica o que são as Skills do Claude Code, os dois tipos que você usará, como elas são ativadas automaticamente, onde ficam e um fluxo de trabalho testado na prática para lançar recursos reais com elas.
O problema que elas resolvem
Assistentes de programação com AI esquecem tudo entre as conversas. Sem ajuda, você precisa explicar novamente seu framework, a estrutura das suas pastas, suas regras de nomenclatura e seus padrões de revisão em cada nova sessão. Uma Skill captura esse conhecimento uma vez, para que o Claude Code siga suas convenções de forma consistente, em vez de usar como padrão modelos genéricos que produzem "porcaria de AI".
Os dois tipos de Skills do Claude Code
- Ampliação de capacidades - Skills que dão a Claude novas habilidades que ele não tinha: coisas como geração de documentos, testes de aplicações web ou scraping. Elas ampliam o que o agent pode fazer.
- Preferência codificada - Skills que fazem Claude executar as tarefas do seu jeito: regras de design de frontend, boas práticas de React, convenções de commit da sua equipe. Elas restringem como o trabalho é realizado.
A maioria dos desenvolvedores acaba com uma combinação: algumas Skills de capacidade para obter novos recursos e várias Skills de preferências que impõem o estilo da equipe.
Este é o exemplo de "seus padrões de revisão" mencionado acima, transformado em algo concreto: adicione Yuri, e Claude verificará cada diff em busca de bugs, falhas de segurança e problemas de desempenho como um revisor sênior faria, em todas as sessões.
Ver a Skill de AI de revisão de código Yuri →Como elas são ativadas
Você não precisa chamar uma Skill pelo nome. O Claude Code observa a conversa e ativa uma Skill por conta própria quando o que você descreve corresponde à descrição da Skill. Mencione a revisão de código em busca de vulnerabilidades, e uma Skill de revisão de segurança poderá ser ativada automaticamente; peça um componente, e sua Skill de padrões do React entrará em ação. A descrição em SKILL.md de cada Skill é o que controla isso, e é por isso que escrever uma descrição precisa é mais importante do que qualquer outra coisa.
Onde ficam as Skills do Claude Code
As Skills ficam em um diretório de Skills e são carregadas na inicialização:
-
Pessoal:
~/.claude/skills/<name>/- disponível em todos os seus projetos. -
Projeto:
.claude/skills/<name>/- incluído no repositório para que toda a equipe o compartilhe.
Confirme uma SKILL.md fica na raiz da pasta, reinicie o Claude Code e execute /skills para verificar se foi carregada. Instalar uma Skill empacotada geralmente consiste apenas em unzip skill.zip -d ~/.claude/skills/.
Um fluxo de trabalho comprovado: pesquisa → planejamento → implementação
A maneira mais confiável de entregar um recurso não trivial com Claude Code é separar o raciocínio da digitação:
-
Pesquise. Peça ao Claude para mapear primeiro o código relevante - padrões existentes, dependências e pontos de extensão - em um
research.mdcurto. Ainda sem código. - Planeje. Peça ao Claude para elaborar um plano sem implementação. Abra-o no seu editor, faça anotações em todos os pontos incorretos e envie-o de volta com: "resolva todas as observações, mas ainda não implemente". Repita até que todas as decisões estejam resolvidas.
- Implemente. Só agora deixe Claude escrever o código, seguindo o plano acordado.
Uma Skill de preferência "feature-dev" pode codificar exatamente esse ciclo para que ele seja executado da mesma forma todas as vezes - esse é justamente o objetivo das Skills: transformar um bom fluxo de trabalho em um processo repetível.
Em vez de criar do zero o ciclo pesquisa → planejamento → implementação, carregue um conjunto completo de 5 Agents de programação no Claude e cubra revisão de código, correção de bugs, documentação, DevOps e implementação full stack em um único pacote.
Ver pacote de Agents de programação →Onde obter Skills do Claude Code
Você pode criar as suas próprias ou instalar algumas prontas. Se preferir começar com arquivos testados, explore a coleção de Skills do Claude Code ou a biblioteca mais ampla de Tecnologia e desenvolvimento. Está começando agora com Skills? Comece por como instalar uma Skill do Claude ou baixe uma Skill gratuita para ver a estrutura.
Rota 3: plugins
As Skills também podem ser incluídas em um plugin do Claude Code, instalado com o comando do plugin em vez de mover arquivos. As Skills de plugins usam o namespace do próprio plugin, o que impede que duas Skills com o mesmo nome entrem em conflito.
A lista completa de Skills de engenharia que vale a pena instalar
As Skills úteis para uma ferramenta de CLI são aquelas vinculadas a um cargo real de engenharia, porque é assim que o trabalho é efetivamente dividido. Este é o agrupamento completo que mantemos para Claude Code, com quatorze funções no total:
- Revisão e qualidade: Revisor de Código, Auditor de Código, Engenheiro de QA.
- Desenvolvimento: Desenvolvedor Full Stack, Desenvolvedor Backend, Desenvolvedor Frontend, Desenvolvedor WordPress.
- Infraestrutura: Engenheiro de DevOps, Engenheiro de Nuvem, Engenheiro de Banco de Dados.
- Design e direcionamento: Arquiteto de Software, Líder Técnico, Gerente de Engenharia.
- Segurança: Analista de Cibersegurança.
O conjunto completo está na coleção de Skills do Claude Code. Duas delas estão abaixo, para você ver como as descrições ficam na prática.
Pipelines de CI/CD com cache, gates de staging e gatilhos de rollback, builds Docker em várias etapas, manifestos Kubernetes e charts Helm, módulos Terraform com estado remoto e uma stack de monitoramento com limites de alerta reais em vez de placeholders.
Ver Skill de AI Engenheiro de DevOps de Rami →
Um veredito em uma linha, seguido de descobertas classificadas de Crítica a Média em correção, segurança, desempenho e manutenibilidade. Cada descoberta identifica a entrada ou sequência exata que a aciona e inclui um trecho corrigido.
Ver Skill de AI Auditor de Código de Soren →Grátis no GitHub ou pago: qual é a diferença real?
Ambos existem, e fingir o contrário seria desonesto.
A Anthropic publica exemplos de Skills abertamente em github.com/anthropics/skills, e há repositórios da comunidade reunindo mais. Eles não custam nada, você pode ler cada linha e, para casos comuns, são um ponto de partida perfeitamente adequado. Se você só quer ver o mecanismo funcionar uma vez, comece por eles.
O que você geralmente obtém pelo seu dinheiro é profundidade e consistência, e não um mecanismo diferente. A diferença costuma aparecer em quatro pontos:
- Precisão do acionamento. Skills gratuitas geralmente são escritas por alguém resolvendo o próprio problema, então a descrição pressupõe a configuração dessa pessoa. Uma descrição escrita para desconhecidos precisa ser mais específica e clara.
- Um exemplo de resultado concluído. Um pacote que inclui um exemplo pronto mostra a entrega antes de você pagar. Um repositório com um README de 40 linhas está pedindo que você adivinhe.
- Disciplina de escopo. Uma Skill que abrange backend, frontend, infraestrutura e segurança dá quatro meias-respostas. Quatro Skills moldadas para cada função dão quatro respostas certas.
- Manutenção. Um repositório que não recebe atualizações há um ano ainda faz referência a ferramentas e versões de um ano atrás.
As Skills do Claude para desktop funcionam no Claude Code?
Na maioria das vezes, com uma coisa a saber.
As Skills que você envia no aplicativo Claude e as que o Claude Code lê do disco seguem a mesma ideia e o mesmo arquivo: Markdown com frontmatter. O empacotamento é diferente. O aplicativo recebe um ZIP pela interface, enquanto o Claude Code lê uma pasta do sistema de arquivos. Elas também são armazenadas separadamente, portanto instalar uma Skill em um lugar não faz com que ela apareça no outro. Você precisa instalá-la duas vezes se quiser tê-la nos dois.
O Claude Code também oferece suporte a opções de frontmatter que se aplicam apenas à CLI. Uma Skill escrita para o aplicativo funciona no Claude Code; uma Skill que depende de opções exclusivas da CLI perderá esses recursos extras se você carregá-la no aplicativo, embora o método em si continue válido. As instruções passo a passo para usar o aplicativo estão em como instalar uma Skill do Claude.
Perguntas frequentes
Preciso invocar uma Skill do Claude Code manualmente?
Não. O Claude Code ativa uma Skill automaticamente quando sua tarefa corresponde à descrição dela. Você também pode referenciá-la explicitamente, mas o acionamento automático é o principal benefício.
Qual é a diferença entre Skills pessoais e Skills de projeto?
As Skills pessoais em ~/.claude/skills/ acompanham você em todos os projetos; as Skills do projeto ficam em .claude/skills/ ficam no repositório para que toda a sua equipe use as mesmas.
Por que minha Skill não é ativada?
Normalmente, a descrição é vaga demais. Torne-a específica sobre quando usar a Skill e confirme um SKILL.md está na raiz da pasta, reinicie o Claude Code e execute /skills para verificar se foi carregada.
As Skills do Claude Code são iguais ao MCP?
Não. As Skills ensinam o Claude a trabalhar; o MCP conecta o Claude a sistemas externos. Muitas configurações usam os dois.
Se preferir não escrever seu próprio SKILL.md para revisão de código, o Albert é a versão pronta - um agente sênior estruturado de revisão de código que você carrega no Claude e usa imediatamente, em qualquer linguagem ou framework.
Veja o Albert - agente de AI para revisão de código →Comece com uma Skill
Escolha a parte do seu fluxo de trabalho que você mais precisa reexplicar - sua stack, suas regras de revisão, seu estilo de commit - e transforme-a em código. Navegue pela coleção de Skills do Claude Code para encontrar pontos de partida testados ou leia primeiro o que são as Skills do Claude.
Em resumo:
Se você revisa código com frequência, comece com Yuri - Skill de AI para revisão de código ($29) ou o Albert - agente de AI para revisão de código pronto para usar ($32); se quiser cobrir todo o seu ciclo de pesquisa → planejamento → implementação, o Pacote de agentes de programação ($99) oferece os 5 agentes de programação em um só pacote. Todos funcionam no Claude, no ChatGPT e em qualquer chat de AI, sem programação, com garantia de reembolso de 30 dias.
