Claude Code, Codex e OpenCode carregam skills no mesmo formato: uma pasta com um arquivo SKILL.md dentro. Esse formato é o padrão aberto Agent Skills, que a Anthropic criou e que virou um projeto da Linux Foundation em 4 de novembro de 2026. Por isso, uma mesma skill pode funcionar nas três ferramentas. O problema é que cada ferramenta procura em pastas diferentes, e alguns campos só o Claude Code entende. Este guia mostra onde cada ferramenta procura, como manter uma única cópia que as três carregam, o que não se transfere e como o Orkas entrega as mesmas skills a todos os agentes de programação que ele executa.
Resposta curta: mantenha a pasta de cada skill em ~/.agents/skills. O Codex e o OpenCode já leem essa pasta. O Claude Code não, então adicione um link para cada skill em ~/.claude/skills. Use no frontmatter apenas name e description e dê a cada skill o mesmo nome da pasta dela. Verificado em 8 de novembro de 2026 com Claude Code 2.1.319, Codex 0.167.0 e OpenCode 2.2.6.
Onde o Claude Code, o Codex e o OpenCode procuram skills
| Pasta | Claude Code | Codex | OpenCode |
|---|---|---|---|
~/.agents/skills | Não | Sim | Sim |
.agents/skills em um projeto | Não | Sim | Sim |
~/.claude/skills | Sim | Não | Sim |
.claude/skills em um projeto | Sim | Não | Sim |
~/.codex/skills | Não | Sim, mas obsoleta | Não |
~/.config/opencode/skills, .opencode/skills | Não | Não | Sim |
| Como chamar uma skill | /skill-name | $skill-name ou /skills | @skill-name |
As três ferramentas também escolhem uma skill sozinhas quando o seu pedido corresponde à descrição dela. Nas pastas de projeto, cada ferramenta verifica a pasta em que você a inicia e todas as pastas acima dela até a raiz do repositório.
- O Claude Code é o único que não encontra
.agents/skills. A documentação de skills dele lista apenas pastas.claude, e a documentação de memória diz que ele não lê "nada dentro de um diretório.agents/". O pedido para mudar isso, a issue #31005, continua aberto com mais de 450 votos positivos. - O Codex passou a usar
.agents/skills. A documentação dele lista.agents/skillsno projeto,~/.agents/skillspara o seu usuário e/etc/codex/skillspara administradores. A antiga pasta~/.codex/skillsestá marcada como obsoleta no código-fonte, mas ainda é carregada. O Codex não lê nenhuma pasta.claude. - O OpenCode lê tudo. A documentação dele lista as próprias pastas, além de
.claude/skillse.agents/skills, nos dois níveis. Isso vale para a linha 2.2 e para a linha 1.19, que ainda recebe novas versões.
Configure uma pasta compartilhada
Use ~/.agents/skills como a única cópia real. O Codex e o OpenCode leem essa pasta sem nenhuma configuração, e tanto o npx skills quanto o importador do Codex gravam nela. Depois, o Claude Code recebe um link para cada skill.
- Mova suas skills para
~/.agents/skills. Para cada skill que você escreveu em~/.claude/skillsou~/.codex/skills, mova a pasta dela, por exemplomv ~/.claude/skills/release-notes ~/.agents/skills/. Deixe~/.claude/skills/syncedonde está: é ali que o Claude Code guarda as skills da sua conta do claude.ai. - Crie um link para cada skill na pasta do Claude Code. No macOS ou no Linux, rode isto. O script pula qualquer skill que já tenha uma pasta ou um link ali.
mkdir -p ~/.agents/skills ~/.claude/skills
for d in ~/.agents/skills/*/; do
n=$(basename "$d")
[ -e ~/.claude/skills/"$n" ] || ln -s ~/.agents/skills/"$n" ~/.claude/skills/"$n"
done- No Windows, use junctions. Elas não exigem permissão de administrador. No PowerShell:
New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null
Get-ChildItem "$HOME\.agents\skills" -Directory | ForEach-Object {
$link = "$HOME\.claude\skills\$($_.Name)"
if (-not (Test-Path $link)) { New-Item -ItemType Junction -Path $link -Target $_.FullName | Out-Null }
}- Confira cada ferramenta. Abra uma nova sessão. No Claude Code, digite
/e procure a skill. No Codex, execute/skills. No OpenCode, digite@.
Em um projeto que a equipe compartilha, faça o mesmo dentro do repositório: mantenha as skills em .agents/skills e crie um link para cada uma em .claude/skills com um link relativo, como ln -s ../../.agents/skills/release-notes .claude/skills/release-notes.
Alguns cuidados importantes:
- Crie links para cada skill, não para a pasta inteira. Se o próprio
~/.claude/skillsapontar para~/.agents/skills, as pastassyncede.trashdo Claude Code vão parar na pasta compartilhada, e o Codex e o OpenCode podem carregar também as skills sincronizadas. A desvantagem é que você precisa rodar o loop de novo depois de adicionar uma skill. - Crie links para pastas, não para arquivos SKILL.md. O Codex segue uma pasta de skill linkada, mas ignora um SKILL.md que seja ele próprio um link. A OpenAI fechou esse pedido como não planejado.
- Não faça commit de links se houver colegas no Windows. Por padrão, o Git for Windows faz checkout dos links como pequenos arquivos de texto. Crie os links com um script de configuração ou faça commit de cópias reais.
- O OpenCode vê cada skill duas vezes e fica com uma. Ele lê tanto o link em
~/.claude/skillsquanto a pasta em~/.agents/skills. A versão 2.2 junta as duas sem avisar. A versão 1.19 registra um aviso de duplicata; definaOPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1para que o OpenCode pare de ler as pastas do Claude.
Escreva uma skill que as três ferramentas carregam
Este SKILL.md carrega do mesmo jeito no Claude Code, no Codex e no OpenCode. Ele fica em ~/.agents/skills/release-notes/SKILL.md, com uma pasta references e outra scripts ao lado.
---
name: release-notes
description: "Drafts release notes from git commits since the last tag. Use when the user asks for a changelog, release notes, or what changed since the last release."
license: MIT
---
# Notas de versão
1. Encontre a última tag: git describe --tags --abbrev=0
2. Liste os commits desde essa tag: git log <tag>..HEAD --oneline --no-merges
3. Agrupe os commits em Added, Changed e Fixed, usando references/format.md na pasta desta skill.
4. Para salvar um arquivo, execute scripts/write_notes.sh a partir da pasta desta skill.- Dê à skill o mesmo nome da pasta. Use letras minúsculas, números e hifens, com até 64 caracteres. O Codex usa o
name, o OpenCode 2.2 usa o nome da pasta e o Claude Code aceita qualquer um dos dois. Se forem diferentes, você chama a mesma skill por nomes diferentes em cada ferramenta. O Codex pula uma skill cujo nome tenha mais de 64 caracteres. - Mantenha a descrição com menos de 1.024 caracteres e coloque primeiro as palavras que as pessoas vão usar. Esse é o limite do padrão, e o Codex corta as descrições mais longas nesse tamanho na lista de skills.
- Coloque entre aspas qualquer valor que tenha dois-pontos seguidos de espaço. Caso contrário, o frontmatter pode não ser interpretado. O Codex corrige a maioria desses casos, o Claude Code carrega a skill como se ela não tivesse frontmatter e o OpenCode pode pular a skill sem mostrar erro.
- Faça os scripts encontrarem a própria pasta. As ferramentas executam comandos a partir da pasta do seu projeto, não da pasta da skill. Um script que começa com
cd "$(dirname "$0")"funciona de qualquer lugar. - Não use "claude" no nome se houver chance de você enviar a skill para o claude.ai ou para a Claude API. Os dois rejeitam nomes que contenham "claude" ou "anthropic".
O que não se transfere do Claude Code
O Codex lê apenas name, description e uma descrição curta dentro de metadata. O OpenCode 2.2 também lê metadata e disable-model-invocation. Os dois ignoram todos os outros campos sem dar erro, então uma skill do Claude Code carrega, mas se comporta de outro jeito.
| Em uma skill do Claude Code | Claude Code | Codex | OpenCode 2.2 |
|---|---|---|---|
allowed-tools | Funciona | Ignorado | Ignorado |
disable-model-invocation: true | Funciona | Ignorado; use agents/openai.yaml | Funciona |
context: fork, agent, model, hooks, argument-hint | Funcionam | Ignorados | Ignorados |
$ARGUMENTS e $1 no texto | Substituídos pelos seus argumentos | Ficam como texto | Ficam como texto |
!`command` no texto | Executa antes de o Claude ler a skill | Fica como texto | Fica como texto |
${CLAUDE_SKILL_DIR} | Substituído pela pasta da skill | Fica como texto | Fica como texto |
- Escreva passos que funcionem sem esses recursos. Escreva "execute scripts/check.sh a partir da pasta desta skill" em vez de usar
${CLAUDE_SKILL_DIR}, e peça os detalhes que faltam em linguagem simples em vez de usar$ARGUMENTS. O Claude Code segue essas mesmas instruções sem problema. - Para impedir que o Codex chame uma skill por conta própria, adicione
agents/openai.yamlà pasta da skill comallow_implicit_invocation: falsedentro depolicy. Você ainda pode chamá-la com$skill-name. allowed-toolsnão limita o que o Codex ou o OpenCode podem fazer. A tabela de compatibilidade donpx skillsmostra o campo como suportado nos dois, mas o carregador de skills de nenhuma das duas ferramentas lê esse campo. Defina os limites nas configurações de permissão de cada ferramenta.
Ferramentas que instalam skills para vários agentes
| Ferramenta | Como compartilha as skills | Pontos de atenção |
|---|---|---|
npx skills (Vercel, 38.500 estrelas) | Copia uma skill para .agents/skills e cria um link para ela na pasta de cada agente. Usa junctions no Windows. --copy cria cópias separadas. | Mesma estrutura deste guia. Execute npx skills add owner/repo, com -g para a sua pasta de usuário. |
| skillshare (2.900 estrelas) | Mantém uma pasta de origem e cria links para ela na pasta de cada ferramenta; junctions no Windows. | Atualizado em 6 de novembro de 2026. Instala via Homebrew ou script de shell. |
Codex /import | Copia skills de .claude/skills para .agents/skills. | As cópias ficam diferentes dos originais com o tempo. Ele também troca "claude" por "Codex" no texto, inclusive em caminhos de arquivo (issue aberta #40147). |
| openskills (10.800 estrelas) | Copia skills para .claude/skills e as lista no AGENTS.md. | Sem nova versão desde janeiro de 2026. A opção --universal grava em .agent/skills, que nenhuma das três ferramentas lê. |
E o CLAUDE.md e o AGENTS.md?
O Codex e o OpenCode leem o AGENTS.md, e o OpenCode recorre ao CLAUDE.md quando o projeto não tem AGENTS.md. Desde a versão 2.1.277, o Claude Code também lê o AGENTS.md, mas só em projetos que não têm CLAUDE.md nem CLAUDE.local.md. Se você mantém os dois arquivos, abra /config no Claude Code e configure Project instructions para carregar os dois. Coloque no AGENTS.md as regras que todo agente deve seguir e deixe o CLAUDE.md para o que só o Claude Code precisa.
Use as mesmas skills no Orkas
O Orkas é um app de desktop que executa Claude Code, Codex, OpenCode, OpenClaw e Hermes como agentes em um único chat. Ele usa as cópias instaladas no seu computador e os seus próprios logins. Veja como suas skills chegam a esses agentes.
- A pasta compartilhada continua funcionando. Cada CLI continua lendo as próprias pastas de skills quando o Orkas a inicia, então a configuração acima funciona sem mudanças. O Orkas adiciona o próprio servidor MCP ao lado dos seus, em vez de substituí-los.
- As skills que você adiciona no Orkas chegam a todas as CLIs. Toda CLI que o Orkas inicia recebe um servidor MCP chamado
orkas. Esse servidor lista suas skills do Orkas, carrega uma quando a tarefa corresponde e executa os scripts que vêm com a skill. Peça ao Claude Code para usar uma skill pelo nome ou deixe que ele encontre a certa. - O Orkas também lê suas skills do Claude Code e do Codex. As skills em
~/.claude/skillse~/.codex/skillsaparecem em Habilidades ▸ Pastas globais, e o Commander pode usá-las nas próprias tarefas. O Orkas apenas lê essas pastas e nunca as altera. Ele não lê~/.agents/skillsdiretamente, então, com a configuração acima, encontra suas skills pelos links em~/.claude/skills.
Para adicionar um pacote de skills do GitHub, cole o link do repositório em um chat com o Commander e peça para ele instalar o pacote. Se o pacote precisar instalar dependências, o Orkas pergunta antes. As skills aparecem em Habilidades ▸ Pacotes externos. A partir daí, Claude Code, Codex e OpenCode podem usá-las quando você os executa pelo Orkas, sem copiar nada para três pastas. Para começar, escolha Conectar agentes na barra lateral e selecione as CLIs que você tem instaladas. Para um passo a passo completo de como usar duas delas lado a lado, veja Como usar Claude Code e Codex juntos.
Qual configuração escolher?
| Sua situação | O que fazer |
|---|---|
| Você usa duas ou três dessas ferramentas no mesmo computador | Mantenha as skills em ~/.agents/skills e crie um link para cada uma em ~/.claude/skills |
| Uma equipe compartilha skills em um repositório | Faça commit de .agents/skills; crie os links em .claude/skills com um script de configuração |
| Você instala skills do GitHub com frequência | npx skills add, que cria esses mesmos links para você |
| Você só usa Claude Code e OpenCode | Continue usando ~/.claude/skills; o OpenCode já lê essa pasta |
| Você executa as CLIs pelo Orkas | Instale os pacotes de skills uma vez no Orkas; toda CLI que ele inicia pode usá-los |
Perguntas frequentes
Posso usar skills do Claude no Codex?
Sim. O Codex lê o mesmo formato SKILL.md, mas procura em ~/.agents/skills e .agents/skills, não em ~/.claude/skills. Mova as pastas das skills para lá e crie links de volta para o Claude Code, ou execute /import no Codex para copiá-las. Campos como allowed-tools e recursos como $ARGUMENTS só funcionam no Claude Code.
O OpenCode lê skills do Claude Code?
Sim. O OpenCode lê ~/.claude/skills e .claude/skills, além de ~/.agents/skills e das próprias pastas, então as skills do Claude Code aparecem sem nenhuma configuração. Para desativar isso, defina OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1.
O Claude Code lê .agents/skills?
Não. Em novembro de 2026, o Claude Code só lê skills de pastas .claude, e a documentação dele diz que ignora tudo o que estiver dentro de um diretório .agents. O pedido para adicionar isso, a issue #31005, continua aberto. Até lá, crie um link para cada skill em ~/.claude/skills.
Por que o Codex não enxerga minha skill linkada?
O Codex segue uma pasta de skill linkada, mas ignora um arquivo SKILL.md que seja ele próprio um link. Em vez disso, crie o link para a pasta inteira. Um link relativo é resolvido a partir da pasta onde o link está, então confira se o caminho está certo a partir dali.
Por que uma skill aparece duas vezes?
Normalmente porque há duas cópias em pastas que a ferramenta lê. O Codex ainda lê a antiga pasta ~/.codex/skills além de ~/.agents/skills, e lista as duas cópias de uma skill com o mesmo nome. Mantenha uma cópia em ~/.agents/skills e apague a outra.
Para comparar as três ferramentas além das skills, veja Claude Code vs Codex vs OpenCode.