8.7 KiB
superpowers
- Autore: Jesse Vincent (obra)
- Repository: obra/superpowers
- Sorgente: skills/using-superpowers/SKILL.md (la skill che fa partire tutte le altre)
- Pagina su skills.sh: obra/superpowers/using-superpowers
- Diffusione (ottobre 2026): circa 266.000 installazioni di using-superpowers su skills.sh; il repository ha circa 301.600 stelle su GitHub
- Controlli di sicurezza su skills.sh: Socket e Snyk superati; Gen Agent Trust Hub segnala un avviso (la pagina non spiega il motivo)
- Licenza: MIT
A cosa serve
Dà all'agente un metodo di sviluppo software completo, invece di lasciarlo scrivere codice a tentativi. È una raccolta di skill componibili (brainstorming, piani, test, debug, review) più una skill iniziale che obbliga l'agente a usarle. Il flusso di lavoro è obbligatorio, non un suggerimento.
Cosa fa
Quando si attiva
Le skill partono da sole. using-superpowers va caricata all'inizio di ogni conversazione e impone di controllare le skill prima di qualsiasi risposta o azione, anche prima di una domanda di chiarimento. Poi, per esempio:
- chiedi di costruire qualcosa: parte
brainstorming; - segnali un bug: parte
systematic-debugging; - chiedi di implementare una funzione: si lavora con
test-driven-development.
Se l'agente è avviato come subagent per un compito preciso, ignora using-superpowers.
Come lavora
Il flusso di base, secondo il README:
- brainstorming: prima di costruire, chiarisce cosa vuoi e perché, poi ti restituisce ciò che ha capito perché tu lo corregga.
- using-git-worktrees: dopo l'approvazione del design crea uno spazio di lavoro isolato su un nuovo branch e verifica che i test di partenza passino.
- writing-plans: divide il lavoro in task da 2-5 minuti, con percorsi dei file, codice completo e passi di verifica.
- subagent-driven-development o executing-plans: esegue il piano, con un subagent per task e una review dopo ciascuno, oppure direttamente con un'unica review finale.
- test-driven-development: impone il ciclo RED-GREEN-REFACTOR.
- requesting-code-review: controlla il lavoro rispetto al piano e segnala i problemi per gravità.
- finishing-a-development-branch: verifica i test, propone le opzioni (merge, PR, tenere, scartare) e pulisce il worktree.
Regole di using-superpowers:
- se una skill è pertinente, l'agente la invoca, annuncia che la usa e la segue alla lettera; se ha una checklist, crea un todo per ogni voce;
- le skill di processo (brainstorming, systematic-debugging) hanno la precedenza su quelle di implementazione (come frontend-design): prima si decide l'approccio, poi si esegue;
- una tabella di "red flags" elenca le scuse con cui l'agente tenderebbe a saltare le skill ("è solo una domanda semplice", "conosco già quella skill", "è eccessivo") e le smentisce;
- le tue istruzioni (CLAUDE.md, AGENTS.md, GEMINI.md, richieste dirette) prevalgono sulle skill, e le skill sulle abitudini predefinite dell'agente. Le skill si saltano solo se lo dici esplicitamente.
Skill incluse
| Gruppo | Skill |
|---|---|
| Testing | test-driven-development |
| Debug | systematic-debugging, verification-before-completion, diagnosing-superpowers |
| Collaborazione | brainstorming, writing-plans, executing-plans, dispatching-parallel-agents, requesting-code-review, receiving-code-review, using-git-worktrees, finishing-a-development-branch, subagent-driven-development |
| Meta | writing-skills, using-superpowers |
L'elenco viene dalla pagina GitHub del repository.
Filosofia
- test sempre scritti prima del codice;
- metodo sistematico invece di tentativi a caso;
- la semplicità come obiettivo principale;
- prove invece di affermazioni: verificare prima di dichiarare che qualcosa funziona.
Da sapere
- Non è una skill singola ma una metodologia: va installata come plugin (o come insieme di skill) e funziona al meglio negli agenti che lavorano in locale e sanno lanciare subagent e creare worktree git.
- Il README non indica requisiti tecnici (versioni, dipendenze); chiede solo una delle piattaforme supportate e, per alcune, il riavvio delle sessioni dopo l'installazione.
- Se usi più piattaforme, va installato separatamente su ciascuna.
- Su Muse gli hook richiedono un'approvazione alla prima installazione; su Grok Build CLI il comando di installazione usa
--trust. In generale un plugin può portare hook e script: controlla la fonte prima di installare. - L'avviso di Gen Agent Trust Hub su skills.sh non è spiegato: non so a cosa si riferisca.
Installazione
Claude Code e Codex
Claude Code, dal marketplace ufficiale:
/plugin install superpowers@claude-plugins-official
oppure dal marketplace di Superpowers:
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
| Comando | Significato |
|---|---|
/plugin install superpowers@claude-plugins-official |
installa il plugin dal marketplace ufficiale di Anthropic |
/plugin marketplace add obra/superpowers-marketplace |
aggiunge il marketplace dell'autore |
/plugin install superpowers@superpowers-marketplace |
installa il plugin da quel marketplace |
Codex App: apri Plugins nella barra laterale, trova Superpowers nella sezione Coding, clicca + e segui le istruzioni.
Codex CLI: apri /plugins, cerca superpowers e scegli Install Plugin.
Dopo l'installazione riavvia la sessione. Non serve richiamare le skill a mano: using-superpowers le attiva da sola quando la richiesta è pertinente.
Gestione: il README dice che gli aggiornamenti dipendono dalla piattaforma e spesso sono automatici, ma non dà comandi per Claude Code e Codex. Per elencare, aggiornare o rimuovere il plugin usa il gestore dei plugin dell'agente (/plugin in Claude Code, /plugins in Codex); i comandi esatti non li ho verificati.
Altre installazioni: su skills.sh il comando per la sola skill iniziale è:
npx skills add https://github.com/obra/superpowers --skill using-superpowers
Installa però solo using-superpowers, non le altre skill: per l'intero insieme usa i plugin qui sopra. Il README elenca anche comandi per altri agenti, per esempio gemini extensions install https://github.com/obra/superpowers (Gemini CLI), /add-plugin superpowers (Cursor), copilot plugin marketplace add obra/superpowers-marketplace seguito da copilot plugin install superpowers@superpowers-marketplace (GitHub Copilot CLI), devin plugins install obra/superpowers (Devin CLI), pi install git:github.com/obra/superpowers (Pi). Nel README trovi anche Antigravity, Factory Droid, Grok Build CLI, Kimi Code, OpenCode, Qwen Code, Hermes Agent e Muse.
App desktop di Claude e ChatGPT
Queste app caricano una skill alla volta come ZIP; il plugin completo non si può installare. Per provare almeno la skill iniziale:
git clone --depth 1 https://github.com/obra/superpowers.git
cd superpowers/skills && zip -r ~/using-superpowers.zip using-superpowers
Lo ZIP deve contenere la cartella using-superpowers/ con dentro SKILL.md. Se vuoi anche le altre, crea uno ZIP per ciascuna (per esempio brainstorming) e caricale una per una.
Claude (desktop o web)
- Attiva l'esecuzione del codice in Settings → Capabilities.
- Vai in Customize → Skills → + → Create skill → Upload a skill e scegli lo ZIP.
- Attiva l'interruttore della skill.
ChatGPT (desktop o web)
- Vai in Skills nella barra laterale, poi Create → Upload from your computer, e scegli lo ZIP o la cartella.
- Attendi l'analisi di sicurezza di ChatGPT.
- Richiamala con
@nella chat.
Le skill personali caricate su desktop e web non si sincronizzano: vanno caricate su ciascuna.
Limite: Superpowers è pensato per agenti che lavorano su un progetto locale, con worktree git, subagent e test da eseguire. Nelle app di chat queste cose mancano: la skill può al massimo guidare la conversazione (brainstorming, piani), ma non il flusso completo. Non ho verificato come reagiscono le app a una skill che rimanda ad altre skill non caricate.