As Claude Code skills são pastas com um arquivo SKILL.md que ensinam o agente da Anthropic a executar uma tarefa do seu jeito, carregadas só quando são úteis. Você instala uma skill pelo marketplace de plugins (/plugin) ou pelo npx skills add e roda com /nome-da-skill, ou deixa o Claude ativar sozinho. Aqui você encontra o formato atual, um SKILL.md pronto e as melhores Claude Code skills de outubro de 2026.
Na prática, o ecossistema de Claude Code skills cresceu muito rápido. A find-skills sozinha soma 4 milhões de instalações, segundo o leaderboard do diretório skills.sh conferido em 22 de outubro de 2026. Além disso, o diretório já lista mais de 1,4 milhão de entradas. Por isso, separamos o que é oficial, o que é bem mantido e o que só ocupa contexto. Inclusive, para montar o seu fluxo, vale ler também os comandos secretos do Claude Code, que conversam bem com as skills.
Resumo
- Skills são pastas com um SKILL.md que o Claude Code carrega só quando a tarefa pede.
- Hoje os comandos personalizados viraram skills, e a find-skills lidera o ranking do skills.sh com 4 milhões de instalações.
- Comece pela find-skills, some no máximo três skills do seu stack e revise o SKILL.md antes de instalar.
O que são Claude Code skills?
Uma skill é um manual de procedimento que o Claude Code lê quando a tarefa pede. Por isso, ela muda o comportamento sem mexer no modelo. Na prática, é um diretório com um SKILL.md. No topo fica um cabeçalho YAML (o frontmatter) com nome e descrição. Abaixo vêm as instruções em Markdown. Além disso, a pasta também pode guardar scripts, modelos e documentos de referência que a skill cita.
Na prática, a grande sacada das Claude Code skills é o carregamento sob demanda. A documentação oficial do Claude Code resume, em tradução livre: “o corpo da skill só carrega quando ela é usada, então material de referência longo custa pouco até ser necessário”. Ou seja, o agente vê apenas o nome e a descrição de cada skill. Logo, o texto completo entra no contexto só quando a skill é invocada.
Além disso, as Claude Code skills seguem o padrão aberto Agent Skills (agentskills.io). Assim, a mesma pasta funciona em outras ferramentas de agente. Por exemplo, o CLI skills, da Vercel, cita suporte a OpenCode, Codex, Cursor e mais de 75 agentes. Inclusive, quem alterna de ferramenta leva as skills junto, como mostramos no guia do OpenCode.
Skills substituíram os comandos personalizados
No entanto, muita gente ainda procura “slash commands” em tutoriais antigos. Hoje a documentação diz que os comandos personalizados foram incorporados às skills: tanto .claude/commands/deploy.md quanto .claude/skills/deploy/SKILL.md criam o comando /deploy. Ou seja, o arquivo antigo continua funcionando. No entanto, a skill ganha recursos extras: arquivos de apoio, controle de quem invoca e execução em subagente.
Como o Claude decide quando usar uma skill
O gatilho é o campo description. Primeiro, o Claude lê as descrições de todas as skills e carrega a que combina com o pedido. Por isso, a documentação manda colocar o caso de uso principal no começo. Afinal, a descrição somada ao campo when_to_use é cortada em 1.536 caracteres. Além disso, você controla quem pode acionar cada skill:
| Frontmatter | Você invoca com /nome | O Claude invoca sozinho | Uso típico |
|---|---|---|---|
| (padrão) | Sim | Sim | Convenções e guias de estilo |
disable-model-invocation: true | Sim | Não | Deploy, commit, ações com efeito colateral |
user-invocable: false | Não | Sim | Conhecimento de fundo do projeto |
Qual a diferença entre skill, slash command, subagente, hook e MCP?
A skill ensina como fazer; o subagente isola quem faz; o hook garante que algo sempre aconteça; o MCP conecta dados externos. Por outro lado, os cinco recursos se combinam bem, e um plugin pode empacotar todos eles de uma vez.
| Recurso | O que entrega | Onde fica | Quando usar |
|---|---|---|---|
| Skill | Conhecimento procedural carregado sob demanda | .claude/skills/<nome>/SKILL.md | Checklists, convenções, passo a passo repetido |
| Slash command | Atalho que você digita com / | .claude/commands/ (hoje é uma skill) | Fluxos curtos que só você dispara |
| Subagente | Instância separada com contexto próprio | .claude/agents/<nome>.md | Tarefas longas que poluiriam a conversa |
| Hook | Comando que roda em eventos do ciclo de vida | settings.json ou plugin | Regras que não podem depender do modelo |
| MCP | Ferramentas e dados de sistemas externos | .mcp.json ou plugin | Banco de dados, APIs, Slack, GitHub |
| Plugin | Pacote com vários dos itens acima | Marketplace (/plugin) | Distribuir um setup para o time |
Na prática, a diferença mais importante está entre skill e hook. Afinal, uma skill é uma sugestão que o modelo segue quando acha pertinente. Já um hook é determinístico. Por exemplo, um formatador que roda após cada edição nunca depende do agente. Em contrapartida, o subagente resolve o problema do contexto, tema do guia de agents e subagents no Claude Code.
Da mesma forma, MCP e skill não competem. Na prática, o Model Context Protocol dá ao Claude a ferramenta, e a skill ensina quando e como usá-la. Inclusive, uma skill pode rodar dentro de um subagente com context: fork. Por fim, para montar o seu próprio servidor, veja o passo a passo de MCP server no Claude Code.
Onde ficam as skills do Claude Code?
Skills pessoais ficam em ~/.claude/skills/ e skills do projeto ficam em .claude/skills/, sempre uma pasta por skill. Na prática, a diferença é o alcance. A pessoal vale em todos os seus repositórios, enquanto a do projeto vai para o Git do time. Veja a seguir os quatro níveis que a documentação descreve:
| Nível | Caminho | Vale para |
|---|---|---|
| Empresa | Diretório de configurações gerenciadas | Todos os usuários da organização |
| Pessoal | ~/.claude/skills/<nome>/SKILL.md | Todos os seus projetos |
| Projeto | .claude/skills/<nome>/SKILL.md | Só este repositório |
| Plugin | <plugin>/skills/<nome>/SKILL.md | Onde o plugin estiver ativo |
Quando duas Claude Code skills têm o mesmo nome, a da empresa vence a pessoal. Por sua vez, a pessoal vence a do projeto. Além disso, pastas .claude/skills/ dentro de subdiretórios também são carregadas, o que ajuda em monorepos. Já as skills de plugin ganham um prefixo com o nome do plugin, no formato /plugin:skill. Por exemplo, o plugin commit-commands expõe /commit-commands:commit.
Publicidade
Como instalar Claude Code skills?
Há três caminhos para instalar Claude Code skills: marketplace de plugins, CLI skills ou cópia da pasta. Além disso, instalar é gratuito, porque skills são arquivos abertos. Logo, o custo, quando existe, é o plano do Claude que você já usa.
Pelo marketplace de plugins (/plugin)
Primeiro, abra o Claude Code e digite /plugin. Com isso, a aba Discover lista o marketplace oficial da Anthropic, o claude-plugins-official. O Claude Code o adiciona sozinho na primeira sessão interativa. Em seguida, instale pelo nome e escolha o escopo (só você, todo o repositório ou só você neste repositório):
# dentro do Claude Code
/plugin install superpowers@claude-plugins-official
# marketplace de terceiros: adicione antes de instalar
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
# fora da sessão, no terminal
claude plugin install skill-creator@claude-plugins-official --scope projectDepois da instalação, o resumo avisa se o plugin já está ativo ou se é preciso rodar /reload-plugins. Em seguida, para conferir, digite / e procure as skills com o prefixo do plugin. Por fim, na aba Installed você desativa, atualiza ou remove cada plugin.
Pelo CLI skills (npx skills add)
O segundo caminho é o CLI aberto da Vercel, o mesmo que alimenta o skills.sh. Ele exige Node 22.20 ou superior e copia arquivos editáveis para o projeto. Por padrão, a instalação é local; com -g, porém, a skill vale para todos os projetos. Assim, você escolhe o alcance na hora.
# escolher skills de um repositório, de forma interativa
npx skills add vercel-labs/agent-skills
# uma skill específica, direto para o Claude Code
npx skills add vercel-labs/agent-skills --skill web-design-guidelines -a claude-code
# buscar, listar e atualizar
npx skills find react
npx skills list
npx skills updateA diferença entre os dois caminhos é a atualização. Por um lado, Claude Code skills instaladas por plugin do marketplace oficial se atualizam sozinhas. Em vez disso, a cópia feita pelo CLI fica parada até você rodar npx skills update. Em troca, você pode editá-la à vontade. Por isso, recomendamos escolher um só caminho por skill, já que instalar pelos dois duplica cada comando.
Manualmente, copiando a pasta
Por fim, dá para clonar o repositório e copiar a pasta da skill para ~/.claude/skills/ ou .claude/skills/. Assim, é o caminho mais transparente, porque você lê tudo antes. De fato, essa leitura importa: a documentação lembra que um plugin roda com as suas permissões de usuário. Logo, revise scripts e hooks de qualquer skill de origem desconhecida.
Na prática, rodar o Claude Code com várias skills, subagentes e o servidor de desenvolvimento ao mesmo tempo pede memória. Na nossa visão, 16 GB de RAM é o mínimo confortável. O notebook abaixo atende a esse perfil.
Como criar uma skill no Claude Code?
Crie uma pasta em .claude/skills/ com um SKILL.md dentro, e o nome da pasta vira o comando. Afinal, não há build nem registro: o Claude Code detecta a skill sozinho. Abaixo, a estrutura mínima:
.claude/
└── skills/
└── commit-convencional/
├── SKILL.md # obrigatório
└── exemplos.md # opcional, citado no SKILL.mdVeja a seguir um SKILL.md completo e curto. Na prática, ele lê o diff em stage e escreve uma mensagem no padrão Conventional Commits. Além disso, só roda quando você chama, porque commit tem efeito colateral:
---
name: commit-convencional
description: Escreve a mensagem de commit no padrão Conventional Commits a partir do diff em stage. Use quando o usuário pedir para commitar ou sugerir uma mensagem de commit.
argument-hint: [escopo]
disable-model-invocation: true
allowed-tools: Bash(git status *) Bash(git commit *)
---
## Mudanças em stage
!`git diff --staged`
## Instruções
1. Classifique a mudança: feat, fix, docs, refactor, test ou chore.
2. Use "$ARGUMENTS" como escopo, se ele vier preenchido.
3. Título em até 72 caracteres, no imperativo e em português.
4. Se o diff estiver vazio, avise e não faça o commit.
5. Mostre a mensagem e rode git commit só depois do OK.Por isso, repare em três detalhes. Primeiro, a linha !`git diff --staged` é injeção dinâmica de contexto. Ou seja, o Claude Code executa o comando e cola o resultado antes de o modelo ler a skill. Em segundo lugar, $ARGUMENTS recebe o que vem depois do nome, como em /commit-convencional api. Há também $0 e $1 para argumentos por posição. Por fim, allowed-tools libera só os comandos listados sem pedir permissão a cada uso.
Campos do frontmatter que mais importam
- name: o nome do comando; logo, se faltar, vale o nome da pasta.
- description: o que a skill faz e quando usar, ou seja, o campo que decide a ativação automática.
- allowed-tools e disallowed-tools: liberam ou removem ferramentas enquanto a skill está ativa.
- context: fork com agent: roda a skill num subagente que não vê o histórico da conversa.
- model, effort, paths e hooks: trocam o modelo, limitam a ativação a certos arquivos e registram hooks enquanto a skill roda.
Um cuidado de portabilidade: fora do Claude Code, o padrão Agent Skills aceita só name, description, license, compatibility, metadata e allowed-tools. Portanto, se a skill vai para outras ferramentas, evite os campos exclusivos. Além disso, a documentação sugere manter o arquivo principal abaixo de 500 linhas e mover o material longo para arquivos de apoio.
Por outro lado, o plugin oficial skill-creator mede se a skill ajuda. Ele roda os mesmos prompts com e sem ela e compara os resultados. Da mesma forma, Claude Code skills casam bem com especificação escrita antes do código. É o tema do guia de spec-driven development com IA, e com o trabalho de engenharia de contexto.
Quais são as melhores Claude Code skills?
As melhores Claude Code skills hoje são find-skills, frontend-design, skill-creator, Superpowers e o pacote de Matt Pocock. Para chegar a essa lista, primeiro cruzamos o ranking “All Time” do diretório com as estrelas no GitHub. Os dois foram conferidos em 22 de outubro de 2026. Em seguida, demos peso a projetos oficiais e com commits recentes. Por fim, confirmamos que cada skill existe no repositório citado.
| Skill | Repositório | Para que serve | Tração (22/10/2026) |
|---|---|---|---|
| find-skills | vercel-labs/skills | Achar e instalar outras skills | 4,0 mi instalações |
| Matt Pocock skills (grill-me, tdd) | mattpocock/skills | Alinhar o pedido e programar com testes | 1,4 mi (grill-me) |
| agent-browser | vercel-labs/agent-browser | Controlar o navegador | 1,2 mi instalações |
| frontend-design | anthropics/skills | Interfaces com cara de produto | 1,0 mi instalações |
| vercel-react-best-practices | vercel-labs/agent-skills | Performance em React e Next.js | 829 mil instalações |
| web-design-guidelines | vercel-labs/agent-skills | Revisar UI e acessibilidade | 772 mil instalações |
| Superpowers | obra/superpowers | Plano, TDD e depuração sistemática | 303 mil estrelas |
| skill-creator | anthropics/skills | Criar e avaliar skills | plugin oficial |
1. find-skills: o buscador de skills
A find-skills, do repositório vercel-labs/skills, ensina o Claude a procurar e instalar skills no ecossistema aberto quando você descreve o que precisa. Por isso, ela lidera o ranking com folga e costuma ser a primeira a entrar no ambiente. Assim, basta instalar com npx skills add vercel-labs/skills.
2. frontend-design: a skill oficial de interface
Mantida pela própria Anthropic, a frontend-design afasta o agente do visual genérico de IA. Para isso, impõe escolhas firmes de tipografia, cor e layout. Além disso, ela está no repositório anthropics/skills e também como plugin oficial: /plugin install frontend-design@claude-plugins-official.
3. skill-creator: para escrever as suas
Também oficial, a skill-creator guia a criação de uma skill nova e roda avaliações comparando respostas com e sem ela. Consideramos a melhor forma de aprender o formato, já que o resultado sai dentro das regras atuais. Portanto, instale com /plugin install skill-creator@claude-plugins-official.
4. Superpowers: disciplina de engenharia
O Superpowers, de Jesse Vincent (obra/superpowers), é um conjunto de skills como brainstorming, writing-plans, test-driven-development e systematic-debugging. Na prática, ele obriga o agente a planejar, testar e verificar antes de declarar a tarefa pronta. Inclusive, com cerca de 303 mil estrelas, é o repositório de skills mais popular do GitHub. No marketplace oficial, aparece como superpowers@claude-plugins-official.
5. Matt Pocock skills: grill-me, tdd e triage
O pacote mattpocock/skills tem algumas das Claude Code skills mais instaladas do diretório, como grill-me, tdd e improve-codebase-architecture. Por exemplo, a grill-me faz o agente entrevistar você antes de escrever código. Assim, cai o retrabalho por pedido mal entendido. Para usar, instale com claude plugin install mattpocock-skills@claude-plugins-official e rode /setup-matt-pocock-skills uma vez por repositório.
6. vercel-react-best-practices e web-design-guidelines
As duas vêm do repositório vercel-labs/agent-skills. Primeiro, a react-best-practices reúne as regras de performance da Vercel para React e Next, como busca de dados e tamanho do bundle. Em seguida, a web-design-guidelines revisa interfaces contra diretrizes de design e acessibilidade. Em times de frontend, recomendamos começar por essa dupla.
7. agent-browser e webapp-testing: navegador e testes
A agent-browser (vercel-labs/agent-browser) dá ao Claude um CLI de automação de navegador para abrir páginas, clicar, preencher formulários e conferir o resultado. Já a webapp-testing, da Anthropic, usa Playwright para testar uma aplicação local. Assim, o agente verifica a própria entrega em vez de só prometer que funciona.
8. Documentos, integrações e vídeo
O plugin document-skills da Anthropic traz as skills docx, pdf, pptx e xlsx, que leem e geram arquivos de escritório. Da mesma forma, a mcp-builder, do mesmo repositório, ajuda a escrever servidores MCP. Já para integrações, a skill composio (ComposioHQ/composio) orienta o agente a usar Gmail, Slack, GitHub, Notion e Linear. Por fim, quem faz vídeo com React tem as skills oficiais do Remotion, instaladas com npx skills add remotion-dev/skills. Aqui no techknow, elas guiam os vídeos do canal.
Skills que já vêm no Claude Code
Antes de instalar qualquer coisa, confira as Claude Code skills embutidas. Afinal, a documentação lista /code-review, /batch, /debug, /loop, /claude-api, /verify, /run, /doctor e /run-skill-generator. Inclusive, algumas o Claude aciona sozinho; outras, como /verify, só rodam quando você chama. Por outro lado, para desligar todas, use a configuração disableBundledSkills. Por fim, para tarefas recorrentes, combine o /loop com as automações agendadas no Claude Code.
Publicidade
Onde encontrar mais Claude Code skills?
Os melhores lugares para achar Claude Code skills são o skills.sh, a aba Discover do /plugin e os repositórios oficiais no GitHub. Por isso, como cada fonte tem um papel diferente, vale conhecer as cinco:
- skills.sh: o diretório aberto da Vercel, com ranking por instalações, abas de tendência e auditorias de segurança.
- Marketplace oficial (
claude-plugins-official): mais de 300 plugins revisados pela Anthropic, navegáveis em/pluginou no Claude Marketplace. - anthropics/skills: os exemplos oficiais, de algorithmic-art a xlsx, com cerca de 183 mil estrelas.
- Listas curadas: ComposioHQ/awesome-claude-skills e hesreallyhim/awesome-claude-code reúnem skills, hooks e plugins da comunidade.
- aitmpl.com: o site do projeto claude-code-templates, com agentes, comandos e configurações prontas para copiar.
No entanto, um alerta sobre rankings: número alto de instalações não garante qualidade. De fato, no ranking aparecem pacotes de automação de redes sociais que não servem para quem programa. Por isso, sugerimos ler o SKILL.md e conferir a data do último commit antes de instalar. Por fim, se o assunto é estender o próprio Claude Code com código, veja também como funcionam os mods do Claude Code.
Vale a pena instalar muitas skills?
Não: poucas Claude Code skills bem descritas rendem mais do que dezenas de genéricas. Afinal, o motivo é duplo. Primeiro, cada skill que o Claude pode invocar sozinho deixa nome e descrição no contexto. Isso vale para todo turno, mesmo sem uso. Além disso, uma descrição vaga faz a skill disparar na hora errada, com regras fora da tarefa.
Por exemplo, o repositório do techknow usa Claude Code skills próprias para componentes, filas de pauta e publicação no WordPress. Na prática, as que mais rendem codificam convenções repetidas. Com elas, o agente acerta de primeira sem receber o mesmo prompt. Portanto, recomendamos começar pela find-skills, somar duas ou três skills do seu stack e escrever descrições bem específicas nas suas.
Outro trade-off é entre Claude Code skills e o CLAUDE.md. Afinal, o CLAUDE.md entra inteiro em toda sessão; logo, ele serve para regras curtas que valem sempre. Já a skill guarda o procedimento longo que só importa às vezes. Dessa forma, o contexto fica limpo e o agente carrega o que importa na hora certa. Além disso, o guia de agentic engineering mostra como organizar esse conjunto num fluxo de time.
Contudo, skills funcionam melhor em projetos com boas práticas de engenharia, como testes e revisão de código. Por isso, para reforçar essa base, recomendamos o livro de Marco Tulio Valente, referência brasileira no assunto.
Conclusão: quais Claude Code skills instalar primeiro
Portanto, as Claude Code skills valem pelo que codificam do seu fluxo, e não pela posição no ranking. Para frontend, por exemplo, a dupla frontend-design e vercel-react-best-practices dá o ganho mais rápido. Já para backend e full-stack, Superpowers ou o pacote de Matt Pocock trazem mais disciplina. De fato, a skill que mais rende costuma ser a que você mesmo escreve.
Assim, um plano em três passos resolve. Primeiro, instale a find-skills e rode /plugin para ver o marketplace oficial. Em seguida, adicione no máximo três skills ligadas ao seu stack. Por fim, transforme a checklist que você mais repete num SKILL.md próprio, usando o exemplo deste guia como base.
O que mudou
- Guia revisado contra a documentação atual: skills absorveram os comandos personalizados, novos campos do frontmatter, instalação por plugins e ranking do skills.sh atualizado.
- Ranking de instalações e estrelas conferido no skills.sh e no GitHub.
Publicidade
Este artigo contém links de afiliado. Se você comprar, podemos receber uma pequena comissão sem custo adicional pra você. Nossas recomendações seguem critérios próprios e independem de comissão.
