# CLAUDE.md This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. ## Scopo del repository Un dizionario personale di skill per agenti AI, scritto in Markdown. Non è un progetto software: non ci sono build, lint o test; l'unico programma è `scripts/controlla-statistiche.py` (passo 4). 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/.md` è la scheda di una skill. Il nome del file è il nome della skill. - `scripts/controlla-statistiche.py` confronta le statistiche delle schede con quelle attuali (passo 4). [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///main//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///`), 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. ### Convenzioni delle schede - I numeri di diffusione portano mese e anno (`Diffusione (ottobre 2026)`) e sono arrotondati con "circa". - Dì sempre cosa non hai verificato: pagina senza controlli di sicurezza, avvisi senza spiegazione, file non letti, comandi non provati. - Per plugin e raccolte (esempi: [ecc.md](skills/ecc.md), [obsidian-wiki.md](skills/obsidian-wiki.md)) aggiungi in *Cosa fa* una tabella delle skill o degli agenti inclusi, e in *Da sapere* hook, scritture fuori dal progetto e consumo di contesto. In *Installazione* metti per primo il metodo del plugin. - Se la skill non può funzionare nelle app di chat (servono file locali, sottoagenti, hook), la sezione sulle app desktop lo dice in un avviso. ### 3. Aggiorna l'indice Aggiungi nel `README.md` la riga della skill con una descrizione di una frase: - due gruppi, *Skill singole* e *Plugin, raccolte e strumenti*; nel secondo la tabella ha anche la colonna *Tipo*; - dentro ogni gruppo, sottosezioni `###` per argomento (quelle già presenti), righe in ordine alfabetico; crea un argomento nuovo solo se nessuno calza; - *Ufficio* (documenti, fogli di calcolo, presentazioni, posta, calendario) e *Second brain* (Obsidian, LLM Wiki e simili) esistono in entrambi i gruppi anche se vuoti: la sezione vuota riporta *Ancora nessuna skill.* al posto della tabella. ### 4. Tieni aggiornate le statistiche `python3 scripts/controlla-statistiche.py [--tutto] [--soglia <%>] [scheda ...]` confronta stelle, fork, licenza, versione, installazioni e controlli di sicurezza con i dati attuali (serve `gh`) e mostra cosa aggiornare, senza modificare le schede: correggile a mano, mese della rilevazione compreso. Legge le frasi della sezione *Intestazione* (`circa N stelle`, `circa N installazioni`, `licenza X`, `versione X.Y.Z`, `Controlli di sicurezza su skills.sh`): se le cambi, controlla che lo script le legga ancora. ## Come lavorare qui - 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.