Claude Code Skills: come lavorare con Superpowers

Che cos'è Superpowers per Claude?

Superpowers è la raccolta di skill per lo sviluppo software creata da Jesse Vincent, insieme alle istruzioni che spingono un agente di programmazione a usarle. In Claude Code di Anthropic, l'assistente che lavora sul tuo repository, introduce procedure per comprendere una richiesta, pianificare le modifiche, eseguire test, fare debugging, delegare e completare il lavoro su un branch. Immaginalo come il manuale operativo di un'officina: gli attrezzi ci sono già; il manuale stabilisce l'ordine delle operazioni e i controlli da effettuare prima della consegna. README di Superpowers

Verifica del 18 ottobre 2026: il manifest del sorgente indica la versione 7.0.0 e il repository contiene 15 cartelle di skill al primo livello, ciascuna con un file SKILL.md. Questi dati descrivono il sorgente esaminato per l'articolo; controlla quale revisione installa il marketplace che hai scelto. Manifest del plugin, directory delle skill

Il vantaggio pratico è poter seguire una sequenza di decisioni esplicite. Prima di modificare una funzionalità, Claude può definirne il comportamento atteso. Prima di dichiararla conclusa, può esigere il risultato di un test appena eseguito. Queste istruzioni offrono elementi concreti da esaminare, ma non dimostrano che i requisiti o i test siano corretti.

Come si installa Superpowers in Claude?

Scegli una delle modalità di installazione descritte nel README del progetto ed eseguila all'interno di Claude Code. I comandi qui sotto sono riportati esattamente come compaiono nella sezione dedicata a Claude Code: sono comandi slash interattivi, non comandi da incollare in una normale shell. Istruzioni di installazione nel README

Il comando per installare il plugin dal marketplace ufficiale

/plugin install superpowers@claude-plugins-official

L'autore documenta anche un proprio marketplace. Se preferisci questa modalità, registra il marketplace e poi installa il plugin:

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

Scegli una fonte di cui riesci a seguire gli aggiornamenti. Usare entrambe le modalità per configurare lo stesso plugin non porta vantaggi.

Dopo l'installazione, apri una nuova sessione di Claude Code per mettere alla prova l'hook di avvio. Assegna una richiesta circoscritta, per esempio l'aggiunta di un filtro a un elenco di attività esistente. Il controllo concreto consiste nell'osservare se Claude annuncia una skill pertinente e ne segue le istruzioni. Il completamento del comando di installazione e il corretto funzionamento del processo sono due verifiche diverse.

Che cosa cambia nella sessione dopo l'installazione?

Il primo cambiamento riguarda il contesto: un hook di avvio inserisce nella conversazione le istruzioni d'uso di Superpowers. Il matcher configurato per SessionStart comprende startup, clear e compact. Lo script legge using-superpowers, ne inserisce il testo e indica a Claude di caricare le altre skill tramite lo strumento Skill. Non incolla il contenuto completo di tutte le skill nel messaggio iniziale. Configurazione dell'hook, script di avvio

Come viene scelta una skill di Superpowers?

Claude confronta il compito con le descrizioni delle skill, poi legge le istruzioni pertinenti. La guida del plugin dedicata alla scrittura delle skill spiega che le descrizioni devono chiarire quando usarle. Le istruzioni iniziali chiedono all'agente di fare questa verifica prima di rispondere o agire, di annunciare la skill scelta e di dare precedenza alle skill di processo rispetto a quelle di implementazione. Indicazioni per individuare le skill

Una richiesta di realizzare qualcosa rimanda quindi a brainstorming; un test che fallisce rimanda a systematic-debugging. Una skill specifica del dominio può poi guidare l'implementazione. Puoi anche richiamare esplicitamente una skill per nome, per esempio: «Usa superpowers:systematic-debugging per indagare su questo errore prima di proporre una correzione». Istruzioni d'uso

La selezione automatica è un'istruzione impartita al modello, non un meccanismo deterministico basato su parole chiave. L'hook fornisce le istruzioni iniziali; spetta comunque all'agente riconoscere la situazione e seguire quelle della skill selezionata. Se sceglie il processo sbagliato, precisa l'ambito del compito oppure richiedi direttamente la skill pertinente.

Claude Code Skills: quali skill include Superpowers e quando si attivano?

La raccolta copre l'intero ciclo di sviluppo, ma ogni sessione dovrebbe caricare le skill adatte al lavoro da svolgere. I nomi riportati qui sono quelli esatti dei file esaminati. La colonna dedicata all'uso riassume descrizioni e istruzioni: non garantisce che una certa frase attivi sempre una determinata skill. Directory attuale delle skill

