Le skill sono il modo più semplice per insegnare a un agente qualcosa che di base non fa bene: uno standard di design, una checklist di revisione, un modo per risparmiare token. Questa guida spiega dove vivono le skill per Claude Code e Codex, come installarle a mano e come gestirle senza riga di comando.
Cos'è una skill?
Una skill è una cartella con un file SKILL.md: istruzioni in Markdown con un nome breve e una descrizione in cima, più gli script o i file di riferimento che servono. L'agente legge le descrizioni delle skill installate e carica le istruzioni complete di una skill solo quando un compito lo richiede, quindi le skill installate costano pochissimo contesto finché non vengono usate.
my-skill/
├── SKILL.md
└── scripts/
└── check.sh
Dove Claude Code e Codex cercano le skill
| Agente | Skill personali (tutti i progetti) | Skill di progetto |
|---|---|---|
| Claude Code | ~/.claude/skills/<name>/ |
.claude/skills/<name>/ nel repository |
| Codex | ~/.codex/skills/<name>/ o ~/.agents/skills/<name>/ |
secondo la documentazione di Codex |
Se imposti CLAUDE_CONFIG_DIR o CODEX_HOME, le cartelle personali si spostano di conseguenza.
Installare una skill a mano
- Trova il repository della skill e la cartella che contiene il suo
SKILL.md. - Copia quella cartella nella tua directory delle skill:
git clone https://github.com/owner/repo /tmp/repo
cp -R /tmp/repo/skills/my-skill ~/.claude/skills/- Avvia una nuova sessione dell'agente perché carichi la skill.
Aggiornare significa ripetere la copia, e non c'è modo di annullare se la nuova versione dà problemi, quindi tieni un backup della vecchia cartella.
Installa solo skill di cui ti fidi. Una skill può contenere script che l'agente può eseguire con i tuoi permessi. Leggi prima SKILL.md e gli eventuali script.
Gestire i tuoi repository di skill con Vibe Console
Nel pannello Skill di Vibe Console, aggiungi un repository GitHub di cui ti fidi come owner/repo o https://github.com/owner/repo. Scegli una sezione per la sua scheda, poi scegli quali skill installare per Claude Code o Codex. L'elenco è salvato sul tuo Mac; Vibe Console non fornisce i file delle skill. Puoi rimuovere qualsiasi scheda dall'elenco senza disinstallare quello che hai già installato.
Aggiornamenti sicuri con rollback
Vibe Console controlla se ci sono aggiornamenti per le skill installate e le segna con Aggiornamento disponibile, oppure con L'origine è diversa — rivedi le modifiche quando i file su disco non corrispondono più alla sorgente. L'aggiornamento conserva un backup dei file precedenti. Se la nuova versione crea problemi, premi Ripristina, oppure Apri backup per esaminare i vecchi file.
Domande frequenti
Le skill funzionano sia in Claude Code sia in Codex?
Il formato SKILL.md funziona in entrambi, ma ogni agente carica le skill dalla sua cartella. Installa la skill per ogni agente che usi.
Le skill installate rallentano l'agente?
Quasi per niente. Gli agenti leggono solo la breve descrizione di ogni skill finché un compito non ne ha bisogno.
Come rimuovo una skill?
Elimina la sua cartella dalla directory delle skill, poi avvia una nuova sessione.
Prova gratis per 14 giorni il pannello Skill: scarica Vibe Console.