A resposta curta
- 1Agente já aberto? Use Copiar prompt de instalação. Trabalhando no terminal? Use a CLI. Pegou uma pasta no GitHub? Copie para dentro.
- 2O Claude Code precisa de
--agent claude-code. O Codex e o Cursor usam a pasta padrão,~/.agents/skills/. - 3Você termina quando o
SKILL.mdfica diretamente dentro da pasta da Skill e o seu agente a lista.
Qual método usar?
Decida pelo lugar onde você está agora. Os três terminam do mesmo jeito: com a pasta da Skill onde o seu agente consegue encontrá-la.
Seu agente está aberto
Copiar prompt de instalação na página da Skill e cole no agente
Você gosta de trabalhar no terminal
A Skillry CLI (macOS ou Windows, Node.js 22+)
Você está no Linux ou quer ler os arquivos antes
Baixar ZIP e copie a pasta manualmente
A Skill está no GitHub
Clone ou baixe o repositório e copie a pasta manualmente
Onde cada agente procura Skills?
Cada agente lê Skills da própria pasta, e a CLI escolhe a pasta por você. O Codex e o Cursor leem ~/.agents/skills/, então uma instalação atende os dois.
| Agente | Skillry CLI | Instala em |
|---|---|---|
| Claude Code | --agent claude-code | ~/.claude/skills/<slug>/ |
| Codex | Padrão, sem flag | ~/.agents/skills/<slug>/ |
| Cursor | Padrão, sem flag | ~/.agents/skills/<slug>/ |
Como adicionar Skills ao Claude Code, Codex ou Cursor
Abra a aba do método que você escolheu. Os dois primeiros informam a versão e a pasta ao terminar; numa cópia manual, você confere a pasta por conta própria.
- 1
Na página da Skill, selecione Copiar prompt de instalação e depois Copiar na janela.
- 2
Cole no seu agente. Ele lê as instruções de instalação da Skillry e roda o comando certo para si mesmo.
Prompt de instalação Read https://skillry.dev/skills/<slug>/install.md and follow the instructions to install the skill. - 3
Quando for solicitado, aprove o código de dispositivo no navegador.
Você deve ver: o agente informando a versão que instalou e a pasta que usou.
- 1
Faça login uma vez. Uma janela do navegador abre e pede que você aprove um código de dispositivo.
Terminal npx --yes skillry-cli@latest login - 2
Instale a Skill. Para o Claude Code, adicione
--agent claude-code.Terminal npx --yes skillry-cli@latest install <slug>Você deve ver:
Installed <slug> <version> to ~/.agents/skills/<slug> - 3
Vai reinstalar depois? Adicione
--force. Sem ele, a CLI para em vez de sobrescrever a sua cópia.
A Skillry nunca pede que você cole uma API key. Seu login fica guardado no Keychain do macOS ou no Gerenciador de Credenciais do Windows.
Copie a pasta inteira, não só o SKILL.md. As instruções costumam apontar para arquivos que ficam ao lado dele.
mkdir -p ~/.claude/skills
mv ~/Downloads/my-skill ~/.claude/skills/Um nível de profundidade
~/.claude/skills/my-skill/SKILL.md
Um nível a mais vindo do ZIP
~/.claude/skills/my-skill/my-skill/SKILL.md- ou o
SKILL.mdsolto emskills/
Como instalar uma Skill para um único projeto?
Aponte --target para a pasta de Skills do projeto. A CLI não tem uma opção separada para projeto, mas --target aceita qualquer pasta de Skills, então rode isto de dentro do repositório:
npx --yes skillry-cli@latest install <slug> --target .claude/skillsFaça commit dessa pasta e todo mundo que clonar o repositório recebe a mesma Skill.
Use --agent ou --target, não os dois. A CLI rejeita a combinação.
Como conferir se a instalação funcionou
Tire trinta segundos para confirmar agora, antes de precisar da Skill para um trabalho de verdade.
- 1Abra a pasta e verifique se o
SKILL.mdestá ali mesmo, e não um nível abaixo. - 2Liste suas Skills:
/skillsno Claude Code e no Codex, Customize → Skills no Cursor. - 3Rode uma vez pelo nome.
Não aparece na lista? Solução de problemas passa por todas as causas.
Perguntas frequentes
Como instalo uma Skill com npx?
Rode npx --yes skillry-cli@latest install <slug> e adicione --agent claude-code para o Claude Code. Ele faz o login pelo navegador e mostra onde instalou a Skill.
Como instalo Claude Skills do GitHub?
Baixe ou clone o repositório e mova a pasta da Skill, com o SKILL.md diretamente dentro, para ~/.claude/skills/ ou para a pasta .claude/skills/ do projeto.
Posso adicionar Skills à versão gratuita do Claude?
No Claude Code, no Codex e no Cursor, uma Skill é uma pasta que você mesmo instala. Poder usar Skills no app claude.ai depende do seu plano e das configurações do Claude.
Fontes
Este guia ajudou?