Non serve imparare a memoria l'elenco. Nello sviluppo ordinario di una funzionalità, osserva i passaggi: richiesta compresa, piano concreto se necessario, implementazione verificata con i test, modifica revisionata, decisione sull'integrazione. Per un bug, il punto di partenza utile è l'indagine, anziché una discussione di progettazione su una nuova funzionalità.

Come si integra con la modalità piano nativa e con le tue skill?

Superpowers definisce un processo attorno alla pianificazione; la sua skill writing-plans è distinta dalla modalità piano nativa di Claude Code. Le istruzioni iniziali attuali chiedono esplicitamente di richiamare brainstorming prima di entrare in modalità piano, se il brainstorming non è già avvenuto. Stabiliscono quindi un ordine delle operazioni, senza trattare la modalità nativa e la propria skill di pianificazione come intercambiabili. Istruzione attuale sulla pianificazione

writing-plans produce un documento nel repository, normalmente sotto docs/superpowers/plans/, con le decisioni di implementazione e i controlli previsti. Alla consegna, chiede all'utente di rivedere il piano e scegliere come eseguirlo, salvo che la scelta sia già stata comunicata. La sola selezione di una modalità non fornisce quel documento né le istruzioni per i singoli compiti. Per i comandi e il comportamento dell'ambiente, consulta la guida alla modalità piano di Claude Code.

Anche le tue skill continuano ad avere un ruolo. Il file writing-skills del plugin indica ~/.claude/skills/ come directory delle skill personali di Claude Code; le istruzioni iniziali collocano esplicitamente le istruzioni dell'utente, compresi CLAUDE.md e le richieste dirette, al di sopra di quelle delle skill. Una skill specifica del progetto può quindi contenere le tue convenzioni, mentre Superpowers fornisce il processo di sviluppo. Definisci chiaramente questa ripartizione se entrambi stabiliscono come svolgere test o revisioni. File per la scrittura delle skill, priorità delle istruzioni

Per capire il meccanismo dei file di istruzioni, leggi la guida alle skill degli agenti. Superpowers è una raccolta costruita su quel meccanismo, con un proprio metodo di lavoro.

Superpowers in Claude Code: dall'idea al merge di una funzionalità

Basta un interruttore «Nascondi completate» per illustrare l'intero processo. L'esempio seguente è ricavato dai file delle skill e non documenta una sessione di prova registrata. I nomi dei file, i casi di accettazione e l'esito sono ipotetici.

Immaginiamo un'app per gestire attività che disponga già di test. L'utente chiede un interruttore per nascondere le attività completate senza eliminarle. In questo esempio richiede esplicitamente un piano scritto e revisioni dei singoli compiti affidate a subagenti. Una modifica così piccola potrebbe altrimenti seguire il percorso più breve, con accordi presi in chat.

Definire il comportamento con brainstorming

La domanda decisiva è se «nascondere» debba riguardare soltanto la vista corrente oppure modificare le attività memorizzate. Nell'esempio, il comportamento concordato è un filtro applicato solo alla vista: l'interruttore è inizialmente disattivato, le attività completate ricompaiono quando lo si disattiva e, se la vista filtrata è vuota, un messaggio indica che non ci sono attività da completare.

Claude riepiloga l'ambito concordato e ottiene l'approvazione. Poiché l'utente ha scelto il percorso scritto, la progettazione viene raccolta in un documento sotto docs/superpowers/specs/, con un controllo da parte di chi dovrà implementarla prima della consegna. Il percorso ordinario della skill per le piccole modifiche consente invece di mantenere descrizione e accordo nella chat. Regole del brainstorming

L'elemento da esaminare è l'accordo sul comportamento. Se introduce senza dichiararlo il salvataggio delle preferenze o modifiche alla memorizzazione delle attività, la funzionalità si è già allargata prima ancora di iniziare l'implementazione.

Rendere il lavoro verificabile con writing-plans

Il piano divide la funzionalità in risultati verificabili separatamente. Un compito implementa una funzione di filtro nell'ipotetico file src/tasks/filterTasks.ts, con test per elenchi misti, vuoti e composti interamente da attività completate. Un altro collega un interruttore accessibile in src/tasks/TaskList.tsx, usando l'interfaccia concordata per la funzione e verificando con i test il risultato visibile.

