Guida

Come iniziare

Due vie per installare le skill. La prima e' drag-and-drop, la seconda 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 skill.

1. Cosa sono le skill

Una skill e' un file markdown 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 skill, l'agent applica conoscenza generica e spesso sbaglia sui dettagli normativi (italiani in particolare: training set saturi di common law statunitense). Con una skill, segue la procedura corretta.

Le skill di questo progetto sono 33, in 8 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. Drag-and-drop.

Passo 1
Scarica lo .zip della skill
Vai al catalogo: ogni card ha un link .zip ↓. Click. Ottieni un file <id-skill>.zip.
Passo 2
Trascina lo .zip nella finestra di Claude Desktop
Apri Claude Desktop, trascina il file nella conversazione. L'app riconosce il formato e importa la skill.
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 skill

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

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

Installare tutte le 33 skill

Senza --skill, il CLI chiede interattivamente quali installare; oppure passi --all. Le skill 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 skill viene installata nella cartella corrente (in ./<agent>/skills/). Utile se vuoi committare la skill 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 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 skill:

npx skills remove dvr-generico

4. Chiedere all'agent di usare una 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 skill 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 skill.

Verifica con npx skills list che la skill 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 skill. 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 skill: il caso potrebbe essere fuori scope dichiarato. Se l'errore e' nella skill stessa, apri una issue sul repo.

Vuoi un aggiornamento della skill.

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

Pronto? Apri il catalogo e scegli.

33 skill in 8 aree, ordinate per disciplina.

Vedi il catalogo →

← Torna alla home