Aggiungi lo script per controllare le statistiche e riordina CLAUDE.md
controlla-statistiche.py confronta stelle, fork, licenza, versione, installazioni e controlli di sicurezza delle schede con i dati attuali di GitHub e skills.sh, senza modificare nulla. CLAUDE.md documenta lo script, le convenzioni delle schede e gli argomenti Ufficio e Second brain. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
5051b50902
commit
71286cf9b8
2 files changed
+188
-2
No files matched your search
@@ -4,12 +4,13 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
|
||||
|
||||
## 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 ...`).
|
||||
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](skills/find-skills.md) è la scheda di riferimento: ogni nuova scheda deve avere lo stesso livello di dettaglio, struttura e tono.
|
||||
|
||||
@@ -44,9 +45,24 @@ Sezioni, in quest'ordine:
|
||||
|
||||
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. 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*.
|
||||
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
|
||||
|
||||
|
||||
Reference in new issue
Block a user