Claude Code è l’unica interfaccia di Claude che installa davvero gli Skills dal disco, il che significa che i consigli al riguardo sono diversi da tutto ciò che è stato scritto sulle Istruzioni personalizzate. Questa è una guida pratica: come funziona la cartella, cosa rende uno Skill degno di essere conservato e dove le persone sprecano il proprio tempo.
Come funzionano gli Skills in Claude Code
Gli Skills si trovano in una directory .claude/skills/. Ogni Skill è una sottocartella che contiene un file SKILL.md. Ci sono due percorsi importanti:
-
Progetto -
.claude/skills/all’interno del repository. Lo Skill viaggia insieme al codice, quindi tutto il team lo riceve. È qui che vanno inseriti gli elementi specifici del progetto. - Personale - lo stesso percorso nella directory home. Si applica a tutto ciò su cui lavori. È qui che vanno inserite le tue abitudini personali.
A differenza delle Istruzioni personalizzate, che contengono una sola cosa alla volta, Claude Code può contenere molti Skills e caricare quello che corrisponde all’attività che stai svolgendo. Questo cambia l’aspetto di un buon Skill: deve avere una descrizione abbastanza precisa da far scegliere quello giusto, ma sufficientemente circoscritta da evitare che venga selezionato per qualsiasi cosa.
Cosa rende uno Skill davvero degno di essere conservato
Dopo averne creati molti, il modello ricorrente è sempre lo stesso. I buoni Skills codificano decisioni, non informazioni.
Uno Skill che elenca cos’è un’API REST spreca token su qualcosa che il modello già conosce. Uno Skill che dice «in questo repository, ogni endpoint restituisce gli errori nel formato RFC 7807 e i tre casi che non lo fanno sono legacy e non devono essere copiati» merita di essere conservato per sempre, perché si tratta di una decisione che il modello non può dedurre.
La verifica è questa: se un ingegnere competente che entra nel tuo team avrebbe bisogno che glielo dicessi, inseriscilo in uno Skill. Se lo saprebbe già, lascialo fuori.
Le categorie che vale la pena avere
Revisione del codice con uno standard interno
I commenti di revisione generici sono rumore. Uno Skill per la revisione che includa le convenzioni effettive del tuo team, le questioni su cui avete discusso e raggiunto un accordo, trasforma la revisione da opinione a lista di controllo.
Convenzioni per i test
Quale framework usare, come nominare un test, cosa simulare e cosa non simulare mai, e cosa viene considerato una copertura sufficiente per questa codebase. In assenza di queste indicazioni, otterrai test scritti nello stile più comune nei dati di addestramento.
Debugging e gestione degli incidenti
Dove si trovano i log, quale dashboard risponde a quale domanda, le quattro cose da controllare prima di fare un’escalation. Questo è lo Skill che si ripaga da solo alle 3 del mattino.
Infrastruttura e deployment
La sequenza di deployment, cosa è sicuro eseguire in produzione e cosa no, quali migrazioni richiedono una finestra di manutenzione. Codificare le parti pericolose è proprio lo scopo.
Documentazione e scrittura tecnica
Dove si trova la documentazione, quale struttura segue una pagina, la differenza nello stile interno tra un tutorial e una guida di riferimento.
Cosa evitare
Tutorial sui linguaggi. Uno Skill che spiega la sintassi di Python a Claude è uno Skill che spiega la sintassi di Python a qualcosa che conosce già la sintassi di Python.
Skills enormi che includono tutto. Uno Skill che copre frontend, backend, test e deployment viene caricato continuamente ed è quasi sempre irrilevante. Dividilo.
Qualsiasi cosa che sarà obsoleta tra un mese. Numeri di versione, obiettivi dello sprint attuale, il nome della persona di turno. Gli Skills servono per le decisioni durature.
Descrizioni vaghe. Se la descrizione non indica chiaramente quando si applica lo Skill, questo non verrà mai selezionato oppure verrà selezionato sempre. Entrambe le situazioni sono inutili.
Partire da un modello invece che da una pagina vuota
La parte più difficile non è l’idea, ma la struttura: quanto essere specifici, cosa tralasciare, come scrivere la descrizione affinché la selezione funzioni. È questa la parte che vale la pena copiare da qualcosa di già testato.
Pubblichiamo file di Skills basati sul ruolo per sviluppatori, professionisti DevOps e architetti, scritti in semplice formato .md e utilizzabili sia come Skill di Claude Code sia incollandoli nelle Istruzioni personalizzate:
Skills di Claude Code →
Skills per sviluppatori →
Skills DevOps →
Skills per architetti →
Se non usi Claude Code e sei arrivato qui comunque, l’equivalente per Claude sul web sono le Istruzioni personalizzate.
KissMySkills è un marketplace indipendente e non è affiliato, approvato o collegato ad Anthropic, OpenAI o a qualsiasi altra azienda di AI. Claude Code è un prodotto di Anthropic.
