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

Usar um único 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 procura cada ferramenta, como manter uma única cópia que as três carreguem, o que não passa do Claude Code para as outras e como o Orkas disponibiliza as mesmas skills a todas as CLI que executa.

O Claude Code, o Codex e o OpenCode carregam skills no mesmo formato: uma pasta com um ficheiro SKILL.md lá dentro. Este formato é a norma aberta Agent Skills, criada pela Anthropic, que passou a ser um projeto da Linux Foundation a 4 de novembro de 2026. Assim, a mesma skill pode funcionar nas três ferramentas. O problema é que cada ferramenta procura em pastas diferentes e há campos que só o Claude Code entende. Este guia mostra onde procura cada ferramenta, como manter uma única cópia que as três carreguem, o que não passa para as outras ferramentas e como o Orkas disponibiliza as mesmas skills a todos os agentes de programação que executa.

Resumindo: guarde a pasta de cada skill em ~/.agents/skills. O Codex e o OpenCode já leem essa pasta. O Claude Code não, por isso adicione uma ligação para cada skill em ~/.claude/skills. Limite o frontmatter a name e description e dê a cada skill o mesmo nome da respetiva pasta. Verificado a 8 de novembro de 2026 com o Claude Code 2.1.319, o Codex 0.167.0 e o OpenCode 2.2.6.

Onde o Claude Code, o Codex e o OpenCode procuram skills

PastaClaude CodeCodexOpenCode
~/.agents/skillsNãoSimSim
.agents/skills num projetoNãoSimSim
~/.claude/skillsSimNãoSim
.claude/skills num projetoSimNãoSim
~/.codex/skillsNãoSim, mas obsoletaNão
~/.config/opencode/skills, .opencode/skillsNãoNãoSim
Como invocar uma skill/skill-name$skill-name ou /skills@skill-name

As três também escolhem uma skill por iniciativa própria quando o seu pedido corresponde à descrição dela. Nas pastas de projeto, cada ferramenta verifica a pasta a partir da qual a inicia e todas as pastas acima até à raiz do repositório.

  • O Claude Code é o único que não encontra .agents/skills. A documentação sobre skills só refere pastas .claude, e a documentação sobre memória diz que não lê «nada que esteja dentro de um diretório .agents/». O pedido para mudar isto, a issue #31005, continua aberto, com mais de 450 votos positivos.
  • O Codex mudou para .agents/skills. A documentação indica .agents/skills no projeto, ~/.agents/skills para o utilizador e /etc/codex/skills para administradores. A antiga pasta ~/.codex/skills está marcada como obsoleta no código-fonte, mas continua a ser carregada. O Codex não lê nenhuma pasta .claude.
  • O OpenCode lê tudo. A documentação indica as suas próprias pastas, além de .claude/skills e .agents/skills, nos dois níveis. Isto aplica-se à linha 2.2 e à linha 1.19, que continua a receber novas versões.

Configurar uma pasta partilhada

Use ~/.agents/skills como a única cópia real. O Codex e o OpenCode leem-na sem qualquer configuração, e tanto o npx skills como o importador do Codex escrevem aí. Depois, o Claude Code recebe uma ligação para cada skill.

  1. Mova as suas skills para ~/.agents/skills. Para cada skill que escreveu em ~/.claude/skills ou ~/.codex/skills, mova a respetiva pasta, por exemplo mv ~/.claude/skills/release-notes ~/.agents/skills/. Deixe ~/.claude/skills/synced onde está: é aí que o Claude Code guarda as skills da sua conta claude.ai.
  2. Crie uma ligação para cada skill na pasta do Claude Code. No macOS ou no Linux, execute o seguinte. O script ignora qualquer skill que já tenha aí uma pasta ou uma ligação.
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 junções (junctions). Não precisam de direitos 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. Verifique cada ferramenta. Inicie uma nova sessão. No Claude Code, escreva / e procure a skill. No Codex, execute /skills. No OpenCode, escreva @.

Num projeto partilhado pela equipa, faça o mesmo dentro do repositório: guarde as skills em .agents/skills e crie uma ligação para cada uma em .claude/skills com uma ligação relativa, como ln -s ../../.agents/skills/release-notes .claude/skills/release-notes.