Il piano specifica file, interfacce, asserzioni dei test, comandi di test del progetto e risultati attesi. Precisa inoltre che il filtro deve lasciare intatta la raccolta di attività sottostante. L'utente rivede il piano e conferma l'uso dei subagenti. È qui che un'indicazione vaga diventa abbastanza precisa da permettere a chi implementa e a chi revisiona di discutere divergenze concrete. Istruzioni per scrivere i piani

Preparare l'ambiente con using-git-worktrees

All'avvio dell'esecuzione, Claude controlla se il lavoro è già isolato. Un worktree Git è un'altra directory di lavoro dello stesso repository, in genere associata a un proprio branch. La skill privilegia il meccanismo di worktree nativo dell'ambiente e rispetta eventuali preferenze già espresse dall'utente; in caso contrario, chiede prima di crearne uno.

Nell'esempio, l'utente approva un worktree dedicato alla funzionalità. Claude vi esegue i test esistenti del progetto prima di modificare l'applicazione. Se i test falliscono già nello stato iniziale, occorre occuparsene prima di attribuire eventuali errori successivi al nuovo interruttore. Istruzioni per l'ambiente di lavoro

Implementare i compiti con subagent-driven-development e test-driven-development

L'agente coordinatore assegna il filtro a un nuovo agente incaricato dell'implementazione, poi ne organizza la revisione. Passa al compito sull'interfaccia solo dopo questo controllo. La skill attuale per i subagenti verifica, nella revisione di ogni compito, la conformità alle specifiche e la qualità del codice; richiede poi una revisione più ampia del branch completato. Registra inoltre avanzamento e decisioni in un registro dedicato al piano. Processo con subagenti

Durante l'implementazione, test-driven-development introduce il ciclo red-green-refactor. In questo caso, un test dimostra inizialmente che la richiesta della vista filtrata restituisce ancora un'attività completata. Solo dopo aver osservato quel fallimento, l'agente aggiunge il comportamento di filtro, riesegue il test e riordina il codice mantenendo i test superati. Istruzioni TDD

Per la parte di interfaccia, l'asserzione utile riguarda ciò che l'utente vede dopo aver azionato l'interruttore. Un test che controllasse soltanto se una funzione è stata chiamata non dimostrerebbe il comportamento visibile della funzionalità.

L'alternativa è executing-plans: Claude implementa direttamente il piano nella sessione corrente e, quando sono disponibili subagenti, alla fine affida a un nuovo revisore il controllo dell'intero branch. Scegli questo percorso quando i passaggi di consegne per ogni singolo compito non corrispondono alla struttura di revisione che ti serve. Istruzioni per l'esecuzione nella sessione corrente

Gestire i problemi emersi con le skill di revisione e systematic-debugging

Nella revisione finale del branch, requesting-code-review prepara la consegna al revisore. Supponiamo che il revisore scopra che disattivare l'interruttore non fa ricomparire le attività completate. receiving-code-review richiede di confrontare l'osservazione con il codice e con il comportamento atteso prima di intervenire. Richiesta di revisione, gestione delle osservazioni

Se l'errore è riproducibile, systematic-debugging guida l'indagine attraverso l'analisi della causa radice, l'analisi degli schemi ricorrenti, la verifica delle ipotesi e l'implementazione. Nell'esempio, l'ipotesi potrebbe essere che il codice abbia sostituito la raccolta originale con quella filtrata. Occorre esaminare il flusso dei dati, riprodurre la perdita e correggerne la causa con un test di regressione. Non basta forzare l'aspetto dell'interruttore perché sembri corretto. Istruzioni di debugging

Dimostrare che il lavoro è concluso e scegliere il merge

verification-before-completion richiede l'output di comandi appena eseguiti prima di dichiarare il successo. Per questa funzionalità servono quindi evidenze sul comportamento del filtro, sull'interazione con l'interruttore e sui controlli pertinenti del progetto, indicando chiaramente gli errori ancora irrisolti. Istruzioni di verifica

A questo punto finishing-a-development-branch verifica l'intera suite di test e presenta le opzioni di integrazione. Su un normale branch con un nome, il file attuale propone un merge locale, il push con creazione di una pull request oppure il mantenimento del branch. Aspetta la decisione dell'utente: una revisione superata non autorizza implicitamente il merge.

Per completare l'esempio, l'utente sceglie un merge locale nel branch di base confermato. Claude esegue il merge, verifica il risultato con i test e rimuove il worktree e il branch della funzionalità solo dopo il loro superamento. La creazione di una pull request lascerebbe invece il lavoro in attesa della procedura di merge del repository. Istruzioni per completare il branch

