skills-janitor

Was ist skills-janitor?

skills-janitor ist ein Plugin für Claude Code, das deine Claude Code Skills prüft, die Nutzung verfolgt und vergleicht. Es hilft dir, dein Skill-Set organisiert zu halten, indem es Duplikate identifiziert, auf Fehler oder fehlende Informationen prüft und zusammenfasst, welche Skills du tatsächlich aufrufst.

Das Plugin umfasst neun fokussierte Aktionen, die jeweils als eigener Slash-Befehl mit Autovervollständigung verfügbar sind. Es enthält zudem Funktionen zum Suchen von Skills auf GitHub zur Installation und zum Vergleichen eines Skills mit ähnlichen auf GitHub.

Wichtige Funktionen

• Neun Prüf-Aktionen als individuelle Skills/Befehle: /janitor-audit, /janitor-duplicates, /janitor-check, /janitor-fix, /janitor-cleanup, /janitor-report, /janitor-usage, /janitor-search und /janitor-compare.
• Autovervollständigung pro Skill: Jede Aktion ist ein eigener Slash-Befehl, was die Entdeckung der verfügbaren Funktionen direkt in der Claude Code UI erleichtert.
• Nutzungsverfolgung aus Gesprächshistorie: Parst die Gesprächshistorie, um zu zeigen, welche Skills du aufgerufen hast und welche nie genutzt wurden.
• Integritätsprüfungen und Aufräum-Workflows: Enthält Befehle zur Prüfung von Skills auf Fehler/fehlende Infos und zum Entfernen defekter Skills (destruktive Operationen mit Vorschau per Dry-Run).
• Duplikat-Erkennung: Findet doppelte Skills, die im Wesentlichen dasselbe tun.
• Skill-Entdeckung und -Vergleich auf GitHub: Sucht auf GitHub nach Skills per Keyword und vergleicht deinen Skill mit ähnlichen auf GitHub.

So nutzt du skills-janitor

1. Plugin installieren (eine der dokumentierten Methoden):
   • Aus dem Claude Code Marketplace durch Hinzufügen von khendzel/skills-janitor oder
   • Repository direkt klonen in ~/.claude/skills/skills-janitor.
2. Befehle per Slash-Syntax ausführen. Beispiele aus dem Projekt:
   • Inventar: /janitor-audit
   • Nutzung: /janitor-usage
   • Suche: /janitor-search
   • Vergleich: /janitor-compare
   • Validierung: /janitor-check
   • Automatische Korrektur (mit Vorschau): /janitor-fix
3. Optional Keywords in Natursprache nutzen. Das Plugin kann Skills anhand von Keywords in Skill-Beschreibungen auslösen (Beispiele: „audit my skills“, „which skills do I use?“, „search for n8n skills“, „compare my-skill against alternatives“).
4. Dry-Run-Ausgaben vor Änderungen prüfen. Das Projekt gibt an, dass destruktive Operationen standardmäßig Dry-Run verwenden und nichts ohne explizite Bestätigung löschen.

Anwendungsfälle

• Monatliche Skill-Pflege: Erstelle mit /janitor-report und /janitor-cleanup einen vollständigen Bericht deiner installierten Skills und identifiziere solche mit Problemen, Duplikaten oder fehlenden Infos.
• Unbenutzte Skills erkennen: Führe /janitor-usage aus, um aktiv genutzte von nie aufgerufenen Skills zu sehen, und entscheide, welche zu entfernen sind.
• Redundanz reduzieren: Nutze /janitor-duplicates, um Skills zu finden, die dieselbe Aufgabe erledigen, und konsolidiere dein Skill-Set.
• Skills mit fehlenden Details debuggen: Führe /janitor-check aus, um Fehler oder fehlende Infos aufzudecken, und folge mit /janitor-fix (standardmäßig Dry-Run) für eine Vorschau der Änderungen.
• Neue Skills finden und vergleichen: Suche mit /janitor-search auf GitHub nach Skills und bewertete Alternativen mit /janitor-compare, bevor du deine Skill-Bibliothek installierst oder aktualisierst.

FAQ

• Löscht skills-janitor Skills jemals automatisch? Das Projekt gibt explizit an, es löscht nie etwas ohne explizite Bestätigung.

• Werden destruktive Operationen sofort angewendet? Das Repository gibt an, dass destruktive Operationen standardmäßig Dry-Run verwenden.

• Ändert es Marketplace- oder Plugin-Skills? Es wird angegeben, es ändert nie Plugin-/Marketplace-Skills.

• Worauf stützt sich der Nutzungsbericht? Es parst deine Gesprächshistorie, um zu ermitteln, welche Skills du aufrufst und welche nie nutzt.

• Was brauche ich lokal, um den Plugin-Code auszuführen? Die Anforderungen sind Bash, Python 3 und curl (das Repository merkt an: keine pip-Installs und keine Node-Module).

Alternativen

• Manuelle Skill-Pflege in Claude Code: Skills organisiert halten, indem du installierte Skills überprüfst und selektiv entfernst oder aktualisierst, ohne automatisierte Überprüfung; das ist einfacher, bietet aber keinen strukturierten Bestand, keine Duplikatenerkennung und keine Nutzungsübersichten.
• Generische GitHub-Suche + README-Vergleich: GitHub nach Skills durchsuchen und Repositories selbst vergleichen; das eignet sich für Entdeckung und Vergleich, liefert aber keine Nutzungsverfolgung des Plugins oder integrierte Gesundheitsprüfungen.
• Andere Claude Code Skill-Management-Tools (Kategorie-Alternative): Tools, die sich auf Organisieren, Validieren oder Auflisten verfügbarer Skills konzentrieren; diese unterscheiden sich darin, ob sie Nutzungsanalysen, Duplikatenerkennung oder GitHub-basierte Entdeckung betonen.
• Skriptbasierte Überprüfungen mit eigener CLI: Lokale Skripte erstellen oder nutzen, um dein ~/.claude/skills-Verzeichnis zu scannen; das bietet Automatisierung, erfordert aber mehr Einrichtung als der Slash-Command-Workflow des Plugins.