A resposta curta
- 1Claude Code:
~/.claude/skills/<name>/SKILL.md, ou.claude/skills/em um projeto - 2Codex:
~/.agents/skills/, ou.agents/skills/em um repositório; ainda lê a antiga~/.codex/skills/ - 3Cursor:
~/.cursor/skills/ou~/.agents/skills/, além das pastas do projeto e das pastas do Claude Code e do Codex
Locais das pastas de Skills no Claude Code, Codex e Cursor
Cada agente tem uma pasta pessoal no seu diretório home e uma pasta de projeto dentro do repositório. Alguns também leem as pastas de outros agentes, e é por isso que uma cópia pode aparecer em mais de uma ferramenta.
| Agente | Pessoal | Projeto | Também lê |
|---|---|---|---|
| Claude Code | ~/.claude/skills/ | .claude/skills/, além das que estão em subpastas quando o Claude trabalha nelas | Configurações gerenciadas Enterprise, plugins, sua conta claude.ai (sincronizada em ~/.claude/skills/synced/) |
| Codex | ~/.agents/skills/ | .agents/skills/, da pasta onde você inicia até a raiz do repositório | ~/.codex/skills/ (antiga), /etc/codex/skills/, Skills do sistema |
| Cursor | ~/.cursor/skills/, ~/.agents/skills/ | .cursor/skills/, .agents/skills/, em qualquer lugar do repositório | .claude/skills/, .codex/skills/ e as duas em ~ |
No Windows, ~ é a sua pasta de usuário, por exemplo C:\Users\you\.claude\skills.
Como deve ser uma pasta de Skills do Claude Code
Cada Skill tem sua própria pasta, e o SKILL.md fica diretamente dentro dela. Arquivos de apoio vão em subpastas ao lado.
~/.claude/skills/
└── launch-page/
├── SKILL.md
├── references/
└── scripts/A armadilha do ZIP
Descompactar costuma adicionar um nível, e você acaba com launch-page/launch-page/SKILL.md. O Claude Code só procura em skills/<name>/SKILL.md, então não vai listar essa Skill. O Cursor e o Codex buscam mais fundo e podem encontrá-la mesmo assim, o que explica os relatos de “funciona no Cursor, não aparece no Claude Code”. Suba a pasta interna um nível e ela funciona em todos.
Qual cópia vence quando duas Skills têm o mesmo nome
Só o Claude Code documenta uma ordem. O Codex pode listar as duas cópias, e o Cursor não diz nada.
| Agente | Mesmo nome em dois lugares |
|---|---|
| Claude Code | Primeiro Enterprise, depois a pessoal e depois a do projeto. Skills de plugin nunca entram em conflito porque levam o nome do plugin. |
| Codex | Não as mescla; as duas podem aparecer. |
| Cursor | Não documentado para Skills. |
Não conte com a ordem. Mantenha uma cópia só ou renomeie uma delas.
Skills nos Cursor Cloud Agents
Só ~/.cursor/skills/ sincroniza com os Cursor Cloud Agents, e só quando Sync Skills for Cloud Agents está ativado. Uma Skill em ~/.agents/skills/ pode funcionar na sua máquina e ainda assim faltar na nuvem.
Depois de mover uma Skill
Na maioria das vezes o agente percebe sozinho. Se a Skill ainda não aparecer, faça o seguinte:
| Agente | Para ver a mudança |
|---|---|
| Claude Code | Nada; rode /reload-skills se a pasta de Skills for nova |
| Codex | Geralmente nada; reinicie se ela não aparecer |
| Cursor | Abra um novo chat ou recarregue a janela |
Perguntas frequentes
Onde as Claude Skills ficam salvas?
Skills pessoais ficam em ~/.claude/skills/<name>/SKILL.md. Skills de projeto ficam em .claude/skills/<name>/SKILL.md dentro do repositório.
Onde fica a pasta de Skills do Codex?
~/.agents/skills/ para Skills pessoais e .agents/skills/ em um repositório. O Codex ainda lê a antiga ~/.codex/skills/, que é onde o $skill-installer da OpenAI coloca as Skills.
Uma única pasta pode servir a todos os agentes?
Não. O Cursor lê todas, mas o Claude Code precisa de ~/.claude/skills/ e o Codex precisa de ~/.agents/skills/ ou ~/.codex/skills/.
Fontes
Este guia ajudou?