Quando basta un processo più leggero?

Il processo diventa un peso quando continua a chiedere decisioni già definite nella richiesta. Rinominare un'etichetta visibile con un testo sostitutivo preciso non dovrebbe richiedere la stessa preparazione di una modifica al modo in cui vengono memorizzati gli stati delle attività. È una valutazione del lavoro aggiunto dal processo, non una misura del tempo impiegato.

Il file attuale di brainstorming distingue tre dimensioni del lavoro:

• Compito rapido e chiaro: la richiesta contiene già la descrizione necessaria; procedi.
• Piccola modifica: concorda la descrizione in chat, poi passa allo sviluppo seguendo il processo ordinario.
• Progetto: ottieni l'approvazione di un documento di progettazione, poi prepara un piano completo di implementazione del software.

Lo stesso file consente all'utente di rinunciare esplicitamente alle domande, chiudendo così quel passaggio di brainstorming. Questa scelta non annulla automaticamente le altre istruzioni su test e verifiche. Regole sulla portata dei compiti e sulla rinuncia alle domande

Un'istruzione utile è: «È una piccola modifica. Mantieni la descrizione in chat, usa la configurazione di test esistente e non ampliare la funzionalità». Per una correzione di testo già definita, indica le parole esatte e l'ambito dell'intervento. Sono vincoli del compito riconosciuti dalla gerarchia delle istruzioni del plugin, non comandi segreti per aggirarla.

Il limite è il carico aggiuntivo del processo: conversazioni, documenti di piano, assegnazioni e revisioni possono essere sproporzionati rispetto all'incertezza residua. Il sorgente documenta questi passaggi, ma non indica quanti minuti richiederà la tua specifica modifica. Se la sessione ignora ripetutamente l'ambito concordato, il repository mette a disposizione diagnosing-superpowers per ricostruire l'accaduto sulla base delle trascrizioni. Skill per la diagnosi delle sessioni

Quali aspettative su Superpowers sono eccessive?

Seguire un processo prescritto non dimostra né la correttezza del software né un aumento della velocità. Un test che fallisce può rappresentare un requisito sbagliato, un piano può trascurare un vincolo di integrazione e un agente revisore può non accorgersi di un difetto. Valuta le asserzioni e il diff, non la sicurezza con cui viene annunciata la conclusione del lavoro.

Lavorare con i subagenti non significa nemmeno eseguire tutti i compiti di implementazione contemporaneamente. La skill attuale vieta esplicitamente di impiegare subagenti di implementazione in parallelo all'interno di quel processo, per evitare conflitti. dispatching-parallel-agents è una skill separata, pensata per problemi indipendenti. Regole per assegnare le implementazioni

L'installazione non elimina neppure la tua responsabilità sull'ambito del lavoro o sull'integrazione. La procedura di completamento del plugin lascia all'utente la decisione sul merge. La promessa più solida riguarda il metodo: indica a Claude che cosa controllare e quali evidenze presentare. L'utilità dipende dal lavoro da svolgere e dalla capacità dell'agente di seguire quelle istruzioni.

A chi conviene installarlo e da dove iniziare?

Installalo quando il problema ricorrente è che vengono saltate decisioni di sviluppo. Se lavori da solo e il tuo agente sorvola sui requisiti, comincia con una funzionalità circoscritta per la quale esista un caso di errore significativo. Controlla se la sessione definisce il comportamento prima di implementare e presenta le evidenze dopo.

In un team di sviluppo già strutturato, occorre prima armonizzare le convenzioni su piani, test e revisioni con le istruzioni del plugin. Se le skill esistenti codificano già il processo desiderato, un ulteriore processo generale potrebbe duplicarlo. Se il lavoro consiste soprattutto in interventi minimi e completamente specificati, adottare l'intero metodo solo per completarli è meno giustificato.

Lunedì scegli una modifica circoscritta e scrivine i criteri di accettazione. Usa Superpowers, esamina le skill selezionate, rivedi il diff finale e valuta se ogni documento o risultato aggiuntivo ti ha aiutato a prendere una decisione. Mantieni il processo perché i suoi controlli sono stati utili, non perché ha prodotto un piano lungo.

Per altri strumenti che risolvono problemi diversi, consulta i migliori plugin per Claude Code.

Domande frequenti su Claude Superpowers

Per consigli pratici sullo sviluppo con l'AI, iscriviti alla newsletter.