Guida

Come iniziare

Due vie per installare le competenze (skill). La prima senza terminale, la seconda con un comando.

Prerequisito Un agent AI gia' installato — Claude (Desktop o Code), Codex CLI, o equivalente. Questa pagina parte dall'assunto che ne hai uno e vuoi aggiungere una competenza (skill).

1. Cosa sono le competenze (skill)

Una competenza (skill) e' una cartella con un file markdown (SKILL.md) che dice all'agent come si fa una cosa specifica — redigere un POS, calcolare uno spettro di risposta NTC, predisporre una pratica catastale — rispettando le norme italiane e citando le fonti ufficiali.

Senza una competenza, l'agent applica conoscenza generica e spesso sbaglia sui dettagli normativi (italiani in particolare: training set saturi di common law statunitense). Con una competenza, segue la procedura corretta.

Le competenze (skill) di questo progetto sono 182, in 9 aree. Open source, MIT. Le scarichi, le usi, le modifichi.

2. Installazione via Claude Desktop

La via piu' semplice. Niente terminale, niente Node, niente comandi: scarichi un file e lo carichi nelle impostazioni.

Prerequisito Deve essere attiva l'esecuzione codice (code execution) in Settings > Capabilities: senza, la sezione Competenze (Skills) non compare. Disponibile su tutti i piani, incluso il Free.

Passo 1
Scarica lo .zip della competenza (skill)
Vai al catalogo: ogni card ha un link .zip ↓. Click. Ottieni un file <id-skill>.zip — una cartella con dentro il file SKILL.md.
Passo 2
Carica lo .zip nella sezione Competenze (Skills)
In Claude apri Customize > Skills, premi +, poi + Create skill e seleziona il file .zip. La competenza compare nella lista e la attivi con il toggle. Trascinare lo .zip dentro la conversazione non la installa: lo allega e basta.
Passo 3
Chiedi all'agent di usarla
Descrivi cosa ti serve, in italiano. Vedi sezione 4.

3. Installazione via CLI

Se usi un agent da terminale (Claude Code, Codex, ...) il modo migliore e' il pacchetto skills di Vercel Labs. Rileva l'agent e installa nel path giusto, cross-platform (Windows, macOS, Linux). Richiede Node.js installato.

Installare una competenza (skill)

Sostituisci dvr-generico con l'id che vuoi (lo trovi nelle card del catalogo). Il flag -g rende la competenza disponibile in tutti i progetti.

npx skills add morellid/skill-per-ingegneri --skill dvr-generico -g

Installare tutte le 182 competenze (skill)

Senza --skill, il CLI chiede interattivamente quali installare; oppure passi --all. Le competenze non vengono caricate tutte: l'agent legge solo quella che usa.

npx skills add morellid/skill-per-ingegneri -g

Installare nel singolo progetto invece che globalmente

Senza -g, la competenza viene installata nella cartella corrente (in ./<agent>/skills/). Utile se vuoi committare la competenza con il repo del progetto, condividendola con il team.

npx skills add morellid/skill-per-ingegneri --skill dvr-generico

Altri comandi: list, find, update, remove

Elenca le competenze (skill) installate:

npx skills list

Cerca per parola chiave (es. "ntc"):

npx skills find ntc

Aggiorna alle versioni piu' recenti:

npx skills update

Disinstalla una competenza:

npx skills remove dvr-generico

4. Chiedere all'agent di usare una competenza (skill)

Apri l'agent (la conversazione di Claude Desktop, o il terminale nella cartella del tuo progetto) e descrivi cosa ti serve, in italiano. Niente sintassi speciale.

Usa la skill dvr-generico per redigere il DVR di un cantiere edile in Via Roma 12, Livorno.

In alternativa, basta descrivere il problema. Se la competenza esiste, l'agent la trova: "Aiutami a redigere un DVR per il mio cantiere edile" e' sufficiente.

5. Cosa fare se qualcosa non va

L'agent non trova la competenza (skill).

Verifica con npx skills list che la competenza sia installata. Se non c'e', ripeti il comando di installazione e leggi l'output: di solito segnala chi e dove ha installato.

Risposta dell'agent generica, senza riferimenti normativi.

Probabilmente non sta usando la competenza. Chiedi esplicitamente: "usa la skill <id>". L'agent dovrebbe rispondere citando articoli e paragrafi.

Output non corretto secondo la tua esperienza.

Controlla la sezione Limiti nella scheda della competenza: il caso potrebbe essere fuori scope dichiarato. Se l'errore e' nella competenza stessa, apri una issue sul repo.

Vuoi un aggiornamento della competenza (skill).

npx skills update tira giu' le versioni piu' recenti. In alternativa, se hai installato via Claude Desktop, ri-scarica lo .zip dal catalogo e ricaricalo in Customize > Skills.

Pronto? Apri il catalogo e scegli.

182 competenze (skill) in 9 aree, ordinate per disciplina.

Vedi il catalogo →

← Torna alla home