Orkas Orkas
Pagina iniziale Blog Skill in Codex e OpenCode
Prodotto

Come usare un unico set di skill in Claude Code, Codex e OpenCode

Tutti e tre caricano lo stesso formato SKILL.md, ma ognuno cerca in cartelle diverse. Ecco dove cerca ciascuno strumento, come tenere una sola copia che tutti e tre caricano, cosa non si porta dietro da Claude Code e come Orkas fornisce le stesse skill a ogni CLI che esegue.

Claude Code, Codex e OpenCode caricano tutti le skill nello stesso formato: una cartella con dentro un file SKILL.md. Il formato è lo standard aperto Agent Skills, creato da Anthropic e diventato un progetto della Linux Foundation il 4 novembre 2026. Quindi una stessa skill può funzionare in tutti e tre gli strumenti. Il problema è che ogni strumento cerca in cartelle diverse, e alcuni campi li capisce solo Claude Code. Questa guida spiega dove cerca ciascuno strumento, come tenere una sola copia che tutti e tre caricano, cosa non si porta dietro e come Orkas fornisce le stesse skill a ogni agente di programmazione che esegue.

In breve: tieni la cartella di ogni skill in ~/.agents/skills. Codex e OpenCode leggono già quella cartella. Claude Code no, quindi aggiungi un link a ogni skill in ~/.claude/skills. Limita il frontmatter a name e description e dai a ogni skill lo stesso nome della sua cartella. Verificato l'8 novembre 2026 con Claude Code 2.1.319, Codex 0.167.0 e OpenCode 2.2.6.

Dove cercano le skill Claude Code, Codex e OpenCode

CartellaClaude CodeCodexOpenCode
~/.agents/skillsNoSìSì
.agents/skills in un progettoNoSìSì
~/.claude/skillsSìNoSì
.claude/skills in un progettoSìNoSì
~/.codex/skillsNoSì, ma deprecataNo
~/.config/opencode/skills, .opencode/skillsNoNoSì
Come si richiama una skill/skill-name$skill-name o /skills@skill-name

Tutti e tre scelgono anche una skill da soli quando la tua richiesta corrisponde alla sua descrizione. Per le cartelle di progetto, ogni strumento controlla la cartella da cui lo avvii e tutte le cartelle superiori fino alla radice del repository.

  • Claude Code è l'unico che non trova .agents/skills. La sua documentazione sulle skill elenca solo cartelle .claude, e la documentazione sulla memoria dice che non legge «nulla che si trovi in una directory .agents/». La richiesta per cambiare questo comportamento, la issue #31005, è ancora aperta con più di 450 voti positivi.
  • Codex è passato a .agents/skills. La sua documentazione indica .agents/skills nel progetto, ~/.agents/skills per il tuo utente e /etc/codex/skills per gli amministratori. La vecchia cartella ~/.codex/skills è segnata come deprecata nel codice sorgente, ma viene ancora caricata. Codex non legge nessuna cartella .claude.
  • OpenCode legge tutto. La sua documentazione elenca le sue cartelle più .claude/skills e .agents/skills, a entrambi i livelli. Vale per la serie 2.2 e per la serie 1.19, che continua a ricevere nuove release.

Configurare una cartella condivisa

Usa ~/.agents/skills come unica copia reale. Codex e OpenCode la leggono senza alcuna configurazione, e sia npx skills sia l'importatore di Codex scrivono lì. Claude Code riceve poi un link a ogni skill.

  1. Sposta le tue skill in ~/.agents/skills. Per ogni skill che hai scritto in ~/.claude/skills o ~/.codex/skills, sposta la sua cartella, per esempio mv ~/.claude/skills/release-notes ~/.agents/skills/. Lascia ~/.claude/skills/synced dov'è: lì Claude Code tiene le skill del tuo account claude.ai.
  2. Collega ogni skill nella cartella di Claude Code. Su macOS o Linux, esegui questo script. Salta le skill che hanno già lì una cartella o un link.
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. Su Windows, usa le junction. Non richiedono diritti di amministratore. In 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. Controlla ogni strumento. Avvia una nuova sessione. In Claude Code, digita / e cerca la skill. In Codex, esegui /skills. In OpenCode, digita @.