Alguns cuidados a ter:

  • Crie ligações 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 à pasta partilhada, e o Codex e o OpenCode podem carregar também as skills sincronizadas. O preço a pagar é ter de voltar a correr o ciclo depois de adicionar uma skill.
  • Crie ligações para pastas, não para ficheiros SKILL.md. O Codex segue uma pasta de skill ligada, mas ignora um SKILL.md que seja, ele próprio, uma ligação. A OpenAI fechou esse pedido como não planeado.
  • Não faça commit de ligações se houver colegas a usar Windows. Por predefinição, o Git for Windows faz checkout das ligações como pequenos ficheiros de texto. Crie as ligações 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. Lê tanto a ligação em ~/.claude/skills como a pasta em ~/.agents/skills. A versão 2.2 junta-as sem avisar. A versão 1.19 regista um aviso de duplicado; defina OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1 para que o OpenCode deixe de ler as pastas do Claude.

Escrever uma skill que as três conseguem carregar

Este SKILL.md carrega da mesma forma no Claude Code, no Codex e no OpenCode. 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. Encontrar a última tag: git describe --tags --abbrev=0
2. Listar os commits desde essa tag: git log <tag>..HEAD --oneline --no-merges
3. Agrupar os commits em Added, Changed e Fixed, segundo references/format.md na pasta desta skill.
4. Para guardar um ficheiro, executar scripts/write_notes.sh a partir da pasta desta skill.
  • Dê à skill o mesmo nome da pasta. Use letras minúsculas, números e hífenes, até 64 caracteres. O Codex usa o name, o OpenCode 2.2 usa o nome da pasta e o Claude Code aceita qualquer um. Se forem diferentes, invoca a mesma skill com nomes diferentes em cada ferramenta. O Codex ignora uma skill cujo nome tenha mais de 64 caracteres.
  • Mantenha a descrição abaixo dos 1024 caracteres e ponha primeiro as palavras que as pessoas vão usar. É o limite da norma, e o Codex corta as descrições mais longas para esse comprimento na lista de skills.
  • Ponha entre aspas qualquer valor que contenha dois pontos seguidos de um espaço. Caso contrário, o frontmatter pode não ser interpretado. O Codex corrige a maioria destes casos, o Claude Code carrega a skill como se não tivesse frontmatter e o OpenCode pode ignorar a skill sem dar erro.
  • Faça com que os scripts encontrem a sua própria pasta. As ferramentas executam os comandos a partir da pasta do projeto, não da pasta da skill. Um script que comece com cd "$(dirname "$0")" funciona a partir de qualquer sítio.
  • Não inclua "claude" no nome se houver hipótese de carregar a skill no claude.ai ou na Claude API. Ambos rejeitam nomes que contenham "claude" ou "anthropic".

O que não passa do Claude Code para as outras ferramentas

O Codex só lê name, description e uma descrição curta em metadata. O OpenCode 2.2 também lê metadata e disable-model-invocation. Ambos ignoram todos os outros campos sem dar erro, por isso uma skill do Claude Code carrega, mas comporta-se de forma diferente.

Numa 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 textoCorre 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 estas funcionalidades. Escreva «executar scripts/check.sh a partir da pasta desta skill» em vez de usar ${CLAUDE_SKILL_DIR}, e peça os dados em falta por palavras simples em vez de usar $ARGUMENTS. O Claude Code segue estas mesmas instruções sem problemas.
  • Para impedir que o Codex invoque uma skill por iniciativa própria, adicione agents/openai.yaml à pasta da skill com allow_implicit_invocation: false em policy. Continua a poder invocá-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 indica-o como suportado em ambos, mas o carregador de skills de nenhuma das duas ferramentas lê esse campo. Defina os limites nas definições de permissões de cada ferramenta.

Ferramentas que instalam skills para vários agentes

