Claude Code Base Lezione 32 di 46
Creare la tua prima skill
- Una skill è una cartella con dentro un file: il file si chiama SKILL.md.
- Il nome della cartella diventa il comando che scrivi per richiamarla.
- Nel progetto se riguarda quel lavoro, fra le tue cose se vuoi averla ovunque.
- Il modo più veloce di scriverla: farla scrivere a lui.
La forma: una cartella, un file
Una skill è una cartella con dentro un file di testo chiamato SKILL.md. Il nome che dai alla cartella diventa la parola con cui la richiami: se la cartella si chiama riepilogo, la lanci scrivendo /riepilogo.
Da cui il primo consiglio pratico: chiamala come la chiameresti a voce. Una parola, corta, quella che ti verrebbe naturale — perché quella parola te la dovrai ricordare fra tre mesi.
Cosa c'è dentro il file
Due parti. In cima, un'intestazione di due righe: il nome e la descrizione. Sotto, le istruzioni vere e proprie, scritte in italiano come le spiegheresti a una persona.
La descrizione sembra un dettaglio burocratico. Non lo è: è la riga più importante del file, e ha la lezione tutta sua, la prossima. Per ora tieni solo presente che serve a dire quando quella procedura va usata.
Sotto, il corpo: i passaggi nell'ordine, cosa controllare, com'è fatto il risultato giusto. Vale tutto quello che hai imparato sulle istruzioni: concreto e verificabile batte generico e ambizioso.
Dove metterla
Stessa logica del file delle istruzioni, e ormai la conosci:
Nel progetto — dentro la cartella di lavoro. Vale lì, e se condividi la cartella con altri vale anche per loro.
Fra le tue cose — nella cartella personale di Claude. Vale in tutti i progetti che apri.
Regola pratica: se la procedura riguarda quel lavoro, sta nel progetto. Se riguarda il tuo modo di lavorare, sta fra le tue cose.
Il modo furbo: fartela scrivere
Non c'è nessun premio per averla scritta a mano. Il modo più veloce è descrivere la procedura a Claude e chiedergli di trasformarla in una skill: lui crea la cartella, il file, l'intestazione, e mette in ordine i passaggi.
È il riflesso da prendere in generale, e vale ben oltre le skill: prima di fare a mano una cosa noiosa, chiediti se può farla lui. Tu porti il contenuto — i passaggi veri, che sa solo chi quel lavoro lo fa — e lui mette la forma.
Poi però rileggila. È una procedura che userai cento volte: vale i due minuti di controllo.
Provarla subito
Le skill nuove vengono viste subito, senza dover chiudere e riaprire: la scrivi e la puoi già richiamare. L'unico caso in cui serve riavviare è se la cartella delle skill non esisteva proprio quando hai aperto la sessione.
Quindi il collaudo è immediato: scrivi la skill, la lanci, guardi cosa fa. E se non fa esattamente quello che volevi, apri il file e correggi la riga sbagliata — che è il bello di una procedura scritta in italiano invece che programmata.
E adesso
Adesso ne sai fare una. Resta da capire perché a volte Claude la usa da solo al momento giusto e a volte non se la fila nemmeno, pur avendola lì. La risposta sta in una riga, ed è la prossima lezione.
Hai capito?
Due minuti, nessun voto. Provare a rispondere — anche sbagliando — fissa i concetti molto più che rileggere. Se non ti va, salta pure: la lezione si completa lo stesso.
Da cosa dipende la parola con cui richiami la skill?
Il nome della cartella diventa il comando. Da cui un consiglio pratico: chiamala come la chiameresti a voce — corta e in una parola — perché quella parola te la dovrai ricordare.
Vuoi che una skill valga in tutti i tuoi progetti, non solo in questo. Dove la metti?
Stessa logica del CLAUDE.md: nel progetto se riguarda quel lavoro (e vuoi condividerla con chi ci lavora), fra le tue cose se riguarda il tuo modo di lavorare in generale.
Qual è il modo più veloce di scrivere una skill?
È il riflesso da prendere in generale: prima di fare a mano una cosa noiosa, chiedi se può farla lui. Tu porti il contenuto — i passaggi veri, che sa solo chi fa quel lavoro — lui mette la forma.
-
Capitolo 1 Introduzione
-
Capitolo 2 Cosa c’è sotto
-
Capitolo 3 Il motore lo scegli tu
-
Capitolo 4 Prima volta ai comandi
-
Capitolo 5 Cosa gli lasci toccare
-
Capitolo 6 Cosa sa di te
-
Capitolo 7 Le skills
-
Capitolo 8 Quanti ne metti al lavoro
-
Capitolo 9 A cosa è collegato fuori
-
Capitolo 10 Automatizzare l'attrezzatura
-
Capitolo 11 Chiusura