A resposta curta
- 1Coloque a pasta da Skill em
~/.claude/skills/para usá-la em todos os projetos, ou em.claude/skills/para restringi-la a um repositório. - 2Vai instalar com a Skillry CLI? Adicione
--agent claude-code. Sem isso, a Skill vai para~/.agents/skills/, que o Claude Code não lê. - 3Digite
/skillspara confirmar que ela está lá e depois/skill-nameseguido do seu pedido para rodá-la. - 4Quer Skills prontas? Explore Skills para Claude Code que você instala com um comando.
Como adicionar Skills ao Claude Code
Você pode colar um prompt de instalação no Claude Code, rodar a Skillry CLI você mesmo ou copiar a pasta manualmente. Todos os caminhos terminam do mesmo jeito: com a pasta da Skill dentro de ~/.claude/skills/.
A flag que as pessoas esquecem
A Skillry CLI instala em ~/.agents/skills/ por padrão, porque o Codex e o Cursor leem essa pasta. O Claude Code lê a própria, ~/.claude/skills/. Se você deixar de fora o --agent claude-code, a instalação ainda informa sucesso, mas o Claude Code nunca vê a Skill.
- 1
Abra a Skill na Skillry, selecione Copiar prompt de instalação e depois Copiar na janela.
- 2
Cole no Claude Code e envie. O agente lê as instruções de instalação da Skillry e roda o comando certo por conta própria.
Prompt de instalação Read https://skillry.dev/skills/<slug>/install.md and follow the instructions to install the skill. - 3
Quando o navegador pedir que você aprove um código de dispositivo, aprove.
Você deve ver: o Claude Code informando a versão que instalou e a pasta que usou, em
~/.claude/skills/.
- 1
Faça login uma vez. Uma janela do navegador abre com um código de dispositivo para você aprovar.
Terminal npx --yes skillry-cli@latest login - 2
Instale, com
--agent claude-codeno final.Terminal npx --yes skillry-cli@latest install <slug> --agent claude-codeVocê deve ver:
Installed <slug> <version> to ~/.claude/skills/<slug>
Selecione Baixar ZIP na página da Skill ou use uma pasta de Skill que você conseguiu em outro lugar. Leia o SKILL.md e o que houver em scripts/ antes de instalar, já que o agente segue essas instruções e pode rodar esses scripts. Depois mova a pasta inteira:
mkdir -p ~/.claude/skills
mv ~/Downloads/my-skill ~/.claude/skills/ZIPs costumam descompactar com um nível a mais, como my-skill/my-skill/SKILL.md. O SKILL.md precisa ficar diretamente dentro da pasta da Skill, senão o agente não o encontra.
Confira se o Claude Code consegue vê-la
Digite /skills. A lista mostra as suas Skills e algumas que vêm com o Claude Code, como /code-review. Pressione t para ordená-las pelo quanto de contexto cada uma ocupa.
Não é preciso reiniciar. O Claude Code detecta Skills novas e editadas na sessão atual. A única exceção: se ~/.claude/skills/ não existia quando a sessão começou, rode /reload-skills uma vez.
Rode uma Skill como slash command do Claude Code
Cada Skill que você instala aparece como um slash command com o nome dela. Digite o comando e diga o que quer na mesma linha:
/launch-page Parcelo, a parcel-tracking dashboard for small online shopsTudo o que vem depois do nome chega à Skill como $ARGUMENTS. Depois de ver que funciona, você geralmente pode pular o comando e descrever a tarefa com palavras comuns. O Claude carrega uma Skill sozinho quando o seu pedido combina com a descrição dela. Como usar Skills traz mais dicas para obter bons resultados.
Onde o Claude Code procura Skills e qual cópia vence
O Claude Code reúne Skills de cinco lugares. A maioria das pessoas só usa as pastas pessoal e de projeto; as outras aparecem em times ou quando você instala plugins.
| Origem | Local | Comando |
|---|---|---|
| Enterprise | Configurações gerenciadas | /skill-name |
| Pessoal | ~/.claude/skills/<name>/ | /skill-name |
| Projeto | .claude/skills/<name>/ | /skill-name |
| Plugin | <plugin>/skills/<name>/ | /plugin-name:skill-name |
| Sua conta claude.ai | Sincronizada em ~/.claude/skills/synced/ | /name ou /anthropic-skills:name |
Quando o mesmo nome existe em dois lugares, Enterprise vence a pessoal e a pessoal vence a de projeto. Skills no .claude/skills/ de uma subpasta carregam na primeira vez que o Claude trabalha com arquivos dessa subpasta, então as Skills de um pacote em um repositório grande não atrapalham até você precisar delas.
As configurações do SKILL.md que controlam quando ela roda
Estes campos ficam no frontmatter, no topo do SKILL.md. Você só precisa deles quando uma Skill roda demais, de menos ou para pedindo permissão a cada passo.
| Campo no SKILL.md | O que faz |
|---|---|
description | O que o Claude lê para decidir se usa a Skill. Junto com when_to_use, é cortado em 1.536 caracteres na lista de Skills. |
allowed-tools | Ferramentas que o Claude pode usar sem pedir, durante a rodada que invoca a Skill. |
paths | Padrões de arquivo. O Claude só carrega a Skill automaticamente quando está trabalhando com arquivos correspondentes. |
Skill do Claude Code não funciona? Confira isto primeiro
Siga de cima para baixo. A primeira linha, uma Skill na pasta errada, é a causa mais comum.
Não aparece em /skills
Pasta errada, ou um nível a mais vindo do ZIP. Mova-a para que o caminho fique ~/.claude/skills/<name>/SKILL.md, ou reinstale com --agent claude-code.
A pasta é nova
Rode /reload-skills.
Falta em uma sessão na nuvem
Faça commit dela no .claude/skills/ do repositório ou ative-a em claude.ai.
Falta no Cowork
Ative-a na sua conta claude.ai.
Aparece na lista, mas nunca é escolhida
Chame com /name para confirmar que funciona e depois deixe a descrição mais específica. Veja Acionamento.
Todo o resto está em Solução de problemas.
Perguntas frequentes
Skills funcionam no Claude Code?
Sim. O Claude Code segue o padrão aberto Agent Skills e carrega Skills da sua pasta pessoal, do projeto atual, de plugins, da sua organização e da sua conta claude.ai.
Onde ficam as Skills do Claude Code?
As suas Skills ficam em ~/.claude/skills/<name>/SKILL.md. Skills de um projeto ficam em .claude/skills/<name>/SKILL.md dentro desse repositório.
O que aconteceu com os slash commands personalizados?
Continuam funcionando. Um arquivo em .claude/commands/deploy.md e uma Skill chamada deploy dão a você o mesmo /deploy. Se você tiver os dois, a Skill vence.
Por que a Skillry CLI precisa de --agent claude-code?
A pasta padrão dela é ~/.agents/skills/, compartilhada pelo Codex e pelo Cursor. O Claude Code lê ~/.claude/skills/, e a flag aponta a instalação para lá.
Fontes
Este guia ajudou?