Compare commits
2
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
38b1d95ceb | ||
|
|
05582b3c74 |
No files matched your search
@@ -7,10 +7,12 @@ Il mio dizionario delle skill per agenti AI (Claude Code, Codex, app di Claude e
|
||||
| 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. |
|
||||
| [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. |
|
||||
@@ -0,0 +1,152 @@
|
||||
# diagram-design
|
||||
|
||||
- **Autore:** Cathryn Lavery (LittleMight)
|
||||
- **Repository:** [cathrynlavery/diagram-design](https://github.com/cathrynlavery/diagram-design) (licenza MIT)
|
||||
- **Sorgente:** [skills/diagram-design/SKILL.md](https://github.com/cathrynlavery/diagram-design/blob/main/skills/diagram-design/SKILL.md) (versione 2.6)
|
||||
- **Sito e galleria:** [diagramdesign.dev](https://diagramdesign.dev) · [galleria dei diagrammi](https://cathrynlavery.github.io/diagram-design/)
|
||||
- **Pagina su skills.sh:** [cathrynlavery/diagram-design/diagram-design](https://skills.sh/cathrynlavery/diagram-design/diagram-design)
|
||||
- **Diffusione (ottobre 2026):** circa 14.300 installazioni; il repository ha circa 56.800 stelle su GitHub
|
||||
- **Controlli di sicurezza su skills.sh:** Gen Agent Trust Hub, Socket e Snyk superati, senza avvisi
|
||||
|
||||
## A cosa serve
|
||||
|
||||
Fa disegnare all'agente diagrammi curati nello stile della tua grafica, invece dei soliti riquadri arrotondati generici. Ogni diagramma è un unico file HTML con SVG incorporato, che si apre con un doppio clic. Lo stile è editoriale e prevede un solo colore d'accento per uno o due elementi chiave, linee sottili, nessuna ombra e coordinate su una griglia di 4 pixel. Può prendere colori e font dal tuo sito e rifare in questo stile anche diagrammi già esistenti in draw.io, Mermaid ed Excalidraw.
|
||||
|
||||
## Cosa fa
|
||||
|
||||
### Quando si attiva
|
||||
|
||||
Quando chiedi un diagramma a parole, per esempio:
|
||||
|
||||
- "Fammi un diagramma di architettura della mia app: frontend, backend, database, cache Redis";
|
||||
- "Mi serve un quadrante con i progetti del secondo trimestre per impatto e sforzo";
|
||||
- "Dammi una sequenza di una chiamata con bearer token e refresh su 401";
|
||||
- "Onboard diagram-design to https://tuosito.com" (per prendere palette e font del sito);
|
||||
- "Redraw this drawio file for my deck" (rifare un diagramma esistente), oppure l'esportazione di un diagramma in PNG o SVG.
|
||||
|
||||
Il `SKILL.md` elenca 45 tipi di visual (il README dice 45; la descrizione del repository su GitHub dice 44). Tra i principali: architettura, flowchart, sequence, macchina a stati, ER, timeline, swimlane, quadrante, radar, ciclo, albero, organigramma, Venn, piramide/funnel, grafici (barre, linee, scatter, treemap, heatmap, waterfall), Gantt, Sankey, Wardley map, kanban, user journey, UML a classi, schema di database.
|
||||
|
||||
### Come lavora
|
||||
|
||||
1. **Controlla lo stile (primo uso in un progetto).** Se lo style guide è ancora quello predefinito, si ferma e ti chiede se personalizzarlo: da URL di un sito, da una skill installata, da una cartella locale o design system, incollando i token a mano, tenendo il predefinito, o caricando un profilo salvato.
|
||||
2. **Sceglie il tipo.** Se conta il comportamento (code, colli di bottiglia, confini di fiducia, difese a strati), sceglie prima uno dei nove *semantic pattern* e poi il tipo di diagramma più vicino per il layout. Per un caso normale carica il `SKILL.md` e il riferimento di quel solo tipo.
|
||||
3. **Dichiara il piano prima di disegnare:** tipo, formato, dimensione e cosa verrà tagliato per stare nei limiti. Salta la pausa solo se la richiesta specifica già tutto.
|
||||
4. **Disegna** rispettando i limiti di complessità (al massimo 9 nodi, 12 frecce, 2 elementi con l'accento, 2 note), altrimenti propone di dividere in due diagrammi, e le sei regole obbligatorie sui connettori (solo angoli retti, spazio tra etichetta e linea, niente sovrapposizioni, punti di attacco distinti, nessun passaggio dietro a un riquadro, maschere prima dei nodi).
|
||||
5. **Controlla il risultato** con una lista di verifica e con `python3 scripts/self_check.py <file>`, che controlla accessibilità dell'SVG, file autonomo e contenuto dentro il `viewBox`.
|
||||
6. **Produce un unico file `.html`:** CSS incorporato, SVG in linea, nessuna immagine esterna. Ogni SVG ha `role="img"`, `<title>` e `<desc>`.
|
||||
|
||||
Il principio di fondo è che la mossa migliore è di solito togliere: se una tabella o un paragrafo spiegano la stessa cosa, la skill suggerisce di non disegnare.
|
||||
|
||||
### Personalizzare lo stile (onboarding)
|
||||
|
||||
Senza personalizzazione i diagrammi escono in nero e arancio ("tangerine"). Con *"onboard diagram-design to https://tuosito.com"* l'agente legge la home, ricava i colori e i font, li assegna ai ruoli (`paper`, `ink`, `muted`, `accent`, `link`, font del titolo, dei nodi e dei sottotitoli), ti mostra le differenze e, dopo la tua conferma, scrive i valori in `references/style-guide.md`. Controlla anche il contrasto WCAG AA e, se non basta, propone un valore corretto.
|
||||
|
||||
| Rilevato dal sito | Diventa |
|
||||
|---|---|
|
||||
| sfondo di `<body>` | `paper` |
|
||||
| colore del testo principale | `ink` |
|
||||
| testo secondario | `muted` |
|
||||
| card o contenitori | `paper-2` |
|
||||
| colore del marchio più usato | `accent` |
|
||||
| font di `<h1>` / `<body>` / `<code>` | font del titolo / dei nodi / dei sottotitoli |
|
||||
|
||||
Per più clienti puoi salvare un **profilo** con nome (in `~/.diagram-design/profiles/`) e aggiungere a ogni progetto un file `.diagram-design` con `profile: <nome>`.
|
||||
|
||||
### Importare ed esportare
|
||||
|
||||
- **Import:** rifà (non converte) file `.drawio`, `.mmd`/`.mermaid` o blocchi Mermaid nel Markdown, e `.excalidraw`. Tiene i contenuti (componenti, relazioni, raggruppamenti, direzione) e scarta coordinate, colori e font della sorgente. Si regola con quattro opzioni: formato (`html`, `svg`, `png`, `html+png`), dimensione (`doc-inline`, `slide-16x9`, `social-og`, `print-a4-landscape`, `fit` e altre), livello di dettaglio (`faithful` fino a 24 nodi, `balanced` fino a 12, `simplified` fino a 7) e destinatari (`engineer`, `mixed`, `executive`, che cambiano le parole e non il numero di nodi). Alla fine riporta un elenco di cosa è stato unito, ridotto o scartato.
|
||||
- **Export:** su richiesta, salva il solo diagramma come SVG o PNG (`scripts/export_svg.py`, `scripts/export_png.py`). L'export non parte mai da solo. Il PNG usa Playwright (`pip install playwright && playwright install chromium`).
|
||||
- **Animazione (facoltativa):** modalità `none` (predefinita), `reveal`, `step`, `loop`, con il fotogramma statico sempre completo e controlli nascosti se il sistema chiede meno movimento.
|
||||
|
||||
### Da sapere
|
||||
|
||||
- **Rete:** per impostazione predefinita ogni diagramma carica i font Instrument Serif, Geist e Geist Mono da Google Fonts, che è l'unica richiesta di rete. Chiedendo "system fonts" il file non fa alcuna richiesta. L'onboarding da sito fa scaricare all'agente alcune pagine di quel sito, e solo se lo chiedi. Secondo PRIVACY.md non ci sono server, account né telemetria.
|
||||
- **Script eseguiti:** richiede Python 3 per `self_check.py` e per gli estrattori degli import (`drawio_extract.py`, `mermaid_extract.py`, `excalidraw_extract.py`). Il PNG richiede anche Playwright con Chromium. Il README e il `SKILL.md` descrivono gli script come locali; i file importati vanno trattati come dati non fidati, e la skill lo prevede.
|
||||
- **Limiti dichiarati nel README:** la qualità dipende dal modello e lo stesso prompt può dare layout diversi; il risultato non è un formato sorgente modificabile (niente testo da confrontare in una pull request né canvas da trascinare). Per documenti in Git che cambiano a ogni sprint, il README consiglia Mermaid. Non va usata per elenchi, confronti di soli attributi o diagrammi con una sola forma.
|
||||
- **Comandi in più solo con il plugin:** `/diagram-design:export-diagram`, `import-drawio`, `import-mermaid`, `import-excalidraw`, `profile` e `doctor` (in Pi senza prefisso). Con `npx skills` si installa solo la skill, senza questi comandi; si può chiedere tutto anche a parole.
|
||||
- **Fonte ufficiale:** il README avverte che le versioni ufficiali vengono solo da questo repository; elenchi con altro nome sono copie non ufficiali.
|
||||
|
||||
## Installazione
|
||||
|
||||
Il README raccomanda il marketplace quando l'agente ne ha uno, perché dà aggiornamenti e comandi; `npx skills` installa solo la skill. Non usarli entrambi sullo stesso agente.
|
||||
|
||||
### Claude Code
|
||||
|
||||
Nella sessione, come due messaggi separati:
|
||||
|
||||
```text
|
||||
/plugin marketplace add cathrynlavery/diagram-design
|
||||
/plugin install diagram-design@diagram-design
|
||||
```
|
||||
|
||||
Per gli aggiornamenti automatici: `/plugin` → **Marketplaces** → **diagram-design** → **Enable auto-update** (per i marketplace di terze parti è disattivato di default); poi `/reload-plugins` quando richiesto.
|
||||
|
||||
### Codex
|
||||
|
||||
```bash
|
||||
codex plugin marketplace add cathrynlavery/diagram-design
|
||||
codex plugin add diagram-design@diagram-design
|
||||
```
|
||||
|
||||
Si aggiorna all'avvio; per forzarlo: `codex plugin marketplace upgrade diagram-design` e una nuova sessione.
|
||||
|
||||
### Claude Code e Codex (solo la skill)
|
||||
|
||||
```bash
|
||||
npx skills add cathrynlavery/diagram-design -g -a claude-code -a codex
|
||||
```
|
||||
|
||||
| Opzione | Significato |
|
||||
|---|---|
|
||||
| `-g` | installazione globale (`~/.claude/skills/`, `~/.codex/skills/`); senza, solo nel progetto corrente |
|
||||
| `-a <agente>` | agente di destinazione, ripetibile |
|
||||
| `--copy` | copie indipendenti invece dei collegamenti simbolici (con più agenti il programma chiede il metodo e consiglia i collegamenti) |
|
||||
| `-y` | salta le domande di conferma |
|
||||
|
||||
Il comando installa l'intera cartella della skill (`references/`, `assets/`, `scripts/`). Dopo l'installazione riavvia la sessione. Si può richiamare chiedendo un diagramma a parole; Claude Code la usa da solo quando la richiesta è pertinente.
|
||||
|
||||
Gestione:
|
||||
|
||||
```bash
|
||||
npx skills list -g # skill installate
|
||||
npx skills update diagram-design # aggiornamento
|
||||
npx skills remove diagram-design # rimozione
|
||||
```
|
||||
|
||||
Per il plugin usa i comandi `plugin` del rispettivo agente. Il README segnala che un'installazione con `npx skills` esistente non passa da sola al marketplace: va rimossa prima di reinstallare con il plugin.
|
||||
|
||||
### App desktop di Claude e ChatGPT
|
||||
|
||||
Il README non documenta il caricamento come ZIP nelle app desktop di Claude e ChatGPT (PRIVACY.md cita ChatGPT tra gli agenti in cui la skill può essere installata, senza istruzioni). Si può provare con lo ZIP della sola cartella della skill:
|
||||
|
||||
```bash
|
||||
git clone --depth 1 https://github.com/cathrynlavery/diagram-design.git
|
||||
cd diagram-design/skills && zip -r ~/diagram-design.zip diagram-design
|
||||
```
|
||||
|
||||
Lo ZIP deve contenere la cartella `diagram-design/` con dentro `SKILL.md`, `references/`, `assets/` e `scripts/`.
|
||||
|
||||
**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:** la skill è pensata per agenti che lavorano su file locali. Nelle app di chat non ho verificato se la dimensione dello ZIP, gli script Python, il controllo con `self_check.py` e l'export PNG (che richiede Playwright) funzionino, e probabilmente l'onboarding da un sito e il profilo salvato in `~/.diagram-design/` non sono utilizzabili. Il disegno vero e proprio dei diagrammi in HTML dovrebbe restare possibile.
|
||||
|
||||
## Fonti
|
||||
|
||||
- [README di cathrynlavery/diagram-design](https://github.com/cathrynlavery/diagram-design)
|
||||
- [SKILL.md di diagram-design](https://github.com/cathrynlavery/diagram-design/blob/main/skills/diagram-design/SKILL.md)
|
||||
- [PRIVACY.md di diagram-design](https://github.com/cathrynlavery/diagram-design/blob/main/PRIVACY.md)
|
||||
- [diagram-design su skills.sh](https://skills.sh/cathrynlavery/diagram-design/diagram-design)
|
||||
- [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)
|
||||
+136
@@ -0,0 +1,136 @@
|
||||
# retro
|
||||
|
||||
- **Autore:** Matt Pocock
|
||||
- **Repository:** [mattpocock/skills](https://github.com/mattpocock/skills) (licenza MIT)
|
||||
- **Sorgente:** [skills/engineering/retro/SKILL.md](https://github.com/mattpocock/skills/blob/main/skills/engineering/retro/SKILL.md)
|
||||
- **Documentazione della skill:** [docs/engineering/retro.md](https://github.com/mattpocock/skills/blob/main/docs/engineering/retro.md)
|
||||
- **Pagina su skills.sh:** [mattpocock/skills/retro](https://skills.sh/mattpocock/skills/retro)
|
||||
- **Diffusione (ottobre 2026):** circa 242.000 installazioni; il repository ha circa 294.700 stelle su GitHub
|
||||
- **Controlli di sicurezza su skills.sh:** Gen Agent Trust Hub, Socket e Snyk superati, senza avvisi
|
||||
|
||||
## A cosa serve
|
||||
|
||||
Fa una retrospettiva su una sessione di lavoro con l'agente e propone come migliorare l'**ambiente** in cui l'agente lavora, così la volta dopo va meglio. Non corregge il codice: parte da un momento in cui l'agente ha faticato (un file trovato dopo venti chiamate, un errore che un controllo automatico avrebbe fermato, una regola che il revisore ha lasciato passare) e chiede cosa, nel repository, l'ha permesso. La risposta è un elenco di modifiche candidate, dalla più grave alla meno grave.
|
||||
|
||||
## Cosa fa
|
||||
|
||||
### Quando si attiva
|
||||
|
||||
Solo quando la richiami tu con `/retro`: nel `SKILL.md` c'è `disable-model-invocation: true`, e anche `agents/openai.yaml` imposta `allow_implicit_invocation: false`, quindi l'agente non la usa da solo.
|
||||
|
||||
Ha senso a fine di una sessione più difficile del dovuto: l'agente ha cercato a lungo qualcosa, ha fatto un errore che uno strumento avrebbe intercettato, o gli mancava un'informazione. Dopo una sessione liscia c'è poco da imparare. Se vuoi un giudizio sul codice prodotto, serve invece la skill `code-review` dello stesso repository.
|
||||
|
||||
### Come lavora
|
||||
|
||||
1. **Carica la guida di stile.** Richiama la skill `writing-for-agents` del repository, che spiega come scrivere file di istruzioni per gli agenti.
|
||||
2. **Legge le fonti primarie della sessione** che indichi, cercando se serve nei log delle sessioni sulla macchina. Se non ne indichi una, usa la sessione corrente.
|
||||
3. **Cerca candidati di miglioramento** in sette categorie (tabella sotto). Prima di proporre un controllo legge quello che il repository ha già (gli script `lint`/`check` di `package.json`, il workflow di CI): un controllo esistente ma scollegato o rotto è il risultato, non una reinvenzione.
|
||||
4. **Te li presenta in ordine di gravità.** Propone soltanto: non modifica niente finché non scegli un candidato.
|
||||
|
||||
| Categoria | Cosa guarda | Si usa quando |
|
||||
|---|---|---|
|
||||
| Navigation | quanto è stato facile trovare i file giusti; dipendenze nascoste; un *navigation pointer* (rimando da un file che l'agente legge già) | la sessione ha impiegato molto a trovare un'informazione |
|
||||
| Automated checks | lint, tipi, test, controlli sul filesystem; un repository senza alcuna protezione (né pre-commit hook né job di CI con lint/typecheck/test) è già un risultato | l'agente ha sbagliato in un modo che un controllo automatico avrebbe intercettato |
|
||||
| Coding standards | una nuova regola per l'agente revisore, o chiarirne/toglierne una esistente | il revisore non ha notato un errore |
|
||||
| Global AGENTS.md | istruzioni da spostare negli standard o in un controllo | `AGENTS.md` è molto lungo, nel repository o a livello globale |
|
||||
| Tool economy | chiamate costose da snellire; strumenti (CLI, MCP) che consumano troppi token | l'agente ha fatto una chiamata costosa |
|
||||
| No-ops | righe nei file di istruzioni che non cambiano il comportamento | i file di istruzioni sono grandi e ingombranti |
|
||||
| Information access | più accesso alle informazioni: log del server di sviluppo scritti su file, accesso in sola lettura a servizi esterni | all'agente mancava un'informazione fondamentale |
|
||||
|
||||
### Idee guida (sezione "Reference" del SKILL.md)
|
||||
|
||||
- **Standard al revisore, non a chi implementa.** L'agente che implementa ha la maggiore pressione sul contesto (esplora, scrive, corregge); il revisore riceve solo un diff, quindi ha spazio per applicare gli standard.
|
||||
- **Prima si classifica la violazione.** Una violazione *meccanica* (schema sintattico fisso, API vietata, forma di un import, regola sulla posizione dei file) merita un controllo deterministico: una regola del linter, un pre-commit hook o un job di CI. `CODING_STANDARDS.md` è riservato ai veri giudizi (coerenza tra file, "in linea con lo stile circostante").
|
||||
- **Dove va cosa.** `CLAUDE.md`/`AGENTS.md` finiscono nel contesto di ogni agente, quindi si usano pochissimo, di solito solo per i navigation pointer. `CODING_STANDARDS.md` si legge in fase di revisione (oltre le 1.000 righe conviene rimandare a una cartella di documenti). I documenti sono riferimenti richiamati dagli altri file. Le skill servono per i documenti la cui descrizione deve stare nel contesto, o per i comandi lanciati dall'utente.
|
||||
|
||||
### Da sapere
|
||||
|
||||
- **Propone, non esegue.** Non scrive regole né installa hook da sola; non c'è una modalità di prova. Un controllo proposto è codice come un altro: provalo sul repository prima di lasciare che blocchi i merge.
|
||||
- **Limiti dichiarati nella documentazione:** giudica sulla sola sessione letta, quindi può dare troppo peso a ciò di cui parlava quella sessione, e non verifica i controlli proposti in passato (potare le regole che scattano troppo spesso resta compito tuo). Scarta ogni candidato che non riesci a collegare a un momento preciso della sessione.
|
||||
- **Non è un sistema di memoria:** non ricorda cosa è successo, cambia l'ambiente perché l'errore non si ripeta.
|
||||
- **Dipende da `writing-for-agents`,** che vive nello stesso repository (`skills/productivity/writing-for-agents`). Installando solo `retro` quella skill manca; cosa faccia `retro` in quel caso non è documentato.
|
||||
- **Legge i log delle tue sessioni:** può cercare nei file di sessione sulla macchina, quindi accede a conversazioni che possono contenere dati riservati.
|
||||
- Nella catena di lavoro del repository è l'ultimo passo: `grill-with-docs → to-spec → to-tickets → implement → code-review → retro`. Non serve eseguire l'intera catena per usarla.
|
||||
|
||||
## Installazione
|
||||
|
||||
Il README del repository raccomanda **un solo metodo per agente**: installare sia il plugin sia le skill singole darebbe ogni skill due volte. Il plugin e `npx skills add mattpocock/skills` portano tutte le skill del repository; per averne solo alcune, vedi il comando con `--skill` più sotto.
|
||||
|
||||
### Claude Code
|
||||
|
||||
```bash
|
||||
claude plugin install mattpocock-skills@claude-plugins-official
|
||||
```
|
||||
|
||||
Il plugin si aggiorna da solo. Poi riavvia la sessione e scrivi `/retro`.
|
||||
|
||||
### Codex
|
||||
|
||||
```bash
|
||||
codex plugin marketplace add mattpocock/skills
|
||||
codex plugin add mattpocock-skills@mattpocock
|
||||
```
|
||||
|
||||
Si aggiorna da solo all'avvio.
|
||||
|
||||
### Claude Code e Codex (solo le skill che servono)
|
||||
|
||||
```bash
|
||||
npx skills add mattpocock/skills --skill retro --skill writing-for-agents -g -a claude-code -a codex
|
||||
```
|
||||
|
||||
| Opzione | Significato |
|
||||
|---|---|
|
||||
| `--skill retro --skill writing-for-agents` | installa `retro` e la guida di stile che richiama al primo passo |
|
||||
| `-g` | installazione globale (`~/.claude/skills/`, `~/.codex/skills/`); senza, solo nel progetto corrente |
|
||||
| `-a <agente>` | agente di destinazione, ripetibile |
|
||||
| `-y` | salta le domande di conferma |
|
||||
|
||||
Con questo metodo gli aggiornamenti sono manuali. Il README consiglia anche di includere `setup-matt-pocock-skills` e di lanciare `/setup-matt-pocock-skills` una volta per repository (chiede quale issue tracker usi, quali etichette applichi ai ticket e dove salvare i documenti); è pensata per le altre skill della raccolta e il README non dice che `retro` ne abbia bisogno.
|
||||
|
||||
Gestione:
|
||||
|
||||
```bash
|
||||
npx skills list -g # skill installate
|
||||
npx skills update retro # aggiornamento (oppure: npx skills@latest update)
|
||||
npx skills remove retro writing-for-agents # rimozione
|
||||
```
|
||||
|
||||
Per il plugin, la rimozione e l'elenco usano i comandi `plugin` del rispettivo agente (non indicati nel README del repository).
|
||||
|
||||
### App desktop di Claude e ChatGPT
|
||||
|
||||
Queste app richiedono di caricare la skill come ZIP. Preparalo così:
|
||||
|
||||
```bash
|
||||
git clone --depth 1 https://github.com/mattpocock/skills.git
|
||||
cd skills/skills && zip -r ~/retro.zip engineering/retro productivity/writing-for-agents
|
||||
```
|
||||
|
||||
Lo ZIP deve contenere cartelle con dentro `SKILL.md`; carica `retro` e `writing-for-agents` come due skill separate (se l'app accetta una sola cartella per ZIP, fai due ZIP, uno per cartella).
|
||||
|
||||
**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:** `retro` serve a rivedere sessioni di codifica e ad agire sull'ambiente di un repository (log delle sessioni, `CLAUDE.md`, CI). Nelle app di chat non ha accesso al tuo repository né ai log, quindi può al più analizzare ciò che le incolli. Il README non documenta l'uso nelle app desktop, e non ho verificato come gestiscano le impostazioni di invocazione manuale del `SKILL.md`.
|
||||
|
||||
## Fonti
|
||||
|
||||
- [README di mattpocock/skills](https://github.com/mattpocock/skills)
|
||||
- [SKILL.md di retro](https://github.com/mattpocock/skills/blob/main/skills/engineering/retro/SKILL.md)
|
||||
- [Documentazione di retro](https://github.com/mattpocock/skills/blob/main/docs/engineering/retro.md)
|
||||
- [agents/openai.yaml di retro](https://github.com/mattpocock/skills/blob/main/skills/engineering/retro/agents/openai.yaml)
|
||||
- [retro su skills.sh](https://skills.sh/mattpocock/skills/retro)
|
||||
- [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)
|
||||
Reference in new issue
Block a user