---
title: "skills.sh: installare skill su più agenti AI per il coding"
seoTitle: "Guida a skills.sh: installare skill su più agenti di coding"
navTitle: "Guida a skills.sh"
description: "Usa la CLI di skills.sh per installare e mantenere le skill degli agenti per Codex, Claude Code e altri agenti di coding, senza duplicare le istruzioni."
slug: skills-sh-install-skills-ai-coding-agents
lang: it
date: 2026-08-05
updated: 2026-08-05
author: "Chatcode"
category: guide
faq:
  - q: "skills.sh può installare la stessa skill sia per Codex sia per Claude Code?"
    a: "Sì. Passa i nomi di entrambi gli agenti alla CLI skills, per esempio `--agent codex --agent claude-code`. La CLI installa una copia canonica e può collegarla nella directory delle skill prevista da ciascun agente."
  - q: "Come installo una skill per tutti gli agenti supportati?"
    a: "Usa `--agent '*'` insieme a una `--skill` specifica. L'opzione più ampia `--all` installa tutte le skill trovate per tutti gli agenti senza chiedere conferma, quindi esamina la sorgente prima di usarla."
  - q: "Le skill di skills.sh sono sicure da installare?"
    a: "Non automaticamente. skills.sh esegue controlli di sicurezza, ma dichiara esplicitamente di non garantire la qualità o la sicurezza di ogni skill. Prima dell'installazione leggi SKILL.md, gli script, i riferimenti, le dipendenze e gli accessi richiesti."
---

Se usi più di un agente di coding, copiare le stesse istruzioni in directory
separate per Claude Code, Codex, Cursor e OpenCode diventa presto caotico.
Ogni copia può divergere, e diventa difficile capire quale versione stia
seguendo un agente.

