Sono Skills, tool e Knowledge Bases a rendere davvero produttivo Claude Desktop. Usati bene fanno risparmiare tempo; usati male nasce la prossima valanga di plugin. Qui metto ordine nei termini e mostro come mantenere pulita una libreria di Skills in un team.
Skills, extension, tool: cosa è cosa?
Skill: istruzioni per un compito ricorrente. Una Skill raccoglie descrizione, prompt ed esempi per un compito ben delimitato. Claude la sceglie non appena il compito corrisponde alla descrizione.
Tool: funzione concreta che Claude può richiamare. I tool arrivano nell’applicazione per lo più tramite server MCP. Un tool invia un’email, legge un file o crea un appuntamento: un comando atomico con input e output.
Extension: pacchetto di Skills, tool e configurazione. Una extension racchiude un insieme coerente, per esempio per la ricerca o le code review. Si installa una volta e offre un’esperienza uniforme.
Knowledge Base: archivio di conoscenza strutturato. Una Knowledge Base fornisce a Claude un contesto di lunga durata: documentazione di prodotto, regole di marca o risposte frequenti. Integra le Skills, non le sostituisce.
Come scrivo Skills che reggono nell’uso quotidiano
Descrizione chiara del compito. Nel front matter è indicato quando la Skill entra in gioco. Se la descrizione è vaga, Claude la sceglie o troppo di rado o troppo spesso.
Due o tre esempi. Esempi concreti prima-dopo battono le regole astratte. Nell’uso quotidiano una Skill senza esempi resta un modello inutilizzato.
Formato del risultato atteso. Markdown, tabella, JSON o testo libero: chi definisce il risultato ottiene output affidabili.
Confini netti. Una Skill dovrebbe descrivere anche ciò che non fa. Così si evitano allucinazioni ai bordi del compito.
Come evitare il cimitero dei plugin
Introduco cinque regole non appena sono coinvolte più di tre persone.
- Versionare le Skills. Un repository comune invece di copie sparse su ogni computer. Le modifiche sono tracciabili e il rollback è possibile.
- Mantenere una convenzione di denominazione. Per esempio nel formato ruolo.scopo.verbo. Così tutti trovano le Skills e Claude le seleziona in modo più affidabile.
- Una procedura di revisione dedicata. Prima del rilascio ogni nuova Skill passa per una breve revisione: si controllano contenuto, esempi e permessi.
- Fare pulizia ogni trimestre. Le Skills che nessuno usa vengono eliminate. Una breve statistica d’uso dal file di log basta come base dati.
- Documentare le autorizzazioni di sicurezza. Quali dati la Skill può toccare e quali no. Questo elenco sostituisce dieci discussioni in sede di audit.
Quando una Knowledge Base conviene davvero
Domande ricorrenti. Se la stessa spiegazione compare in cinque conversazioni a settimana, una Knowledge Base fa risparmiare più tempo di quanto ne costi costruirla.
Fonte stabile. Documentazione di prodotto, regole di marca o contratti sono ideali. I contenuti che invecchiano in fretta stanno meglio in una fonte live via MCP.
Responsabilità chiara. Una persona tiene aggiornata la Knowledge Base. Senza un responsabile, qualsiasi archivio di conoscenza invecchia in meno di sei mesi.
Questo articolo fa parte della serie Configurare Claude Desktop (in tedesco).