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
| Pasta | Claude Code | Codex | OpenCode |
|---|---|---|---|
~/.agents/skills | Não | Sim | Sim |
.agents/skills num projeto | Não | Sim | Sim |
~/.claude/skills | Sim | Não | Sim |
.claude/skills num 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 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/skillsno projeto,~/.agents/skillspara o utilizador e/etc/codex/skillspara administradores. A antiga pasta~/.codex/skillsestá 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/skillse.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.
- Mova as suas skills para
~/.agents/skills. Para cada skill que escreveu em~/.claude/skillsou~/.codex/skills, mova a respetiva pasta, por exemplomv ~/.claude/skills/release-notes ~/.agents/skills/. Deixe~/.claude/skills/syncedonde está: é aí que o Claude Code guarda as skills da sua conta claude.ai. - 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- 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 }
}- 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/skillsapontar para~/.agents/skills, as pastassyncede.trashdo 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/skillscomo a pasta em~/.agents/skills. A versão 2.2 junta-as sem avisar. A versão 1.19 regista um aviso de duplicado; definaOPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1para 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 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 | Corre 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 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 comallow_implicit_invocation: falseempolicy. Continua a poder invocá-la com$skill-name. allowed-toolsnão limita o que o Codex ou o OpenCode podem fazer. A tabela de compatibilidade donpx skillsindica-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
| Ferramenta | Como partilha as skills | Pontos 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 /import | Copia 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/skillse~/.codex/skillsaparecem 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/skillsdiretamente, 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.
Que configuração escolher?
| A sua situação | O que fazer |
|---|---|
| Usa duas ou três destas ferramentas no mesmo computador | Guarde as skills em ~/.agents/skills e crie uma ligação para cada uma em ~/.claude/skills |
| Uma equipa partilha skills num repositório | Faça commit de .agents/skills; crie as ligações em .claude/skills com um script de configuração |
| Instala skills do GitHub com frequência | npx skills add, que cria essas mesmas ligações por si |
| Só usa o Claude Code e o OpenCode | Continue a usar ~/.claude/skills; o OpenCode já a lê |
| Executa as CLI a partir do Orkas | Instale 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.