Acesse todas as Skills Premium por US$ 9,99/mês. Cancele quando quiser.Ver planos

Guia rápido de Skills do Claude Code (com Codex e Cursor)

As pastas, comandos, campos do SKILL.md e limites que você mais consulta, para Claude Code, Codex, Cursor e a Skillry CLI. Deixe aberto em uma aba ou imprima.

Para
Quem usa Skills
Abrange
Claude Code, Codex, Cursor, Skillry CLI
Tempo
2 min para consultar

A resposta curta

  1. 1Pastas: ~/.claude/skills · ~/.agents/skills (+ a antiga ~/.codex/skills) · ~/.cursor/skills
  2. 2Rodar uma: /name (Claude Code, Cursor) · $name (Codex) · @name anexa no Cursor
  3. 3Ver o que está instalado: /skills · Customize → Skills
  4. 4Instalar: npx --yes skillry-cli@latest install <slug>, adicione --agent claude-code para o Claude Code

Pastas de Skills de cada agente

Skills pessoais funcionam em qualquer projeto que você abrir. Skills de projeto ficam dentro do repositório, então todo mundo que clonar recebe as mesmas.

AgentePessoalProjeto
Claude Code~/.claude/skills/.claude/skills/
Codex~/.agents/skills/ (antiga: ~/.codex/skills/).agents/skills/, da pasta onde você inicia até a raiz do repositório
Cursor~/.cursor/skills/, ~/.agents/skills/.cursor/skills/, .agents/skills/

Todas as pastas que cada agente lê, e qual cópia vence quando duas têm o mesmo nome: Locais das Skills.

Comandos de Skills no Claude Code, Codex e Cursor

Chamar uma Skill pelo nome é o jeito mais rápido de verificar se ela está instalada. Se rodar, o agente consegue enxergá-la.

TarefaClaude CodeCodexCursor
Listar Skills/skills/skillsCustomize → Skills
Rodar uma/name$name/name, @name
Skill de plugin/plugin:namevia pluginvia plugin
Manter ativa——Option/Alt+Enter (Custom Mode)
Depois de editarDetectada na hora; /reload-skills para uma pasta novaDetectada na hora; reinicie se não forNovo chat ou recarregue a janela

Campos do frontmatter do SKILL.md

Cada Skill tem um arquivo SKILL.md, e as configurações dele ficam entre duas linhas --- no topo. Estes são os campos que mudam como o agente a trata.

CampoLimite / efeitoClaude CodeCodexCursor
name≤64 caracteres; a–z, 0–9 e hífens; igual ao nome da pastaopcionalobrigatórioobrigatório
description≤1.024 caracteres; diga o que ela faz e quando usá-larecomendadoobrigatórioobrigatório
allowed-toolsFerramentas que ela pode usar sem pedir permissão (experimental na especificação)sim——
pathsRoda sozinha apenas para padrões de arquivo correspondentessim—sim

Comandos da Skillry CLI

A Skillry CLI baixa uma Skill da Skillry e a coloca na pasta certa para o seu agente.

ComandoO que faz
skillry-cli loginFaz login pelo navegador com um código de dispositivo
skillry-cli statusMostra com qual conta você está conectado
skillry-cli install <slug>Instala em ~/.agents/skills/<slug>/
--agent claude-code…instala em ~/.claude/skills/<slug>/
--target <dir>…instala em qualquer pasta de Skills, por exemplo .claude/skills
--forceSubstitui uma cópia existente e guarda um backup
skillry-cli logoutFaz logout e revoga a sessão

Comece cada comando com npx --yes skillry-cli@latest. Roda no macOS ou no Windows com Node.js 22+. Não dá para usar --agent e --target juntos.

Perguntas frequentes

Quais são os comandos do Claude Code para Skills?

/skills lista suas Skills, /skill-name roda uma, /plugin-name:skill-name roda uma Skill que veio com um plugin e /reload-skills detecta uma pasta de Skills que você acabou de criar.

Onde as diferenças entre os agentes são explicadas?

Comparar agentes cobre os mesmos fatos com exemplos práticos.

Fontes

Este guia ajudou?