--- title: "Skill e comandi: super-poteri riutilizzabili" description: "Impacchettare i workflow ricorrenti in skill e slash command riutilizzabili che inneschi subito, e sapere quando ciascuno vale la pena" type: "lesson" locale: "it" course: "Claude Code Mastery - Diventare power user" number: "2.2" canonical: "https://agenticschool.dev/it/corsi/claude-code-mastery/skills-and-commands-reusable-superpowers" datePublished: "2026-06-12" dateModified: "2026-06-12" --- # Skill e comandi: super-poteri riutilizzabili - Course: Claude Code Mastery - Diventare power user - Lesson: 2.2 - Duration: 23 min - Level: einsteiger - Status: published - Canonical URL: https://agenticschool.dev/it/corsi/claude-code-mastery/skills-and-commands-reusable-superpowers - Locale: it > Impacchettare i workflow ricorrenti in skill e slash command riutilizzabili che inneschi subito, e sapere quando ciascuno vale la pena ## Summary Appena ti sorprendi a dare due volte le stesse istruzioni multi-passo all'agente, impacchettale. Gli slash command e le skill trasformano un workflow collaudato in un unico innesco riutilizzabile, perche l'agente abbatta un lavoro complesso e costante senza che tu riscriva il brief. Questa lezione mostra cos'e davvero un file SKILL.md, in cosa differisce da uno slash command e come costruire una piccola libreria personale adatta al tuo vero modo di lavorare. ## What you learn - Cos'e un file SKILL.md, cos'e uno slash command e quando afferrare ciascuno - Impacchettare un workflow multi-passo collaudato perche giri in modo costante ogni volta - Costruire una piccola libreria focalizzata di skill che ricordi e usi davvero ## Panoramica Le skill e gli slash command sono workflow riutilizzabili e nominati. Invece di descrivere lo stesso compito da zero ogni volta, ne richiami uno, e l'agente esegue i tuoi passi collaudati con il contesto gia caricato. Uno slash command e un innesco rapido per un prompt che riutilizzi. Una skill e una capacita piu ricca e autonoma che l'agente puo convocare quando e pertinente. Entrambi sono il modo per smettere di riscrivere i tuoi migliori workflow e cominciare a posarli come asset durevoli nel repo. ## Cosa imparerai Imparerai la differenza concreta tra uno slash command e una skill, cosa figura davvero in un file SKILL.md, incluso il suo frontmatter, come annotare un workflow che ripeti di continuo, e come costruire una libreria focalizzata di due o tre skill adatte al tuo modo di lavorare, piuttosto che una collezione pletorica che dimentichi. ## Prerequisiti Un setup Claude Code funzionante e un CLAUDE.md dalla lezione precedente, perche le skill e i comandi si appoggiano sulle convenzioni li definite - una skill che fa lo scaffolding di un componente dovrebbe seguire le stesse regole di nomenclatura e di stile che il tuo file di progetto fissa gia. ## Il problema Hai un workflow di cui ti fidi. Magari e "fai lo scaffolding di una nuova pagina, aggiungila al router, scrivi uno smoke test, lancia il quality gate". Scrivi ogni volta, un po' diversamente, lo stesso paragrafo che lo descrive, e ottieni risultati un po' diversi. Il sapere e nella tua testa e nelle tue dita, in nessun posto riutilizzabile. Quando sei stanco, dimentichi un passo. Quando lo fa un compagno di squadra, lo fa a modo suo. Il workflow e reale e collaudato, ma non e annotato, quindi e fragile e incostante. ## Slash command: un prompt riutilizzabile Uno slash command e la forma piu semplice di riutilizzo: un file markdown contenente un prompt che invochi digitando uno slash e il suo nome. Poni un file nella cartella dei comandi, e Claude Code lo rende disponibile come comando. E perfetto per un'azione unica e ben definita che inneschi spesso - lanciare il quality gate, aprire un pull request con la tua descrizione standard, riassumere cosa e cambiato dall'ultimo commit. Il file puo prendere argomenti, quindi un comando e flessibile da un caso all'altro. Afferra un comando quando vuoi velocita e un'azione unica e chiara. ```markdown --- description: Run the full pre-push quality gate and report failures clearly. --- Run these in order and stop at the first failure: 1. bun run lint 2. bun run typecheck 3. bun run test If anything fails, show me the exact error and the file it points to, then propose the smallest fix. Do not push. ``` Uno slash command sotto .claude/commands/ship-check.md, invocato come /ship-check ## Skill: una capacita impacchettata Una skill e piu di un prompt. E una cartella con un file SKILL.md alla sua radice, che porta un frontmatter (un nome e una descrizione) piu istruzioni, e opzionalmente script, template o file di riferimento raggruppati che l'agente puo usare. La descrizione conta enormemente: l'agente la legge per decidere quando la skill e pertinente e la convoca automaticamente, quindi una descrizione affilata e cio che rende una skill trovabile. Usa una skill quando un workflow e multi-passo, ha il suo contesto o i suoi asset, e ci guadagna a essere un'unita autonoma che mantieni in un solo posto. Ecco un vero frontmatter SKILL.md e un corpo per una skill che fa lo scaffolding di un componente. ```markdown --- name: new-component description: Scaffold a new React component with its test and story. Use when the user asks to create, add or scaffold a component. --- # New Component When creating a component: 1. Create the component in src/components as a PascalCase .tsx file. 2. Use rounded-sm and the existing button/card styles - never invent new tokens. 3. Create a colocated .test.tsx with a render smoke test. 4. Export it from the components barrel file. 5. Run bun run typecheck on just the new files and fix any errors. Follow all rules in the project CLAUDE.md. Never add a new UI dependency. ``` Un vero SKILL.md: frontmatter (name, description) piu istruzioni ## Annotare un workflow e scegliere la forma Il segnale per impacchettare qualcosa e semplice: la seconda volta che istruisci l'agente sulla stessa sequenza, quella sequenza e un candidato. Scrivi i passi una volta. Poi scegli la forma chiedendoti quanto e ricca. Un'azione unica e chiara senza asset e uno slash command. Un processo multi-passo con il suo contesto, template o script raggruppati e una skill. Non pensarci troppo - puoi partire con un comando e promuoverlo a skill piu tardi, quando cresce. Il guadagno e annotare il workflow e basta, la stessa abitudine di apprendimento continuo dell'ultima lezione, applicata ai processi invece che alle regole. - Ripetuto due volte = candidato all'impacchettamento. Non aspettare la decima volta. - Azione unica, nessun asset, velocita voluta: slash command. - Multi-passo, contesto proprio o file raggruppati, unita autonoma voluta: skill. - Una descrizione di skill eccellente e meta del lavoro - e cio da cui l'agente riconosce quando usarla. ## Una libreria personale focalizzata Parti piccolo e deliberato. Due o tre skill e comandi per i workflow che fai piu spesso - il tuo quality gate, fare lo scaffolding di un componente, aprire un pull request standard - battono una collezione pletorica di venti di cui ricordi la meta. Una libreria focalizzata e una libreria che afferri davvero, e ogni voce merita il suo posto risparmiandoti un vero brief ripetuto. Come per il file di regole, cancella cio che non usi piu e promuovi cio che incolli a mano. L'obiettivo non e il numero massimo di skill, e la leva massima per skill. ## Errori frequenti Le trappole abituali: costruire una skill prima di aver fatto girare il workflow abbastanza spesso da conoscerne i buoni passi, cosicche congeli un cattivo processo; scrivere una descrizione di skill vaga, cosicche l'agente non indovina mai quando invocarla; accumulare decine di skill di cui dimentichi l'esistenza; e duplicare una logica che appartiene da tempo al CLAUDE.md. Le skill sono per i workflow, il file di regole e per gli standard - tienili nelle loro corsie. ## ROI business Un workflow impacchettato e un processo che non dipende piu dalla persona che l'ha inventato. Il tuo modo migliore di fare lo scaffolding, testare o pubblicare diventa un innesco di una parola che si svolge allo stesso modo per te, per un compagno di squadra e per un freelance dal primo giorno. E cosi che una piccola squadra colpisce sopra il suo peso: il fondatore codifica il modo giusto di fare una cosa una volta, e tutti l'eseguono in modo costante per sempre. I processi incostanti sono una tassa silenziosa sulla qualita, e una piccola skills library la elimina al prezzo di qualche file markdown. ## Checklist Sei pronto ad andare avanti quando ognuno di questi punti e vero. La prossima lezione automatizza i controlli con cui questi workflow spesso terminano. - Sai spiegare quando uno slash command batte una skill e viceversa. - Hai scritto almeno uno slash command per un workflow che ripeti. - Sai descrivere cosa figura in un SKILL.md, incluso perche la descrizione conta. - La tua libreria e piccola e focalizzata, non un mucchio di voci inutilizzate. ## Risorse Tieni nei preferiti la documentazione ufficiale di Claude Code su skill e slash command per le posizioni esatte delle cartelle e i campi del frontmatter, che evolvono col tempo. La libreria di risorse ha uno starter pack di template di comandi e skill da copiare. Associa ogni skill al tuo CLAUDE.md, perche i workflow impacchettati ereditino automaticamente i tuoi standard di progetto. ## La tua missione Scegli il workflow su cui istruisci l'agente piu spesso. Scrivilo prima come slash command - solo il prompt in un file markdown della tua cartella di comandi. Invocalo due volte su vero lavoro. Se guadagna passi o ha bisogno dei suoi asset, promuovilo a skill con una descrizione affilata. Ora hai posato il tuo primo super-potere riutilizzabile nel repo. ## Prossima lezione Le skill e i comandi girano quando li inneschi. La prossima lezione va un gradino piu in la: hook e script che girano automaticamente in momenti chiave, perche i tuoi quality gate scattino senza che tu pensi mai a invocarli. ## Transcript Appena ti sorprendi a dare due volte le stesse istruzioni multi-passo all'agente, impacchettale. Gli slash command e le skill trasformano un workflow collaudato in un unico innesco riutilizzabile, perche l'agente abbatta un lavoro complesso e costante senza che tu riscriva il brief. Questa lezione mostra cos'e davvero un file SKILL.md, in cosa differisce da uno slash command e come costruire una piccola libreria personale adatta al tuo vero modo di lavorare.