Per un progetto condiviso dal team, fai lo stesso dentro il repository: tieni le skill in .agents/skills e collega ciascuna da .claude/skills con un link relativo, ad esempio ln -s ../../.agents/skills/release-notes .claude/skills/release-notes.

Alcuni dettagli a cui fare attenzione:

  • Collega ogni skill, non l'intera cartella. Se ~/.claude/skills stessa punta a ~/.agents/skills, le cartelle synced e .trash di Claude Code finiscono nella cartella condivisa, e Codex e OpenCode potrebbero caricare anche le skill sincronizzate. Il prezzo da pagare è che devi rieseguire il ciclo dopo aver aggiunto una skill.
  • Collega le cartelle, non i file SKILL.md. Codex segue una cartella di skill collegata, ma ignora un SKILL.md che sia esso stesso un link. OpenAI ha chiuso quella richiesta come non pianificata.
  • Non fare commit dei link se nel team c'è chi usa Windows. Per impostazione predefinita, Git for Windows fa il checkout dei link come piccoli file di testo. Crea i link con uno script di setup, oppure fai commit di copie reali.
  • OpenCode vede ogni skill due volte e ne tiene una. Legge sia il link in ~/.claude/skills sia la cartella in ~/.agents/skills. La versione 2.2 le unisce senza segnalarlo. La versione 1.19 registra un avviso di duplicato; imposta OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1 perché OpenCode smetta di leggere le cartelle di Claude.

Scrivere una skill che tutti e tre possono caricare

Questo SKILL.md si carica allo stesso modo in Claude Code, Codex e OpenCode. Si trova in ~/.agents/skills/release-notes/SKILL.md, con accanto una cartella references e una scripts.

---
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
---

# Note di rilascio

1. Trova l'ultimo tag: git describe --tags --abbrev=0
2. Elenca i commit successivi: git log <tag>..HEAD --oneline --no-merges
3. Raggruppa i commit in Added, Changed e Fixed, seguendo references/format.md nella cartella di questa skill.
4. Per salvare un file, esegui scripts/write_notes.sh dalla cartella di questa skill.
  • Dai alla skill lo stesso nome della sua cartella. Usa lettere minuscole, numeri e trattini, fino a 64 caratteri. Codex si basa su name, OpenCode 2.2 sul nome della cartella e Claude Code accetta entrambi. Se i due sono diversi, richiami la stessa skill con nomi diversi in ogni strumento. Codex salta le skill con un nome più lungo di 64 caratteri.
  • Tieni la descrizione sotto i 1024 caratteri e metti per prime le parole che le persone useranno. È il limite dello standard, e Codex taglia a quella lunghezza le descrizioni più lunghe nel suo elenco di skill.
  • Metti tra virgolette ogni valore che contiene due punti seguiti da uno spazio. Altrimenti il frontmatter potrebbe non essere interpretato. Codex corregge la maggior parte di questi casi, Claude Code carica la skill come se non avesse frontmatter e OpenCode può saltare la skill senza alcun errore.
  • Fai in modo che gli script trovino la propria cartella. Gli strumenti eseguono i comandi dalla cartella del progetto, non da quella della skill. Uno script che inizia con cd "$(dirname "$0")" funziona da qualsiasi posizione.
  • Non mettere "claude" nel nome se pensi di caricare la skill su claude.ai o sulla Claude API. Entrambi rifiutano i nomi che contengono "claude" o "anthropic".

Cosa non si porta dietro da Claude Code

Codex legge solo name, description e una breve descrizione sotto metadata. OpenCode 2.2 legge anche metadata e disable-model-invocation. Entrambi ignorano tutti gli altri campi senza errori, quindi una skill di Claude Code si carica ma si comporta in modo diverso.

