my-skills/CLAUDE.md

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/<nome-skill>.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 è 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.

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, 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.