[skills.sh](https://skills.sh/) offre un catalogo per scoprire le skill degli
agenti. La sua [CLI `skills`](https://github.com/vercel-labs/skills), open
source, si occupa della parte pratica: selezionare le skill da un repository,
installarle per uno o più agenti e, in seguito, aggiornarle o rimuoverle.

## Risposta rapida

Comincia elencando le skill di un repository senza installare nulla:

```bash
npx skills add vercel-labs/agent-skills --list
```

Poi installa una skill per gli agenti che devono usarla:

```bash
npx skills add vercel-labs/agent-skills \
  --skill web-design-guidelines \
  --agent claude-code \
  --agent codex
```

Per rendere quella specifica skill disponibile a tutti gli agenti supportati
dalla CLI, usa un carattere jolly tra virgolette, così la shell non lo espande:

```bash
npx skills add vercel-labs/agent-skills \
  --skill web-design-guidelines \
  --agent '*'
```

Esiste anche un comando molto più ampio:

```bash
npx skills add vercel-labs/agent-skills --all
```

`--all` significa tutte le skill trovate e tutti gli agenti, senza richieste di
conferma. È comodo per un repository tuo che hai già esaminato. Di solito è
troppo ampio per provare una raccolta pubblica che non conosci.

## Cosa viene installato

Una skill per agenti è una directory che contiene almeno un file `SKILL.md`.
Quel file ha un nome, una descrizione che aiuta l'agente a decidere quando
attivarla e le istruzioni da seguire. Una skill può contenere anche script
eseguibili, materiale di riferimento e risorse. La struttura completa è
documentata nella
[specifica Agent Skills](https://agentskills.io/specification).

La CLI `skills` conosce le directory di progetto e globali usate da decine di
agenti di coding. Per esempio, punta a `.agents/skills/` per un'installazione
di Codex a livello di progetto e a `.claude/skills/` per Claude Code. Può creare
link simbolici da quelle directory degli agenti verso un'unica copia canonica
della skill. Così le istruzioni restano coerenti e un solo aggiornamento serve
più agenti.

Usa `--copy` quando i link simbolici non sono adatti al filesystem o
all'ambiente di deployment. Le copie sono indipendenti, quindi tenere tutti gli
agenti sulla stessa versione diventa una tua responsabilità.

## Scegli con cognizione tra ambito di progetto e globale

L'installazione predefinita è locale al progetto. Esegui il comando dalla
radice del progetto quando una skill codifica convenzioni del repository,
versioni del framework o un flusso di lavoro che il team deve poter esaminare.

Aggiungi `--global` (o `-g`) solo per un flusso di lavoro personale che deve
valere in tutti i progetti:

```bash
npx skills add vercel-labs/agent-skills \
  --skill web-design-guidelines \
  --agent codex \
  --global
```

Le skill locali al progetto sono più facili da rivedere insieme al codice su cui
agiscono. Le skill globali riducono le ripetizioni, ma possono anche far sì che
due sviluppatori ottengano comportamenti diversi dall'agente sullo stesso
repository. Documenta ogni skill globale da cui dipende un flusso di lavoro
condiviso.

## Considera il catalogo uno strumento di scoperta, non una prova di qualità

La classifica di skills.sh si basa sulla telemetria anonima delle installazioni
raccolta dalla CLI. Un numero di installazioni può indicare interesse, ma non
dimostra che una skill migliori i risultati, sia aggiornata o si adatti al tuo
progetto.

Prima di installare una skill pubblica:

1. Apri il suo repository sorgente e leggi `SKILL.md` per intero.
2. Esamina i file a cui fa riferimento e ogni script che la skill potrebbe
   eseguire.
3. Controlla licenza, manutenzione recente, dipendenze, accesso alla rete e
   note di compatibilità.
4. Cerca istruzioni in conflitto con le versioni del tuo progetto o con le
   regole esistenti in `AGENTS.md`.
5. Provala su un solo progetto e su un'attività ripetibile prima di renderla
   globale o di installarla per tutti gli agenti.

skills.sh dice di eseguire controlli di sicurezza periodici, ma
[dichiara anche di non poter garantire ogni skill elencata](https://skills.sh/docs#how-are-you-securing-skills).
È il presupposto corretto da adottare. Una skill è fatta di istruzioni, e a volte di
codice, provenienti da un altro repository: non è una sandbox né una decisione
di fiducia.

La telemetria anonima della CLI si può disattivare per un singolo comando con
la variabile d'ambiente documentata:

```bash
DISABLE_TELEMETRY=1 npx skills add vercel-labs/agent-skills --list
```

## Più skill non rendono necessariamente migliore un agente

Installare una skill non aumenta le capacità di base del modello. Gli fornisce
istruzioni e risorse aggiuntive. Istruzioni utili possono rendere più
affidabile un flusso di lavoro specializzato; istruzioni irrilevanti o
superate possono consumare contesto, imbrigliare un buon approccio o entrare in
conflitto con il repository.

Le prime evidenze sono contrastanti. Un recente
[benchmark sulle skill di ingegneria del software](https://arxiv.org/abs/2603.15401)
ha riportato un miglioramento medio di appena l'1,2% su 49 skill pubbliche.
Trentanove non hanno mostrato alcun miglioramento del tasso di superamento,
mentre tre lo hanno ridotto. Uno
[studio più ampio, SkillsBench](https://arxiv.org/abs/2602.12670), ha rilevato
un guadagno medio sostanziale in diversi ambiti, ma anche risultati negativi su
alcune attività e prestazioni migliori con skill mirate che con documentazione
esaustiva.

Entrambi sono preprint recenti, non un verdetto definitivo. La lezione pratica
resta comunque utile: valuta una skill sulla stessa attività svolta senza di
essa. Tienila quando il risultato è più corretto, ripetibile o manutenibile, non
solo perché l'agente ha prodotto una risposta più lunga.

## Usa il meccanismo più piccolo che risolve il problema

| Esigenza | Punto di partenza migliore |
| --- | --- |
| Procedura ripetibile e specifica di uno strumento, con file di supporto | Una skill di progetto mirata |
| Flusso di lavoro personale usato in molti repository | Un'unica skill globale già esaminata |
| Regole che ogni contributore e agente deve sempre seguire | Istruzioni di progetto versionate, come `AGENTS.md` |
| Un'attività insolita e isolata | Un prompt diretto con il contesto necessario |
| Una policy o un controllo deterministico | Uno script, un test, un formatter o una regola di CI |
| Indicazioni vecchie, generiche o contraddittorie | Nessuna skill finché le indicazioni non vengono corrette |

Questa distinzione impedisce che una libreria di skill diventi un secondo
sistema di configurazione, meno visibile. Le skill sono più utili per le
conoscenze procedurali che un agente dovrebbe caricare solo quando si presenta
un'attività corrispondente. I comandi e i confini duraturi, validi per tutto il
repository, vanno in un file di istruzioni mirato; vedi
[cosa mettere in AGENTS.md e CLAUDE.md](/articles/agents-md-claude-md-best-practices)
per le evidenze e un modello compatto.

## Mantieni gestibili le skill installate

La CLI fornisce i normali comandi per il ciclo di vita:

```bash
# Show project and global skills
npx skills list

# Update one installed skill
npx skills update web-design-guidelines

# Remove it
npx skills remove web-design-guidelines
```

Esamina le modifiche a monte prima di aggiornare una skill usata in produzione
o in tutto un team. Se la riproducibilità conta, registra la sorgente e la
revisione esaminata nella documentazione del progetto, come faresti per
qualsiasi altro strumento di sviluppo.

L'impostazione predefinita sensata è ristretta: installa una sola skill già
esaminata, in un solo progetto, per gli agenti che ne hanno bisogno. Passa a
`--agent '*'`, all'ambito globale o a `--all` solo dopo che il flusso di lavoro
si è guadagnato quella portata.
