Orkas Orkas
Início Blog Skills no Codex e OpenCode
Produto

Como usar o mesmo conjunto de skills no Claude Code, no Codex e no OpenCode

As três ferramentas carregam o mesmo formato SKILL.md, mas cada uma procura em pastas diferentes. Veja onde cada ferramenta procura, como manter uma única cópia que as três carregam, o que não se transfere do Claude Code e como o Orkas entrega as mesmas skills a todas as CLIs que executa.

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

PastaClaude CodeCodexOpenCode
~/.agents/skillsNãoSimSim
.agents/skills em um projetoNãoSimSim
~/.claude/skillsSimNãoSim
.claude/skills em um projetoSimNãoSim
~/.codex/skillsNãoSim, mas obsoletaNão
~/.config/opencode/skills, .opencode/skillsNãoNãoSim
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/skills no projeto, ~/.agents/skills para o seu usuário e /etc/codex/skills para administradores. A antiga pasta ~/.codex/skills está 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/skills e .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.

  1. Mova suas skills para ~/.agents/skills. Para cada skill que você escreveu em ~/.claude/skills ou ~/.codex/skills, mova a pasta dela, por exemplo mv ~/.claude/skills/release-notes ~/.agents/skills/. Deixe ~/.claude/skills/synced onde está: é ali que o Claude Code guarda as skills da sua conta do claude.ai.
  2. 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
  1. 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 }
}
  1. 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/skills apontar para ~/.agents/skills, as pastas synced e .trash do 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/skills quanto 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; defina OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1 para 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 CodeClaude CodeCodexOpenCode 2.2
allowed-toolsFuncionaIgnoradoIgnorado
disable-model-invocation: trueFuncionaIgnorado; use agents/openai.yamlFunciona
context: fork, agent, model, hooks, argument-hintFuncionamIgnoradosIgnorados
$ARGUMENTS e $1 no textoSubstituídos pelos seus argumentosFicam como textoFicam como texto
!`command` no textoExecuta antes de o Claude ler a skillFica como textoFica como texto
${CLAUDE_SKILL_DIR}Substituído pela pasta da skillFica como textoFica 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 com allow_implicit_invocation: false dentro de policy. Você ainda pode chamá-la com $skill-name.
  • allowed-tools não limita o que o Codex ou o OpenCode podem fazer. A tabela de compatibilidade do npx skills mostra 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

FerramentaComo compartilha as skillsPontos 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 /importCopia 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/skills e ~/.codex/skills aparecem 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/skills diretamente, 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.

Execute-os pelo Orkas Dê as mesmas skills ao Claude Code, ao Codex e ao OpenCode a partir de um único app. O Orkas é gratuito no macOS e no Windows. Ele executa as CLIs que você já tem, com os seus próprios logins.
Baixar o Orkas — grátis

Qual configuração escolher?

Sua situaçãoO que fazer
Você usa duas ou três dessas ferramentas no mesmo computadorMantenha as skills em ~/.agents/skills e crie um link para cada uma em ~/.claude/skills
Uma equipe compartilha skills em um repositórioFaça commit de .agents/skills; crie os links em .claude/skills com um script de configuração
Você instala skills do GitHub com frequêncianpx skills add, que cria esses mesmos links para você
Você só usa Claude Code e OpenCodeContinue usando ~/.claude/skills; o OpenCode já lê essa pasta
Você executa as CLIs pelo OrkasInstale 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.