«Ho paura di usare l'IA perché non ho alcuna conoscenza di programmazione...»
«Ho paura di guardare lo schermo nero del terminale e non mi va.»
«Ma sono ansioso di essere lasciato indietro dalla tendenza dell'IA 😱»
Anche in quello stato, facendo imparare a Claude Code i miei "schemi d'azione personali", un'attività che prima richiedeva 30 minuti ogni volta ora ne richiede 5.
In realtà, l'opportunità sta arrivando proprio per i non ingegneri.
La chiave sono le Skills.
In termini Pokémon, è una "MT" (Macchina Tecnica).
Quando usi Claude Code, ti è mai capitato di pensare?
- È sicuramente intelligente. Ma ogni volta devo impostare io il formato, i criteri di giudizio e le informazioni di base.
- Anche se è IA, c'è molto lavoro manuale. "Non è come fare tutto da solo?"
- Le altre persone lo usano in modo più efficace?
- Lo uso, ma non lo padroneggio. Non so qual è la differenza.
Quando avrai finito di leggere questo articolo, sarai in grado di creare un ambiente in cui imposti il tuo flusso di lavoro nell'IA una volta sola e ottieni output della stessa qualità ogni volta.
Santiago (@santtiagom_), un ingegnere di MercadoLibre, la più grande azienda di e-commerce del Sud America, ha pubblicato una guida completa alle Skills in spagnolo che sta attualmente diventando virale con oltre 580.000 visualizzazioni.
Dice di aver creato lui stesso oltre 50 Skills e di averne cancellate la maggior parte in due giorni. Questa guida si basa sulla sua esperienza reale di ciò che è rimasto e ha cambiato completamente il suo modo di lavorare con Claude.
Ho due richieste prima di iniziare.
- Salva questo articolo e trova 20 minuti questa settimana.
- Se conosci qualcuno che usa Claude Code, condividilo con loro.
Questa volta, spiegherò il contenuto in modo facile da capire.
Ecco il post originale.
https://x.com/santtiagom_/status/2030305647535751338
Perché Claude Ha Bisogno di Impostazioni Ogni Volta
Prima di tutto, parliamo della premessa principale.
Claude Code è molto intelligente. Tuttavia, non conosce "il tuo modo di lavorare."
Questo non è un problema di prestazioni, ma di come funziona.
Claude parte da una lavagna bianca ogni volta che apri una nuova sessione. A meno che tu non glielo dica ogni volta, Claude non sa quale formato preferisci, che tipo di rapporto vuole il tuo capo o quale tono usi nelle email ai clienti. Questi sono "i tuoi criteri di giudizio unici."
Questo meccanismo causa tre problemi.
Problema 1: Mancanza di Coerenza
Anche con la stessa richiesta di "creare un rapporto settimanale", oggi potrebbe essere una versione dettagliata di 2000 caratteri e domani potrebbe essere tre punti elenco. Poiché il tuo formato desiderato non è impostato, Claude deve decidere da solo ogni volta.
Problema 2: Manca il Tuo Criterio di Giudizio Unico
Claude è eccellente in generale. Ma non conosce regole che valgono solo nel tuo ambiente, come "nella tua azienda, devi iniziare con la conclusione" o "il tuo capo non legge documenti più lunghi di 3 pagine."
Quindi ogni volta devi impostare quel contesto da capo.
Problema 3: Lo Sforzo dell'Impostazione si Accumula
Scrivere le specifiche del formato, spiegare i criteri di giudizio e condividere le informazioni di base.
Quanto tempo passi su questa "impostazione" in un giorno? Anche se usi l'IA, ti stanchi solo per la preparazione.
santtiagom_ scrive:
"E se potessi scrivere un'istruzione una volta e farla fare perfettamente da quel momento in poi senza dare di nuovo istruzioni? Questo è ciò che sono le Skills."
Le Skills sono un meccanismo in cui scrivi il tuo flusso di lavoro in un singolo file e lo imposti in Claude. Una volta impostato, Claude agirà secondo esso dalla volta successiva senza che tu dica nulla.
Da qui in poi, spiegherò il quadro generale delle Skills in ordine.
Le Skills Sono le "Macchine Tecniche" di Claude
Hai mai usato una "Macchina Tecnica" (MT) in Pokémon?
Caricando un solo disco, quel Pokémon impara una nuova mossa. Una volta imparata, la mossa può essere usata tutte le volte che vuoi in ogni battaglia. Per sempre, a meno che tu non gliela faccia dimenticare.
Le Skills sono esattamente come queste "Macchine Tecniche."
Creare un file chiamato SKILL.md e impostarlo in Claude.
Quindi, Claude agirà secondo quelle istruzioni ogni volta che apre una sessione. Non avrai più bisogno di impostare le cose ogni volta.
Per organizzare la corrispondenza in modo semplice:
- Una MT → Un file SKILL.md
- Un Pokémon che ha imparato una mossa la usa in ogni battaglia → Claude con una Skill impostata la applica in ogni sessione
- Sostituibile (può reimparare) → Le Skills possono anche essere aggiunte/cancellate/sostituite liberamente
- Esiste compatibilità (alcune mosse non possono essere imparate) → Alcune Skills non si adattano al progetto
La cosa importante è che anche il tuo lavoro ha "compiti che possono essere trasformati in MT."
Ad esempio, quando si fa un rapporto:
"Scrivi prima la conclusione. Usa non più di 3 punti dati. Usa un formato che il capo possa giudicare in 5 secondi."
Se imposti questo come Skill, Claude seguirà automaticamente questa regola dalla volta successiva.
Quando si fa un rapporto settimanale:
"Tre parti: Risultati della scorsa settimana → Piani di questa settimana → Problemi.
Scrivi i numeri come confronto settimana su settimana." Puoi anche impostarlo come Skill.
Quando si scrive un'email a un cliente:
"Esprimi gratitudine all'inizio. Mantieni il punto principale entro 3 righe. Indica chiaramente una sola azione successiva." Anche questo.
Confrontiamo un mondo con le Skills e uno senza.
[Senza Skills]
Chiedi di "creare un rapporto settimanale" → Claude produce output nel suo formato → Lo correggi: "No, prima la conclusione," "Limita i dati a 3 punti" → La settimana successiva, ricominci da capo a digitare tutto.
[Con Skills]
Chiedi di "creare un rapporto settimanale" → Claude produce output secondo le Skills → Dall'inizio, è nel formato "Conclusione → 3 Punti Dati → Problemi" → Le correzioni sono quasi zero.
santtiagom_ sottolinea ripetutamente questo modo di pensare nel suo articolo:
"Una Skill funzionante di 5 righe vale più di una Skill perfetta con 80 regole."
Non hai bisogno di creare istruzioni perfette. Anche solo due righe come "Scrivi dalla conclusione. Fino a 3 punti dati" saranno efficaci se impostate come Skill.
E questa è la parte che personalmente voglio trasmettere di più.
L'essenza delle Skills non è "l'automazione del lavoro."
È "l'atto di verbalizzare i propri criteri di giudizio e impostarli nell'IA."
"Scrivi dalla conclusione," "Limita i dati a 3 punti." Queste non sono procedure di lavoro, ma i tuoi criteri di giudizio. A quali informazioni dare priorità, in quale ordine trasmetterle e quanto in dettaglio scrivere.
Lasci quei giudizi in un file. Proprio come una mossa imparata da una MT diventa la forza di un Pokémon, i criteri di giudizio verbalizzati diventano la forza di Claude.
Patrimonializzazione del giudizio. Se dovessi descrivere le Skills in una parola, è questa.
Tutto Ciò di Cui Hai Bisogno è un Solo File: SKILL.md
Il meccanismo delle Skills è molto più semplice di quanto pensi.
Tutto ciò di cui hai bisogno è un file chiamato SKILL.md.
Il contenuto di questo file è diviso in due parti.
Parte 1: La "Copertina" con Nome e Descrizione
All'inizio del file, scrivi il nome della Skill e una descrizione di "quando dovrebbe essere usata."
Claude guarda questa "copertina" e giudica "se dovrebbe usare questa Skill per il compito corrente." Se questo è ambiguo, Claude non troverà la Skill che hai lavorato duramente per creare.
Ad esempio, con solo il nome "Creazione Rapporto," Claude si chiederà "Quale rapporto? Quando lo uso?"
Se scrivi "Crea un rapporto settimanale delle vendite per il Manager Rossi. Struttura: Conclusione → Numeri → Problemi," Claude selezionerà automaticamente questa Skill nel momento in cui arriva una richiesta per un rapporto settimanale.
In termini di MT, questa copertina corrisponde al giudizio di "quale Pokémon può imparare questa mossa."
Parte 2: Il "Corpo" con Istruzioni Specifiche
Questo è il tuo modo di lavorare effettivo.
Scrivi procedure e regole specifiche come "Scrivi in questo ordine," "Segui questo formato," e "Assicurati di controllare solo questo punto."
Le Skills funzionano con solo queste due parti.
È più veloce guardare un file reale, quindi ecco un esempio. Presuppone una situazione in cui un team di vendita presenta un rapporto settimanale al proprio capo ogni settimana.
1---2name: Rapporto Vendite Settimanale3description: Usa quando crei il rapporto settimanale per il team vendite ogni lunedì. Per il Manager Rossi.4---56# Rapporto Vendite Settimanale78## Formato9- Scrivi la conclusione (previsione di atterraggio per questa settimana) nella prima pagina10- Includi sempre i numeri come confronto settimana su settimana (es. +12% rispetto alla scorsa settimana)11- Classifica le trattative in tre livelli: A/B/C12- Limita i problemi a uno e aggiungi un'azione specifica di una riga per la prossima settimana1314## Regole del Manager Rossi15- Non legge più di 3 pagine. Mantienilo entro 2 pagine16- Preferisce le tabelle ai grafici17- Non scrivere "in valutazione." Convertilo sempre in "cosa sarà fatto entro quando"
Questo è il quadro generale di SKILL.md.
Guardando la descrizione sulla "copertina" che dice "ogni lunedì... per il Manager Rossi," Claude giudica automaticamente, "Oh, si tratta del rapporto settimanale."
Quindi, seguendo le istruzioni nel "corpo," crea un rapporto di 2 pagine o meno che inizia con la conclusione nello stesso formato ogni volta.
Regole come "Regole del Manager Rossi," che valgono solo nel tuo posto di lavoro, sono il vero valore delle Skills. Non importa quanto sia intelligente Claude, non conoscerà le preferenze del Manager Rossi a meno che tu non gliele insegni.
Ci sono due modi per attivarla.
Il primo è chiamarla direttamente tu stesso, tipo "/creazione-rapporto." Usalo quando vuoi assicurarti che si attivi.
Il secondo è che Claude legga la descrizione della copertina e giudichi automaticamente che "questa dovrebbe essere usata ora." Se la descrizione è ben scritta, si attiverà da sola senza che tu dia alcuna istruzione.
Se diventa una Skill più grande, puoi aggiungere cartelle ausiliarie per materiali di riferimento e modelli, ma all'inizio basta un SKILL.md.
Claude Non Rallenterà Nemmeno con 50 Skills
"Se inserisco molte Skills, Claude non rallenterà?"
Penso che questa sia una domanda che tutti si fanno all'inizio.
La risposta è: non rallenterà.
Claude non carica tutte le Skills in una volta; è progettato per caricare solo ciò che è necessario in fasi.
In termini di MT, un Pokémon non pensa a tutte le sue mosse tutto il tempo. Sceglie la mossa da usare in base alla situazione di battaglia. Claude è lo stesso.
Livello 1: Prima, dai un'occhiata ai nomi
Controlla leggermente solo il "nome e descrizione" di tutte le Skills. Non ha ancora letto il contenuto del file.
Livello 2: Legge il testo completo solo di ciò che è necessario
Se trova una Skill che sembra correlata alla richiesta corrente, legge il testo completo solo di quella Skill. Non tocca il resto.
Livello 3: Legge materiali correlati aggiuntivi se necessario
Se la Skill specifica "leggi anche questo materiale di riferimento," legge anche quel file.
In altre parole, anche se ci sono 50 Skills, solo "1 o 2 correlate al lavoro corrente" vengono effettivamente caricate. Non ha quasi alcun impatto sulle prestazioni.
Tuttavia, c'è una cosa a cui prestare attenzione.
Se la "descrizione" sulla copertina è sciatta, Claude non sarà in grado di trovare la Skill necessaria.
Al Livello 1, potrebbe essere giudicata erroneamente come "questa non sembra correlata questa volta" e saltata.
Ecco perché ho detto che la descrizione della copertina è la cosa più importante. È fondamentale scrivere chiaramente "quando e per che tipo di compito questa Skill dovrebbe essere usata."
Come guida pratica, non c'è alcun problema finché il totale di tutti i nomi e le descrizioni delle Skills è entro 15.000 caratteri. È improbabile che tu raggiunga mai questo limite con un uso normale.
La Tua Prima Skill è Completata in 6 Passaggi
Ora per la parte pratica.
Analizzerò i "6 passaggi per creare la tua prima Skill" introdotti da santtiagom_.
Tuttavia, prima identifica il momento per creare una Skill. Se anche solo una delle seguenti tre condizioni si applica, è il momento per una Skill:
- Ci sono informazioni di base che stai digitando manualmente (formato, regole, tono, ecc.)
- C'è un compito che vuoi venga prodotto con la stessa qualità ogni volta
- C'è un passaggio che dimentichi sempre
Al contrario, le Skills non sono adatte per compiti una tantum o lavori in cui le condizioni sono completamente diverse ogni volta.
Diamo un'occhiata ai 6 passaggi in ordine.
1️⃣ I semi delle Skills sono nella ripetizione
"Se hai digitato le stesse informazioni di base 3 o più volte, è un candidato per una Skill."
santtiagom_ lo afferma.
Formati di verbali di riunioni, regole di struttura dei rapporti, toni delle email. Se ci sono informazioni di base che digiti ogni volta, questo è un segno che dovrebbero essere impostate in una Skill.
A partire da oggi per una settimana, prova a prendere appunti su ciò che digiti manualmente in Claude. Troverai cose che ripeti 3 o più volte.
2️⃣ Pronto con una cartella e un file
Crea una cartella chiamata .claude/skills/ all'interno del tuo progetto Claude Code, crea una cartella con il nome della Skill al suo interno e posiziona lì il file SKILL.md.
1.claude/skills/2 └── rapporto-settimanale/3 └── SKILL.md
Questo è tutto ciò di cui hai bisogno per essere pronto.
3️⃣ 5 righe sono sufficienti all'inizio
Ricorda le parole di santtiagom_: "Una Skill funzionante di 5 righe vale più di una Skill perfetta con 80 regole."
Non puntare alla perfezione dall'inizio.
Anche per l'esempio del rapporto settimanale di prima, questo è sufficiente all'inizio:
1---2name: Rapporto Vendite Settimanale3description: Usa quando crei il rapporto settimanale per il team vendite ogni lunedì4---56Scrivi prima la conclusione. I numeri sono confronto settimana su settimana. Limita i problemi a uno. Entro 2 pagine.
Fatto. Il corpo è solo una riga.
Che ne dici? Se è solo così, potresti farlo a partire da oggi, giusto?
Man mano che lo usi, se noti "Il Manager Rossi preferisce le tabelle ai grafici" o "Se scrivo 'in valutazione,' viene rispedito indietro," puoi semplicemente aggiungerli ogni volta.
La versione finita di prima è il risultato di una crescita in questo modo.
4️⃣ L'effetto è chiaro con test di confronto
Prova la stessa richiesta sia con la Skill attivata che con quella disattivata.
Se c'è una chiara differenza nell'output, è la prova che la Skill funziona.
Se non c'è differenza, il contenuto della Skill potrebbe contenere solo cose che "Claude già sa." Prova ad aggiungere criteri di giudizio che solo tu conosceresti.
5️⃣ Le Skills crescono ogni volta che falliscono
Se dopo il test senti "questa parte è ancora sbagliata," aggiungilo a SKILL.md ogni volta.
Per citare le parole di santtiagom_, "Se hai fatto la stessa correzione 3 volte, aggiungila alla Skill."
Una Skill perfetta non è qualcosa che si crea dall'inizio; è qualcosa che si fa crescere mentre la si usa. Questo processo di "imparare dal fallimento e crescere" è l'atto di rendere i tuoi criteri di giudizio sempre più precisi.
6️⃣ Claude stesso darà suggerimenti per il miglioramento
Questa è la parte interessante.
Usando la Skill skill-creator fornita ufficialmente da Anthropic, Claude stesso suggerirà cose come "Che ne dici di fare così per rendere questa Skill ancora migliore?"
Una volta impostato il tuo flusso di lavoro nell'IA, l'IA risponde con "Sarebbe più efficiente farlo in questo modo." Questo ciclo è il divertimento e la forza delle Skills.
3 Bandiere Rosse per Far Crescere Skills Utili
Una volta creata una Skill, devi verificare se funziona correttamente.
santtiagom_ elenca un solo metodo di giudizio.
Se esegui lo stesso compito 3 volte e ottieni risultati diversi ogni volta, quella Skill ha bisogno di miglioramenti.
Nello specifico, fai attenzione a queste tre bandiere rosse:
Bandiera Rossa 1: Le istruzioni vengono ignorate
Questo accade quando la formulazione della Skill è ambigua.
Ad esempio, anche se specifichi "scrivi chiaramente," il criterio per "chiaro" non è chiaro per Claude. In questo caso, Claude non ha altra scelta che scrivere in base al proprio giudizio.
"Scrivi prima la conclusione. Mantieni una frase entro 40 caratteri. Non usare termini tecnici."
Se scrivi in modo specifico fino a questo punto, Claude non esiterà. Il trucco è scrivere con numeri e regole specifiche piuttosto che con aggettivi ambigui.
Bandiera Rossa 2: La Skill non si attiva
Questo è un caso in cui c'è un problema con la descrizione della "copertina."
Ricorda il discorso sul caricamento a fasi di prima. Claude giudica guardando solo il "nome e descrizione" al Livello 1. Se la descrizione qui è ambigua, verrà saltata come "non sembra correlata questa volta."
Controlla se la descrizione rende chiaro a colpo d'occhio "quando e per quale compito dovrebbe essere usata."
Bandiera Rossa 3: L'output è generico, nessuna differenza con/senza Skill
Questo è uno stato in cui il contenuto scritto nella Skill è solo cose che "Claude già sa."
Claude è intelligente, quindi può giudicare le cose generali da solo senza che gli venga insegnato. Il modo corretto è scrivere criteri di giudizio che solo tu conosci nelle Skills.
"Il capo legge dalla conclusione," "Salta i dati se superano i 3 punti," "Si arrabbia se non è scritto come confronto settimana su settimana." Queste regole, necessarie proprio a causa del tuo ambiente, determinano il valore di una Skill.
Dalle best practice di santtiagom_, ho selezionato 4 punti particolarmente importanti da introdurre.
① Claude è intelligente. Non c'è bisogno di insegnargli ciò che sa.
Istruzioni generali come "output in formato JSON" non sono necessarie. Claude lo sa già. Per favore, insegnagli i criteri di giudizio del tuo lavoro, come "perché lo fai in quel modo" e "in quale ordine lo fai."
② Dividi se supera le 500 righe
Dice 500 righe, ma in operatività reale, circa 100 righe per skill.md stesso è l'ideale. Se il volume aumenta troppo, la qualità del giudizio di Claude Code diminuirà.
Quindi, se una Skill diventa troppo grande, conserva i materiali di riferimento in una cartella separata. Il trucco per un uso a lungo termine è mantenere il corpo di SKILL.md concentrato solo sulle istruzioni principali.
③ Testa con casi reali, non ideali
Testare con una richiesta fittizia è inutile. Provalo con un lavoro che fai effettivamente il lunedì usando le Skills. È nel lavoro reale che vedrai le istruzioni mancanti.
④ Fallo crescere mentre lo usi piuttosto che puntare alla perfezione
Se fai la stessa correzione 3 volte, aggiungila a SKILL.md. Questa ripetizione è la via più breve per far crescere una Skill dedicata a te.
Per Chi Vuole Usarlo Più a Fondo
Questa è la sezione avanzata.
Non tutti hanno bisogno di farlo subito, ma lo introdurrò per coloro che vogliono "utilizzarlo ulteriormente."
1️⃣ Ci sono Skills ufficiali che puoi usare immediatamente
Anthropic, lo sviluppatore di Claude, ha rilasciato ufficialmente 5 tipi di Skills.
Elaborazione di file Word, analisi di file Excel, lettura di PDF, generazione di PowerPoint e design front-end. Puoi usarli immediatamente semplicemente installandoli da GitHub.
C'è anche un sito chiamato skills.sh che raccoglie Skills create dalla community. Tuttavia, poiché sono create da terze parti, consiglio di controllare i contenuti prima di usarle. C'è la possibilità che siano incluse cose rischiose, quindi presta molta attenzione.
2️⃣ Ci sono due posizioni di archiviazione: per te stesso e per il team
Le Skills hanno due posizioni di archiviazione.
Solo per te:
Se lo posizioni in .claude/skills/ nella tua home folder, diventa una Skill a te dedicata che può essere usata indipendentemente dal progetto che apri.
Per la condivisione del team:
Se lo posizioni in .claude/skills/ all'interno di un progetto, è incluso nel controllo versione, quindi tutti nel team possono usare la stessa Skill.
Personalmente, penso che questa condivisione del team sia l'essenza nascosta delle Skills.
Il fatto che i tuoi criteri di giudizio diventino un file significa che anche se qualcuno del team cambia, la qualità del lavoro viene mantenuta. I criteri di giudizio non dipendono più dagli individui. Questo è un cambiamento piuttosto grande per un'organizzazione.
3️⃣ Le Skills si collegano anche con servizi esterni
Combinando le Skills con MCP, un meccanismo per connettersi a strumenti esterni, Claude diventa in grado di interagire direttamente con servizi esterni.
santtiagom_ descrive questo come "diventare in grado di delegare processi invece di istruzioni."
Tuttavia, questo è un uso avanzato per ingegneri. Raccomando di iniziare dai 6 passaggi di base introdotti nella sezione precedente.
Riepilogo
Riassumo i punti di questo articolo in 6 elementi. Salvalo in modo da poterlo rivedere.
- Le Skills sono "file per impostare flussi di lavoro nell'IA." Come una MT Pokémon, una volta impostata, si attiva ogni volta.
- Claude è intelligente ma non conosce "il tuo modo di lavorare." Senza Skills, devi impostare tutto da solo ogni volta.
- Tutto ciò di cui hai bisogno è un file: SKILL.md. Il contenuto è solo "Nome + Descrizione + Istruzioni."
- Va bene inserirne 50. Claude seleziona e carica solo le Skills necessarie.
- Iniziare in piccolo e far crescere è la strada giusta. Una Skill funzionante di 5 righe batte una Skill perfetta con 80 regole.
- L'essenza delle Skills non è l'automazione del lavoro ma la "patrimonializzazione del giudizio." L'atto di verbalizzare i propri criteri di giudizio e impostarli nell'IA.
A coloro che hanno trovato questo articolo anche solo leggermente utile.
Il Laboratorio Claude Code dell'Università di Tokyo (@ClaudeCode_UT) è un account che pubblica quotidianamente, incentrato su membri che sono appassionati hardcore di Claude Code e attuali studenti dell'UTokyo.
Forniamo ogni giorno informazioni e know-how "genuinamente utili" specializzati per il business pratico.
Seguendoci, puoi ottenere informazioni come queste 👇
- Guide pratiche per "tecniche per far imparare il lavoro all'IA" come Skills e CLAUDE.md
- Spiegazioni degli ultimi argomenti di utilizzo dell'IA dall'estero per non ingegneri
- Questo è l'unico posto dove puoi ricevere competenze di Claude Code "genuinamente utili" gratuitamente
Se sei interessato, seguici e dai un'occhiata! 👀
Inoltre, abbiamo avviato un LINE ufficiale, quindi se vuoi ottenere rapidamente informazioni limitate, unisciti! Acceleriamo il nostro apprendimento e superiamo insieme l'era degli agenti IA! ❗️