In una skill di Claude CodeClaude CodeCodexOpenCode 2.2
allowed-toolsFunzionaIgnoratoIgnorato
disable-model-invocation: trueFunzionaIgnorato; usa agents/openai.yamlFunziona
context: fork, agent, model, hooks, argument-hintFunzionanoIgnoratiIgnorati
$ARGUMENTS e $1 nel testoSostituiti con i tuoi argomentiRestano come testoRestano come testo
!`command` nel testoViene eseguito prima che Claude legga la skillResta come testoResta come testo
${CLAUDE_SKILL_DIR}Sostituito con la cartella della skillResta come testoResta come testo
  • Scrivi passaggi che funzionino senza queste funzioni. Scrivi «esegui scripts/check.sh dalla cartella di questa skill» invece di usare ${CLAUDE_SKILL_DIR}, e chiedi i dettagli mancanti a parole invece di usare $ARGUMENTS. Claude Code segue senza problemi le stesse istruzioni.
  • Per impedire a Codex di richiamare una skill da solo, aggiungi agents/openai.yaml alla cartella della skill con allow_implicit_invocation: false sotto policy. Puoi comunque richiamarla con $skill-name.
  • allowed-tools non limita ciò che Codex o OpenCode possono fare. La tabella di compatibilità di npx skills lo indica come supportato in entrambi, ma il loader delle skill di nessuno dei due legge quel campo. Imposta i limiti nelle impostazioni dei permessi di ciascuno strumento.

Strumenti che installano skill per più agenti

