Aggiungi indice delle skill e scheda di find-skills

README.md fa da indice, skills/find-skills.md è la prima scheda e
CLAUDE.md descrive come documentare le nuove skill.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

CLAUDE.md

@@ -4,11 +4,53 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Scopo del repository
 
-Questa cartella serve a scrivere documentazione in Markdown per delle skill. Non è un progetto software: non ci sono comandi di build, lint o test.
+Un dizionario personale di skill per agenti AI, scritto in Markdown. Non è un progetto software: non ci sono comandi di build, lint o test. Le skill vengono aggiunte nel tempo, di solito con una richiesta come "aggiungi la skill X" o con un comando di installazione (`npx skills add ...`).
+
+## Struttura
+
+- `README.md` è l'indice: una tabella con una riga per skill, con il nome che rimanda alla scheda e una descrizione di una frase. Niente dettagli qui.
+- `skills/<nome-skill>.md` è la scheda di una skill. Il nome del file è il nome della skill.
+
+[skills/find-skills.md](skills/find-skills.md) è la scheda di riferimento: ogni nuova scheda deve avere lo stesso livello di dettaglio, struttura e tono.
+
+## Aggiungere una skill
+
+### 1. Raccogli le fonti
+
+Leggi sempre il testo completo della skill, non solo un riassunto:
+
+- il `SKILL.md` grezzo (`https://raw.githubusercontent.com/<owner>/<repo>/main/<percorso>/SKILL.md`), che è la fonte principale per "Cosa fa";
+- il README del repository, per comandi e opzioni di installazione;
+- la pagina su skills.sh (`https://skills.sh/<owner>/<repo>/<skill>`), se esiste, per installazioni, stelle e controlli di sicurezza;
+- le guide ufficiali di Claude e ChatGPT, se servono per l'installazione nelle app desktop.
+
+Basati solo su queste fonti. Se un dettaglio non è verificabile o una pagina non è raggiungibile, dillo nella scheda invece di inventarlo.
+
+### 2. Scrivi la scheda
+
+Sezioni, in quest'ordine:
+
+1. **Intestazione:** autore, repository, link al `SKILL.md`, pagina su skills.sh. Aggiungi installazioni e stelle con mese e anno della rilevazione, e l'esito dei controlli di sicurezza, avvisi compresi.
+2. **A cosa serve:** il problema che risolve, in poche righe.
+3. **Cosa fa**, con le sottosezioni:
+   - *Quando si attiva*: le richieste o situazioni che la fanno partire;
+   - *Come lavora*: i passi che segue l'agente, con i comandi reali ed esempi;
+   - eventuali tabelle o consigli d'uso presenti nel `SKILL.md`;
+   - *Da sapere*: requisiti (per esempio Node.js), limiti e aspetti di sicurezza (installazioni senza conferma, script eseguiti, accessi esterni).
+4. **Installazione**, per piattaforma:
+   - *Claude Code e Codex*: il comando completo, una tabella che spiega le opzioni, come verificarla o richiamarla, e i comandi per elencarla, aggiornarla e rimuoverla;
+   - *App desktop di Claude e ChatGPT*: come preparare lo ZIP e i passaggi di caricamento per ciascuna app, più un avviso se la skill non può funzionare davvero lì.
+5. **Fonti:** i link effettivamente usati.
+
+Traduci e adatta il contenuto del `SKILL.md` in italiano invece di copiarlo; lascia in originale comandi, nomi e parole chiave di ricerca.
+
+### 3. Aggiorna l'indice
+
+Aggiungi nel `README.md` la riga della skill con una descrizione di una frase.
 
 ## Come lavorare qui
 
-- Segui la richiesta dell'utente alla lettera. Struttura, formato, sezioni e stile di ogni documento li decide l'utente, richiesta per richiesta.
-- Non esistono ancora convenzioni o template: non inventarne. Se una richiesta è ambigua su qualcosa che cambia il risultato, chiedi invece di decidere tu.
-- Se l'utente definisce una convenzione valida per tutti i documenti (per esempio un template o una struttura fissa di cartelle), aggiungila a questo file così resta per le sessioni future.
-- Scrivi nella lingua che usa l'utente (di default l'italiano), salvo richiesta diversa.
+- Segui la richiesta dell'utente: se chiede una struttura o sezioni diverse per una skill, quella richiesta prevale su questo file.
+- Se l'utente chiede più informazioni su una skill già presente, completa la sua scheda seguendo la stessa struttura.
+- Se l'utente fissa una nuova convenzione valida per tutte le schede, aggiornala qui.
+- Scrivi in italiano, salvo richiesta diversa.