From 8a38f0a62a6ca2367949998d8c492804b3f87c95 Mon Sep 17 00:00:00 2001 From: Davide Grilli Date: Mon, 19 Oct 2026 09:34:46 +0200 Subject: [PATCH] Aggiungi la scheda di superpowers e riorganizza il README per tipo e argomento Co-Authored-By: Claude Sonnet 5.5 --- CLAUDE.md | 2 +- README.md | 56 +++++++++++++--- skills/superpowers.md | 144 ++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 193 insertions(+), 9 deletions(-) create mode 100644 skills/superpowers.md diff --git a/CLAUDE.md b/CLAUDE.md index f1f6178..08b495a 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -46,7 +46,7 @@ Traduci e adatta il contenuto del `SKILL.md` in italiano invece di copiarlo; las ### 3. Aggiorna l'indice -Aggiungi nel `README.md` la riga della skill con una descrizione di una frase. +Aggiungi nel `README.md` la riga della skill con una descrizione di una frase. L'indice è diviso in due gruppi, *Skill singole* e *Plugin, raccolte e strumenti*, e dentro ogni gruppo per argomento (sottosezioni `###`, righe in ordine alfabetico). Metti la skill nel gruppo e nell'argomento giusti, creando un nuovo argomento solo se nessuno calza. Nel secondo gruppo la tabella ha anche la colonna *Tipo*. ## Come lavorare qui diff --git a/README.md b/README.md index 4e58c1c..db69a63 100644 --- a/README.md +++ b/README.md @@ -2,17 +2,57 @@ Il mio dizionario delle skill per agenti AI (Claude Code, Codex, app di Claude e ChatGPT): per ognuna, una breve descrizione e un link alla scheda con cosa fa e come si installa. -## Skill +Le schede sono divise in due gruppi, e dentro ogni gruppo per argomento: + +- **Skill singole:** fanno una cosa sola e si installano da sole. +- **Plugin, raccolte e strumenti:** insiemi di più skill, cataloghi o programmi che l'agente usa insieme alla skill. + +## Skill singole + +### Sviluppo software | Skill | Descrizione | |---|---| -| [claude-plugins-official](skills/claude-plugins-official.md) | Marketplace ufficiale di Anthropic per Claude Code: catalogo di plugin con integrazioni, analisi del codice e flussi di sviluppo. | -| [diagram-design](skills/diagram-design.md) | Fa disegnare all'agente diagrammi curati (45 tipi) come file HTML con SVG, nei colori e nei font del tuo sito, e rifà quelli in draw.io, Mermaid ed Excalidraw. | -| [find-skills](skills/find-skills.md) | Permette all'agente di cercare e installare da solo altre skill con `npx skills`. | -| [graphify](skills/graphify.md) | Trasforma codice, documenti e media di un progetto in un grafo di conoscenza che l'agente interroga invece di rileggere i file. | -| [obsidian-skills](skills/obsidian-skills.md) | Raccolta ufficiale di sei skill per Obsidian: Markdown di Obsidian, Bases, Canvas, riga di comando, estrazione di pagine web e modelli. | -| [obsidian-wiki](skills/obsidian-wiki.md) | Framework di 39 skill che fa costruire all'agente un "secondo cervello": un vault Obsidian di note collegate che raccoglie documenti, sessioni e progetti e risponde con citazioni. | | [ponytail](skills/ponytail.md) | Fa scrivere all'agente il codice più semplice e breve che funziona, evitando la sovraingegnerizzazione. | -| [project-estimation](skills/project-estimation.md) | Stima durata, costi e risorse di un progetto con tecniche strutturate (PERT, bottom-up, per analogia). | | [retro](skills/retro.md) | Fa una retrospettiva su una sessione di codifica e propone come migliorare l'ambiente dell'agente (controlli automatici, standard, file di istruzioni) perché non ripeta gli stessi errori. | + +### Design e diagrammi + +| Skill | Descrizione | +|---|---| +| [diagram-design](skills/diagram-design.md) | Fa disegnare all'agente diagrammi curati (45 tipi) come file HTML con SVG, nei colori e nei font del tuo sito, e rifà quelli in draw.io, Mermaid ed Excalidraw. | | [ui-ux-pro-max](skills/ui-ux-pro-max.md) | Dà all'agente un archivio di stili, palette, font e regole di UX per progettare interfacce curate su web, mobile e desktop. | + +### Gestione dei progetti + +| Skill | Descrizione | +|---|---| +| [project-estimation](skills/project-estimation.md) | Stima durata, costi e risorse di un progetto con tecniche strutturate (PERT, bottom-up, per analogia). | + +### Ecosistema delle skill + +| Skill | Descrizione | +|---|---| +| [find-skills](skills/find-skills.md) | Permette all'agente di cercare e installare da solo altre skill con `npx skills`. | + +## Plugin, raccolte e strumenti + +### Sviluppo software + +| Nome | Tipo | Descrizione | +|---|---|---| +| [superpowers](skills/superpowers.md) | Plugin con più skill | Metodologia di sviluppo per l'agente: brainstorming, piani, test first, debug sistematico e review, con skill che si attivano da sole. | + +### Conoscenza e note + +| Nome | Tipo | Descrizione | +|---|---|---| +| [graphify](skills/graphify.md) | Skill + programma Python | Trasforma codice, documenti e media di un progetto in un grafo di conoscenza che l'agente interroga invece di rileggere i file. | +| [obsidian-skills](skills/obsidian-skills.md) | Raccolta di 6 skill | Raccolta ufficiale per Obsidian: Markdown di Obsidian, Bases, Canvas, riga di comando, estrazione di pagine web e modelli. | +| [obsidian-wiki](skills/obsidian-wiki.md) | Framework di 39 skill | Fa costruire all'agente un "secondo cervello": un vault Obsidian di note collegate che raccoglie documenti, sessioni e progetti e risponde con citazioni. | + +### Ecosistema di Claude Code + +| Nome | Tipo | Descrizione | +|---|---|---| +| [claude-plugins-official](skills/claude-plugins-official.md) | Marketplace di plugin | Marketplace ufficiale di Anthropic per Claude Code: catalogo di plugin con integrazioni, analisi del codice e flussi di sviluppo. | diff --git a/skills/superpowers.md b/skills/superpowers.md new file mode 100644 index 0000000..5b0d285 --- /dev/null +++ b/skills/superpowers.md @@ -0,0 +1,144 @@ +# superpowers + +- **Autore:** Jesse Vincent (obra) +- **Repository:** [obra/superpowers](https://github.com/obra/superpowers) +- **Sorgente:** [skills/using-superpowers/SKILL.md](https://github.com/obra/superpowers/blob/main/skills/using-superpowers/SKILL.md) (la skill che fa partire tutte le altre) +- **Pagina su skills.sh:** [obra/superpowers/using-superpowers](https://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: + +1. **brainstorming:** prima di costruire, chiarisce cosa vuoi e perché, poi ti restituisce ciò che ha capito perché tu lo corregga. +2. **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. +3. **writing-plans:** divide il lavoro in task da 2-5 minuti, con percorsi dei file, codice completo e passi di verifica. +4. **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. +5. **test-driven-development:** impone il ciclo RED-GREEN-REFACTOR. +6. **requesting-code-review:** controlla il lavoro rispetto al piano e segnala i problemi per gravità. +7. **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: + +```text +/plugin install superpowers@claude-plugins-official +``` + +oppure dal marketplace di Superpowers: + +```text +/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 è: + +```bash +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: + +```bash +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)** + +1. Attiva l'esecuzione del codice in **Settings → Capabilities**. +2. Vai in **Customize → Skills → + → Create skill → Upload a skill** e scegli lo ZIP. +3. Attiva l'interruttore della skill. + +**ChatGPT (desktop o web)** + +1. Vai in **Skills** nella barra laterale, poi **Create → Upload from your computer**, e scegli lo ZIP o la cartella. +2. Attendi l'analisi di sicurezza di ChatGPT. +3. 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. + +## Fonti + +- [README di obra/superpowers](https://github.com/obra/superpowers) +- [SKILL.md di using-superpowers](https://github.com/obra/superpowers/blob/main/skills/using-superpowers/SKILL.md) +- [using-superpowers su skills.sh](https://skills.sh/obra/superpowers/using-superpowers) +- [Use skills in Claude – Claude Help Center](https://support.claude.com/en/articles/12512180-use-skills-in-claude) +- [Skills in ChatGPT – OpenAI Help Center](https://help.openai.com/en/articles/20001066-skills-in-chatgpt)