StrumentoCome condivide le skillA cosa fare attenzione
npx skills (Vercel, 38.500 stelle)Copia una skill in .agents/skills e vi collega la cartella di ogni agente. Su Windows usa le junction. --copy crea copie separate.Stessa struttura di questa guida. Esegui npx skills add owner/repo, con -g per la tua cartella utente.
skillshare (2900 stelle)Tiene una cartella sorgente e la collega nella cartella di ogni strumento; junction su Windows.Aggiornato il 6 novembre 2026. Si installa con Homebrew o con uno script shell.
Codex /importCopia le skill da .claude/skills a .agents/skills.Le copie si disallineano dagli originali. Inoltre cambia "claude" in "Codex" nel testo, anche dentro i percorsi dei file (issue aperta #40147).
openskills (10.800 stelle)Copia le skill in .claude/skills e le elenca in AGENTS.md.Nessuna release da gennaio 2026. La sua opzione --universal scrive in .agent/skills, che nessuno dei tre strumenti legge.

E CLAUDE.md e AGENTS.md?

Codex e OpenCode leggono AGENTS.md, e OpenCode ripiega su CLAUDE.md quando un progetto non ha AGENTS.md. Dalla versione 2.1.277 anche Claude Code legge AGENTS.md, ma solo nei progetti che non hanno CLAUDE.md né CLAUDE.local.md. Se tieni entrambi i file, apri /config in Claude Code e imposta Project instructions in modo che li carichi entrambi. Metti in AGENTS.md le regole che ogni agente deve seguire e riserva CLAUDE.md a ciò che serve solo a Claude Code.

Usare le stesse skill da Orkas

Orkas è un'app desktop che esegue Claude Code, Codex, OpenCode, OpenClaw e Hermes come agenti in un'unica chat. Usa le copie installate sul tuo computer e i tuoi account già collegati. Ecco come le tue skill arrivano a quegli agenti.

  • La cartella condivisa continua a funzionare. Ogni CLI continua a leggere le proprie cartelle di skill quando Orkas la avvia, quindi la configurazione descritta sopra funziona senza modifiche. Orkas aggiunge il proprio server MCP accanto ai tuoi, senza sostituirli.
  • Le skill che aggiungi in Orkas arrivano a ogni CLI. Ogni CLI avviata da Orkas riceve un server MCP chiamato orkas. Questo server elenca le tue skill di Orkas, ne carica una quando l'attività corrisponde ed esegue gli script inclusi nella skill. Chiedi a Claude Code di usare una skill per nome, oppure lascia che trovi quella giusta.
  • Orkas legge anche le tue skill di Claude Code e Codex. Le skill in ~/.claude/skills e ~/.codex/skills compaiono in Abilità ▸ Cartelle globali, e il Commander può usarle nelle proprie attività. Orkas si limita a leggere queste cartelle e non le modifica mai. Non legge direttamente ~/.agents/skills, quindi con la configurazione descritta sopra trova le tue skill tramite i link in ~/.claude/skills.

Per aggiungere un pacchetto di skill da GitHub, incolla il link del repository in una chat con il Commander e chiedigli di installare il pacchetto. Se il pacchetto deve installare delle dipendenze, Orkas te lo chiede prima. Le skill compaiono in Abilità ▸ Pacchetti esterni. Da quel momento Claude Code, Codex e OpenCode possono usarle tutti quando li esegui da Orkas, senza copiare nulla in tre cartelle. Per iniziare, scegli Connetti agenti nella barra laterale e seleziona le CLI che hai installato. Per una guida completa su come usarne due fianco a fianco, vedi Come usare Claude Code e Codex insieme.

Eseguili da Orkas Dai a Claude Code, Codex e OpenCode le stesse skill da un'unica app. Orkas è gratuito su macOS e Windows. Esegue le CLI che hai già, con i tuoi account.
Scarica Orkas — gratis

Quale configurazione scegliere?

La tua situazioneCosa fare
Usi due o tre di questi strumenti sullo stesso computerTieni le skill in ~/.agents/skills e collega ciascuna in ~/.claude/skills
Un team condivide le skill in un repositoryFai commit di .agents/skills; crea i link in .claude/skills con uno script di setup
Installi spesso skill da GitHubnpx skills add, che crea gli stessi link per te
Usi solo Claude Code e OpenCodeContinua a usare ~/.claude/skills; OpenCode la legge già
Esegui le CLI da OrkasInstalla i pacchetti di skill una sola volta in Orkas; ogni CLI che avvia può usarli

Domande frequenti

Posso usare le skill di Claude in Codex?

Sì. Codex legge lo stesso formato SKILL.md, ma cerca in ~/.agents/skills e .agents/skills, non in ~/.claude/skills. Sposta lì le cartelle delle skill e ricollegale per Claude Code, oppure esegui /import in Codex per copiarle. Campi come allowed-tools e funzioni come $ARGUMENTS funzionano solo in Claude Code.

OpenCode legge le skill di Claude Code?

Sì. OpenCode legge ~/.claude/skills e .claude/skills oltre a ~/.agents/skills e alle sue cartelle, quindi le skill di Claude Code compaiono senza alcuna configurazione. Per disattivarlo, imposta OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1.

Claude Code legge .agents/skills?

No. A novembre 2026, Claude Code legge le skill solo dalle cartelle .claude, e la sua documentazione dice che ignora tutto ciò che si trova in una directory .agents. La richiesta per aggiungerlo, la issue #31005, è ancora aperta. Nel frattempo, collega ogni skill da ~/.claude/skills.

Perché Codex non vede la mia skill collegata?

Codex segue una cartella di skill collegata, ma ignora un file SKILL.md che sia esso stesso un link. Collega invece l'intera cartella. Un link relativo viene risolto a partire dalla cartella in cui si trova il link, quindi controlla che il percorso sia corretto da lì.

Perché una skill compare due volte?

Di solito perché ci sono due copie in cartelle che lo strumento legge. Codex legge ancora la vecchia cartella ~/.codex/skills oltre a ~/.agents/skills, ed elenca entrambe le copie di una skill con lo stesso nome. Tieni una copia in ~/.agents/skills ed elimina l'altra.

Per confrontare i tre strumenti oltre alle skill, vedi Claude Code vs Codex vs OpenCode.