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

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