O Claude Code é onde as skills começaram, e ainda é onde elas rendem mais: lá, as skills podem executar scripts com acesso total à rede, receber argumentos, rodar em seu próprio subagent e substituir os comandos de barra personalizados que você talvez já tenha. Este guia cobre especificamente o lado do Claude Code. Para o formato em geral e para saber de onde vêm as skills, consulte Claude skills and agent skills.
Lemos a documentação e a referência de comandos do Claude Code em 14 de novembro de 2026. A lista acima deste guia traz todas as skills do catálogo do HostedMCP com o comando para instalá-las no Claude Code.
Onde o Claude Code procura
| Escopo | Pasta | Quem tem acesso |
|---|---|---|
| Pessoal | ~/.claude/skills/<name>/SKILL.md |
Você, em todos os projetos |
| Projeto | .claude/skills/<name>/SKILL.md |
Todos que clonam o repositório |
| Aninhado | <subfolder>/.claude/skills/<name>/SKILL.md |
Trabalho naquela parte de um monorepo |
| Plugin | <plugin>/skills/<name>/SKILL.md |
Qualquer pessoa com o plugin, como /plugin:name |
| Organização | A pasta de configurações gerenciadas | Todos sob essa política |
Se dois skills tiverem o mesmo nome, o da organização prevalece sobre o seu, e o seu prevalece sobre o do projeto. Os skills que você ativa no claude.ai são sincronizados em ~/.claude/skills/synced/.
Crie uma
mkdir -p .claude/skills/release-notes
Depois escreva .claude/skills/release-notes/SKILL.md:
---
name: release-notes
description: Write release notes from merged pull requests. Use when the user asks for release notes, a changelog entry or a summary of what shipped.
---
1. List pull requests merged since the last tag with `gh pr list --state merged`.
2. Group them under Added, Changed and Fixed.
3. Write one plain sentence per change, for users rather than developers.
Essa é uma skill funcional. O Claude Code a reconhece sem reiniciar. Peça as notas de versão e ele vai usá-la, ou digite /release-notes.
Mantenha o SKILL.md com menos de 500 linhas e mova o conteúdo longo para arquivos ao lado dele, que as instruções devem apontar. O plugin skill-creator da Anthropic, /plugin install skill-creator@claude-plugins-official, consegue testar uma skill com e sem ela carregada e ajustar a descrição dela.
Como invocar
| Frontmatter | Você pode digitar /name |
O Claude usa por conta própria | Descrição no contexto |
|---|---|---|---|
| Padrão | Sim | Sim | Sempre |
disable-model-invocation: true |
Sim | Não | Não |
user-invocable: false |
Não | Sim | Sempre |
/name só funciona no início de uma mensagem, e é possível encadear até seis. As skills aceitam argumentos: $ARGUMENTS no corpo vira o que você digitar depois do nome, e argument-hint mostra uma dica no menu.
Alguns outros campos que o Claude Code adiciona ao padrão: when_to_use para uma descrição de gatilho separada, model e effort para executar uma skill em outro modelo ou nível de esforço, allowed-tools e disallowed-tools, e context: fork para executar a skill em um subagente, de modo que o trabalho dela não ocupe sua conversa principal.
Os comandos de barra personalizados foram incorporados às skills. .claude/commands/deploy.md e .claude/skills/deploy/SKILL.md criam ambos /deploy, e os arquivos de comando antigos continuam funcionando.
As skills que acompanham o Claude Code
A referência de comandos do Claude Code marca 20 comandos como skills. Estes são os que você vai encontrar com mais frequência:
| Skill | O que faz |
|---|---|
/code-review |
Revisa um diff, branch ou pull request em busca de bugs no nível de esforço que você escolher, e pode corrigir ou comentar |
/simplify |
Quatro agentes de revisão procuram problemas de reutilização, simplificação, eficiência e abstração, e então aplicam as correções |
/batch |
Divide uma mudança grande em 5 a 30 unidades e executa um agente em segundo plano por unidade |
/debug |
Ativa o log de depuração da sessão e lê o log |
/loop |
Executa um prompt novamente em um intervalo, ou regula o próprio ritmo |
/run e /verify |
Iniciam o app e verificam se uma mudança realmente funciona |
/doctor |
Verifica a instalação, as configurações, as extensões e o CLAUDE.md |
/fewer-permission-prompts |
Transforma comandos somente leitura que você aprova com frequência em uma allowlist |
/update-config |
Edita o settings.json a partir de uma descrição simples |
/claude-api |
Carrega a referência atual da Claude API e do SDK |
/dataviz |
Orientações sobre gráficos e dashboards com um validador de paleta |
O /init, que escreve um CLAUDE.md para um novo projeto, é um comando integrado e não uma skill, e /review é um alias de /code-review. O Claude Code não inclui as skills de documentos da Anthropic para Word, PDF, PowerPoint e Excel; instale essas a partir do repositório anthropics/skills.
Quanto custam as skills
Toda skill que o Claude pode acionar por conta própria coloca sua descrição no contexto a cada turno. O Claude Code limita isso de duas formas:
- Cada descrição, junto com
when_to_use, é cortada em 1.536 caracteres na listagem. - Todas as descrições juntas compartilham um orçamento de cerca de 1% da janela de contexto do modelo. Ao ultrapassar esse limite, o Claude Code descarta as descrições começando pelas skills menos usadas e mantém apenas seus nomes.
Depois de usada, o conteúdo de uma skill permanece na conversa. Após uma compactação automática, o uso mais recente de cada skill é reanexado, até 5.000 tokens por skill e 25.000 no total.
/skills lista suas skills e pode ordená-las por custo em tokens; /skill-doctor informa o custo de contexto de cada skill e com que frequência ela é usada. Uma skill que você só aciona manualmente deve ter disable-model-invocation: true, o que remove totalmente sua descrição do contexto.
Skill, hook, subagent, MCP ou plugin
| Você quer | Use | Por quê |
|---|---|---|
| Fatos que o Claude precisa em toda sessão | CLAUDE.md | Carrega sempre; mantenha com menos de 200 linhas |
| Conhecimento para algumas tarefas | Um skill | Carrega apenas quando for relevante |
| Algo que aconteça sempre | Um hook | Determinístico, sem custo de contexto; "coloque guardrails em hooks" |
| Trabalho pesado fora do seu contexto | Um subagent | Contexto separado, retorna um resumo |
| Ferramentas ou dados de outro sistema | Um MCP server | Um skill pode ensinar o Claude a usá-lo |
| Tudo isso para uma equipe | Um plugin | Empacota tudo em uma única instalação |
A combinação que a Anthropic mais documenta é um skill com um MCP server: o server fornece as ferramentas, o skill fornece o julgamento sobre quando e como usá-las.
Segurança
Skills no Claude Code podem executar qualquer script com os direitos do seu usuário e acesso total à rede. Leia os scripts de qualquer skill que você não escreveu. allowed-tools permite que uma skill use ferramentas sem pedir sua permissão; isso não restringe nada. Em um projeto, revise .claude/skills/ nos pull requests como você revisaria código. As organizações podem bloquear isso com configurações gerenciadas, incluindo permitir apenas skills de marketplaces de plugins aprovados.
Quando não funciona
| O que você vê | Causa | Correção |
|---|---|---|
| Claude ignora a skill | A descrição não corresponde ao que você escreveu | Reescreva-a; adicione when_to_use |
/name não encontrado |
O nome da pasta e o name são diferentes, ou há uma nova pasta de nível superior |
Iguale os dois; execute /reload-skills |
| Uma skill de plugin tem um nome diferente | Skills de plugin usam namespace | Digite /plugin:name |
| Algumas skills perderam as descrições | Orçamento de listagem excedido | Remova skills não utilizadas ou defina disable-model-invocation: true |
| Sua skill está sendo sobreposta | Uma skill da organização ou pessoal com o mesmo nome | Renomeie a sua |