skills-janitor

Qu’est-ce que skills-janitor ?

skills-janitor est un plugin pour Claude Code qui audite, suit l’usage et compare les compétences Claude Code d’un utilisateur. Son objectif est de vous aider à organiser votre ensemble de compétences en identifiant les doublons, en vérifiant les erreurs ou informations manquantes, et en résumant quelles compétences vous invoquez réellement.

Le plugin est organisé en neuf actions ciblées, chacune exposée comme une commande slash avec autocomplétion. Il inclut aussi une fonctionnalité pour rechercher des compétences sur GitHub à installer et pour comparer une compétence avec des similaires trouvées sur GitHub.

Fonctionnalités principales

• Neuf actions d’audit exposées comme compétences/commandes individuelles : /janitor-audit, /janitor-duplicates, /janitor-check, /janitor-fix, /janitor-cleanup, /janitor-report, /janitor-usage, /janitor-search et /janitor-compare.
• Autocomplétion par compétence : chaque action est sa propre commande slash, facilitant la découverte des capacités disponibles directement dans l’interface Claude Code.
• Suivi d’usage à partir de l’historique des conversations : analyse l’historique des conversations pour montrer quelles compétences vous avez invoquées et celles jamais utilisées.
• Vérifications d’intégrité et workflows de nettoyage : inclut des commandes pour vérifier les erreurs/informations manquantes et supprimer les compétences défectueuses (opérations destructives avec aperçu préalable via dry-run).
• Détection de doublons : peut trouver des compétences dupliquées qui font effectivement la même chose.
• Découverte et comparaison de compétences sur GitHub : recherche des compétences sur GitHub par mot-clé et compare votre compétence avec des similaires sur GitHub.

Comment utiliser skills-janitor

1. Installer le plugin (l’une des méthodes documentées) :
   • Depuis le marketplace Claude Code en ajoutant khendzel/skills-janitor, ou
   • Cloner le dépôt directement dans ~/.claude/skills/skills-janitor.
2. Exécuter les commandes via la syntaxe slash. Exemples indiqués dans le projet :
   • Inventaire : /janitor-audit
   • Usage : /janitor-usage
   • Recherche : /janitor-search
   • Comparaison : /janitor-compare
   • Validation : /janitor-check
   • Correction automatique (aperçu préalable) : /janitor-fix
3. Optionnellement utiliser des mots-clés en langage naturel. Le plugin peut déclencher des compétences basées sur des mots-clés dans les descriptions de compétences (exemples : “audit my skills”, “which skills do I use?”, “search for n8n skills”, “compare my-skill against alternatives”).
4. Examiner les sorties dry-run avant les changements. Le projet indique que les opérations destructives utilisent dry-run par défaut et ne suppriment rien sans confirmation explicite.

Cas d’utilisation

• Hygiène mensuelle des compétences : générer un rapport complet de vos compétences installées et identifier celles avec problèmes, doublons ou informations manquantes via /janitor-report et /janitor-cleanup.
• Repérage des compétences inutilisées : exécuter /janitor-usage pour voir quelles compétences sont activement utilisées versus jamais invoquées, puis décider lesquelles supprimer.
• Réduction des redondances : utiliser /janitor-duplicates pour trouver des compétences qui font le même travail afin de consolider votre ensemble de compétences.
• Débogage des compétences avec détails manquants : exécuter /janitor-check pour surfacer erreurs ou informations manquantes, puis suivre avec /janitor-fix (dry-run par défaut) pour prévisualiser les changements.
• Recherche et comparaison de nouvelles compétences : rechercher des compétences sur GitHub avec /janitor-search et évaluer les alternatives avec /janitor-compare avant d’installer ou mettre à jour votre bibliothèque de compétences.

FAQ

• skills-janitor supprime-t-il jamais automatiquement des compétences ? Le projet indique explicitement qu’il ne supprime jamais rien sans confirmation explicite.

• Les opérations destructives sont-elles appliquées immédiatement ? Le dépôt indique que les opérations destructives utilisent dry-run par défaut.

• Modifie-t-il les compétences du marketplace ou fournies par des plugins ? Il indique qu’il ne modifie jamais les compétences de plugins/marketplace.

• Sur quoi repose le rapport d’usage ? Il analyse votre historique de conversations pour déterminer quelles compétences vous invoquez et lesquelles vous n’utilisez jamais.

• Que faut-il localement pour exécuter le code du plugin ? Les prérequis listés sont Bash, Python 3 et curl (le dépôt note aussi qu’il n’y a pas d’installations pip et pas de modules node).

Alternatives

• Curation manuelle des compétences dans Claude Code : maintenir vos compétences organisées en revoyant les compétences installées et en les supprimant ou mettant à jour sélectivement sans audit automatisé ; c’est plus simple mais manque d’inventaire structuré, de détection de doublons et de résumés d’usage.
• Recherche générique GitHub + comparaison de README : rechercher des compétences sur GitHub et comparer les dépôts vous-même ; cela peut servir à la découverte et à la comparaison mais ne fournit pas le suivi d’usage du plugin ni les vérifications de santé intégrées.
• Autres outils de gestion de compétences Claude Code (alternative par catégorie) : outils axés sur l’organisation, la validation ou la liste des compétences disponibles ; ils peuvent différer selon qu’ils mettent l’accent sur l’analytique d’usage, la détection de doublons ou la découverte basée sur GitHub.
• Audits scriptés avec un CLI personnalisé : créer ou utiliser des scripts locaux pour scanner votre répertoire ~/.claude/skills ; cela peut offrir de l’automatisation mais nécessite plus de configuration que le workflow par commandes slash du plugin.