davide/my-skills
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Aggiungi la scheda di superpowers e riorganizza il README per tipo e argomento

Browse Source 
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
davideandClaude Sonnet 5.5 committed 2026-10-19 09:34:46 +02:00
1 parent 38b1d95ceb
commit 8a38f0a62a
3 files changed
+193 -9
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

CLAUDE.md
+1 -1
View File
@@ -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
README.md
+48 -8
View File
@@ -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. |
skills/superpowers.md
+144
View File
@@ -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)