skills-janitor

Cos'è skills-janitor?

skills-janitor è un plugin per Claude Code che esegue audit, traccia l'uso e confronta le skill di Claude Code di un utente. Il suo scopo è aiutarti a mantenere organizzato il tuo set di skill identificando duplicati, controllando errori o informazioni mancanti e riassumendo quali skill invochi realmente.

Il plugin è organizzato in nove azioni mirate, ognuna esposta come slash command con autocompletamento. Include anche funzionalità per cercare skill su GitHub da installare e per confrontare una skill con altre simili su GitHub.

Caratteristiche Principali

• Nove azioni di audit esposte come skill/comandi individuali: /janitor-audit, /janitor-duplicates, /janitor-check, /janitor-fix, /janitor-cleanup, /janitor-report, /janitor-usage, /janitor-search e /janitor-compare.
• Autocompletamento per skill: ogni azione è un proprio slash command, rendendo più facile scoprire le capacità disponibili direttamente nell'interfaccia di Claude Code.
• Tracciamento dell'uso dalla cronologia conversazioni: analizza la cronologia conversazioni per mostrare quali skill hai invocato e quali non hai mai usato.
• Controlli di integrità e workflow di pulizia: include comandi per verificare errori/info mancanti nelle skill e per rimuovere skill rotte (operazioni distruttive con anteprima dry-run).
• Rilevamento duplicati: può trovare skill duplicate che fanno sostanzialmente la stessa cosa.
• Scoperta e confronto skill su GitHub: cerca skill su GitHub per parola chiave e confronta la tua skill con altre simili su GitHub.

Come Usare skills-janitor

1. Installa il plugin (uno dei metodi documentati):
   • Dal marketplace di Claude Code aggiungendo khendzel/skills-janitor, o
   • Clona il repository direttamente in ~/.claude/skills/skills-janitor.
2. Esegui comandi via sintassi slash. Esempi mostrati nel progetto:
   • Inventario: /janitor-audit
   • Uso: /janitor-usage
   • Ricerca: /janitor-search
   • Confronto: /janitor-compare
   • Validazione: /janitor-check
   • Auto-riparazione (anteprima prima): /janitor-fix
3. Opzionalmente usa parole chiave in linguaggio naturale. Il plugin può attivare skill basate su parole chiave nelle descrizioni (esempi includono “audit my skills”, “which skills do I use?”, “search for n8n skills” e “compare my-skill against alternatives”).
4. Rivedi output dry-run prima dei cambiamenti. Il progetto specifica che le operazioni distruttive usano dry-run di default e non cancellerà nulla senza conferma esplicita.

Casi d'Uso

• Igiene mensile delle skill: genera un report completo delle tue skill installate e identifica quelle con problemi, duplicati o info mancanti usando /janitor-report e /janitor-cleanup.
• Individuare skill inutilizzate: esegui /janitor-usage per vedere quali skill usi attivamente e quali non hai mai invocato, poi decidi quali rimuovere.
• Ridurre ridondanze: usa /janitor-duplicates per trovare skill che svolgono lo stesso compito e consolidare il tuo set di skill.
• Debug skill con dettagli mancanti: esegui /janitor-check per evidenziare errori o info mancanti, poi segui con /janitor-fix (dry-run di default) per anteprima cambiamenti.
• Trovare e confrontare nuove skill: cerca skill su GitHub con /janitor-search e valuta alternative con /janitor-compare prima di installare o aggiornare la tua libreria di skill.

FAQ

• skills-janitor cancella mai skill automaticamente? Il progetto specifica esplicitamente che non cancellerà mai nulla senza conferma esplicita.

• Le operazioni distruttive vengono applicate immediatamente? Il repository specifica che le operazioni distruttive usano dry-run di default.

• Modifica skill del marketplace o fornite da plugin? Specifica che non modificherà mai skill di plugin/marketplace.

• Su cosa si basa il report di uso? Analizza la tua cronologia conversazioni per determinare quali skill invochi e quali non usi.

• Cosa serve localmente per eseguire il codice del plugin? I requisiti elencati sono Bash, Python 3 e curl (il repository nota anche nessun pip install e nessun node module).

Alternative

• Cura manuale delle skill in Claude Code: mantenere organizzate le tue skill rivedendo quelle installate e rimuovendole o aggiornandole selettivamente senza audit automatizzato; è più semplice ma manca di inventario strutturato, rilevamento duplicati e riassunti d’uso.
• Ricerca generica su GitHub + confronto README: cercare skill su GitHub e confrontare i repository manualmente; può funzionare per scoperta e confronto ma non offre il tracciamento d’uso del plugin né i controlli di integrità integrati.
• Altri tool di gestione skill per Claude Code (alternativa di categoria): tool focalizzati su organizzazione, validazione o elenco delle skill disponibili; possono differire nell’enfasi su analisi d’uso, rilevamento duplicati o scoperta supportata da GitHub.
• Audit scriptati con CLI personalizzato: creare o usare script locali per scansionare la directory ~/.claude/skills; offre automazione ma richiede più configurazione rispetto al workflow slash-command del plugin.