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
| Cartella | Claude Code | Codex | OpenCode |
|---|---|---|---|
~/.agents/skills | No | Sì | Sì |
.agents/skills in un progetto | No | Sì | Sì |
~/.claude/skills | Sì | No | Sì |
.claude/skills in un progetto | Sì | No | Sì |
~/.codex/skills | No | Sì, ma deprecata | No |
~/.config/opencode/skills, .opencode/skills | No | No | Sì |
| 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/skillsnel progetto,~/.agents/skillsper il tuo utente e/etc/codex/skillsper 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/skillse.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.
- Sposta le tue skill in
~/.agents/skills. Per ogni skill che hai scritto in~/.claude/skillso~/.codex/skills, sposta la sua cartella, per esempiomv ~/.claude/skills/release-notes ~/.agents/skills/. Lascia~/.claude/skills/synceddov'è: lì Claude Code tiene le skill del tuo account claude.ai. - 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- 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 }
}- 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/skillsstessa punta a~/.agents/skills, le cartellesyncede.trashdi 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/skillssia la cartella in~/.agents/skills. La versione 2.2 le unisce senza segnalarlo. La versione 1.19 registra un avviso di duplicato; impostaOPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1perché 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 Code | Claude Code | Codex | OpenCode 2.2 |
|---|---|---|---|
allowed-tools | Funziona | Ignorato | Ignorato |
disable-model-invocation: true | Funziona | Ignorato; usa agents/openai.yaml | Funziona |
context: fork, agent, model, hooks, argument-hint | Funzionano | Ignorati | Ignorati |
$ARGUMENTS e $1 nel testo | Sostituiti con i tuoi argomenti | Restano come testo | Restano come testo |
!`command` nel testo | Viene eseguito prima che Claude legga la skill | Resta come testo | Resta come testo |
${CLAUDE_SKILL_DIR} | Sostituito con la cartella della skill | Resta come testo | Resta 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.yamlalla cartella della skill conallow_implicit_invocation: falsesottopolicy. Puoi comunque richiamarla con$skill-name. allowed-toolsnon limita ciò che Codex o OpenCode possono fare. La tabella di compatibilità dinpx skillslo 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
| Strumento | Come condivide le skill | A 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 /import | Copia 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/skillse~/.codex/skillscompaiono 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.
Quale configurazione scegliere?
| La tua situazione | Cosa fare |
|---|---|
| Usi due o tre di questi strumenti sullo stesso computer | Tieni le skill in ~/.agents/skills e collega ciascuna in ~/.claude/skills |
| Un team condivide le skill in un repository | Fai commit di .agents/skills; crea i link in .claude/skills con uno script di setup |
| Installi spesso skill da GitHub | npx skills add, che crea gli stessi link per te |
| Usi solo Claude Code e OpenCode | Continua a usare ~/.claude/skills; OpenCode la legge già |
| Esegui le CLI da Orkas | Installa 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.