FerramentaComo partilha as skillsPontos de atenção
npx skills (Vercel, 38 500 estrelas)Copia uma skill para .agents/skills e liga-lhe a pasta de cada agente. Usa junções no Windows. --copy cria cópias independentes.A mesma estrutura deste guia. Execute npx skills add owner/repo, com -g para a sua pasta de utilizador.
skillshare (2900 estrelas)Mantém uma pasta de origem e liga-a à pasta de cada ferramenta; junções no Windows.Atualizado a 6 de novembro de 2026. Instala-se com Homebrew ou com um script de shell.
Codex /importCopia skills de .claude/skills para .agents/skills.As cópias deixam de corresponder aos originais. Também troca "claude" por "Codex" no texto, incluindo em caminhos de ficheiros (issue aberta #40147).
openskills (10 800 estrelas)Copia skills para .claude/skills e lista-as no AGENTS.md.Sem nova versão desde janeiro de 2026. A opção --universal escreve 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 um projeto não tem AGENTS.md. Desde a versão 2.1.277, o Claude Code também lê o AGENTS.md, mas apenas em projetos sem CLAUDE.md nem CLAUDE.local.md. Se mantiver os dois ficheiros, abra /config no Claude Code e defina Project instructions para carregar ambos. Ponha no AGENTS.md as regras que todos os agentes devem seguir e reserve o CLAUDE.md para o que só o Claude Code precisa.

Usar as mesmas skills a partir do Orkas

O Orkas é uma aplicação para computador que executa o Claude Code, o Codex, o OpenCode, o OpenClaw e o Hermes como agentes num único chat. Usa as cópias instaladas no seu computador e as contas com que já tem sessão iniciada. Eis como as suas skills chegam a esses agentes.

  • A pasta partilhada continua a funcionar. Cada CLI continua a ler as suas próprias pastas de skills quando o Orkas a inicia, por isso a configuração acima funciona sem alterações. O Orkas adiciona o seu próprio servidor MCP junto dos servidores que já tem, em vez de os substituir.
  • As skills que adiciona no Orkas chegam a todas as CLI. Todas as CLI que o Orkas inicia recebem um servidor MCP chamado orkas. Este servidor lista as suas skills do Orkas, carrega uma quando a tarefa corresponde e executa os scripts que acompanham a skill. Peça ao Claude Code que use uma skill pelo nome ou deixe-o encontrar a mais adequada.
  • O Orkas também lê as suas skills do Claude Code e do Codex. As skills em ~/.claude/skills e ~/.codex/skills aparecem em Competências ▸ Pastas globais, e o Commander pode usá-las nas suas próprias tarefas. O Orkas limita-se a ler estas pastas e nunca as altera. Não lê ~/.agents/skills diretamente, por isso, com a configuração acima, encontra as suas skills através das ligações em ~/.claude/skills.

Para adicionar um pacote de skills do GitHub, cole a ligação do repositório num chat com o Commander e peça-lhe que instale o pacote. Se o pacote precisar de instalar dependências, o Orkas pergunta-lhe primeiro. As skills aparecem em Competências ▸ Pacotes externos. A partir daí, o Claude Code, o Codex e o OpenCode podem todos usá-las quando os executa a partir do Orkas, sem copiar nada para três pastas. Para começar, escolha Ligar agentes na barra lateral e selecione as CLI que tem instaladas. Para um guia completo sobre como usar duas delas lado a lado, consulte Como usar Claude Code e Codex juntos.

Execute-os a partir do Orkas Dê as mesmas skills ao Claude Code, ao Codex e ao OpenCode a partir de uma única aplicação. O Orkas é gratuito no macOS e no Windows. Executa as CLI que já tem, com as suas próprias contas.
Descarregar Orkas — grátis

Que configuração escolher?

A sua situaçãoO que fazer
Usa duas ou três destas ferramentas no mesmo computadorGuarde as skills em ~/.agents/skills e crie uma ligação para cada uma em ~/.claude/skills
Uma equipa partilha skills num repositórioFaça commit de .agents/skills; crie as ligações em .claude/skills com um script de configuração
Instala skills do GitHub com frequêncianpx skills add, que cria essas mesmas ligações por si
Só usa o Claude Code e o OpenCodeContinue a usar ~/.claude/skills; o OpenCode já a lê
Executa as CLI a partir do OrkasInstale os pacotes de skills uma vez no Orkas; todas as CLI que ele inicia podem 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 para lá as pastas das skills e crie ligações de volta para o Claude Code, ou execute /import no Codex para as copiar. Campos como allowed-tools e funcionalidades como $ARGUMENTS só funcionam no Claude Code.

O OpenCode lê as skills do Claude Code?

Sim. O OpenCode lê ~/.claude/skills e .claude/skills, além de ~/.agents/skills e das suas próprias pastas, por isso as skills do Claude Code aparecem sem qualquer configuração. Para desativar isto, 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 diz que ignora tudo o que esteja dentro de um diretório .agents. O pedido para acrescentar isso, a issue #31005, continua aberto. Até lá, crie uma ligação para cada skill em ~/.claude/skills.

Porque é que o Codex não vê a minha skill ligada?

O Codex segue uma pasta de skill ligada, mas ignora um ficheiro SKILL.md que seja, ele próprio, uma ligação. Crie antes a ligação para a pasta inteira. Uma ligação relativa é resolvida a partir da pasta onde a ligação se encontra, por isso confirme que o caminho está correto a partir daí.

Porque é 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 para lá das skills, consulte Claude Code vs Codex vs OpenCode.