La terza chat ricomincia con la stessa spiegazione: quali dettagli vanno nel briefing, quali termini usa il team e cosa deve succedere quando manca qualcosa? La ripetizione è un buon segnale che puoi mettere per iscritto un modo di lavorare. Una skill lo trasforma in un'istruzione riutilizzabile che applichi consapevolmente e continui a curare.
Per Claude Code, la documentazione ufficiale sulle skill descrive uno SKILL.md con metadati e istruzioni. Può essere usato quando un compito è pertinente o quando viene richiamato esplicitamente. Questo cambia l'istruzione per il lavoro, non i pesi addestrati del modello. I file che seguono sono una nostra bozza illustrativa, non il resoconto di un'esecuzione effettivamente svolta.
Prima la decisione, poi il file
Il nostro esempio è una serata mensile di riparazioni. A partire dalle note organizzative deve essere prodotto un briefing interno. In esso, gli aiutanti hanno bisogno degli accordi confermati, dei compiti e delle decisioni aperte. È un incarico più ridotto rispetto alla pianificazione dell'intero evento.
Scrivi prima un contratto di input. Ogni dettaglio ha bisogno di un valore e di uno stato. “Inizio 18:00, confermato” è diverso da “Inizio 18:00, proposta”. L'IA deve mantenere questa differenza. Se manca il luogo, si tratta di una domanda aperta; un indirizzo sostitutivo dall'aria plausibile tradirebbe l'incarico.
Mantieni lo SKILL.md breve e univoco
Una possibile posizione a livello di progetto è .claude/skills/reparaturbrief/. Potrebbe contenere la seguente istruzione di lavoro tutta tua. I metadati spiegano quando serve; il testo sottostante descrive cosa deve produrre.
---
name: reparaturbrief
description: Creates internal briefings for repair evenings from organisational notes.
---
Record confirmed details and suggestions separately.
Do not invent venues, dates, names or commitments.
If there are contradictions: state both details and phrase a follow-up question.
Output:
1. Confirmed arrangements
2. Tasks with confirmed responsibility
3. Open decisions with a reference to the input
4. Next coordination stepUna descrizione come “aiuta in tutto ciò che riguarda l'organizzazione” direbbe meno. Rende difficile capire dove la skill è adatta e quando è più appropriato un altro modo di lavorare. Un confine chiaro rende anche più semplice la manutenzione successiva.
Un passaggio di consegne di esempio con una vera lacuna
Usa note fittizie: la sala è confermata, l'orario di inizio è ancora solo una proposta e i materiali verranno ordinati solo dopo l'approvazione del budget. Indica queste condizioni in modo diretto. Un output atteso può contenere un compito “Chiarire il budget”. “Materiali ordinati”, invece, sarebbe un'affermazione nuova e non supportata.
Un'istruzione aggiuntiva utile recita: “Per ogni decisione aperta, indica quale parte dell'input la genera.” In questo modo si crea un collegamento tra la lacuna e la sua fonte. La skill non deve ripetere l'intero testo originale; deve rendere facile trovare il dettaglio controverso.
Tieni una preferenza stilistica separata dalle regole sostanziali. Un esempio di brevi descrizioni dei compiti può servire come file di supporto. I dettagli dell'evento che cambiano spesso, invece, vanno nel singolo incarico. Così l'istruzione generale non diventa obsoleta alla data successiva.
Tre casi rivelano debolezze diverse
Nel primo caso fornisci dettagli completi e coerenti. Nel secondo manca la data e due note sul budget si contraddicono. Nel terzo chiedi qualcosa al di fuori dell'ambito della skill, come la pianificazione di un viaggio. Così puoi esaminare separatamente la struttura, la gestione dell'incertezza e i limiti d'uso.
Per ogni caso, annota cosa deve essere assolutamente mantenuto. Valuta una risposta prima in base a questo e solo dopo in base allo stile. Una formulazione elegante non compensa una data inventata. Allo stesso modo, una domanda di chiarimento non è un errore se nell'input manca proprio quella decisione.
Curare una piccola istruzione di lavoro
Quando un problema si ripresenta, modifica una regola specifica e ripeti i casi esistenti. Aggiungi un nuovo caso che non era ancora noto quando la modifica è stata scritta. Così è più facile vedere se la regola si limita a riprodurre un singolo esempio.
Registra il motivo della modifica e il suo stato. All'inizio non serve alcuna grande infrastruttura. Una breve nota come “Le condizioni del budget devono essere mantenute nell'elenco dei compiti” è più facile da seguire di una riscrittura completa senza motivazione. Una skill vale lo sforzo quando le sue regole rendono più comprensibile il prossimo passaggio di consegne reale.
Fonti e stato della documentazione: 25 ottobre 2026.
