Skills Janitor

Skills Janitor: Kompleksowe narzędzie do zarządzania umiejętnościami Claude Code

W świecie automatyzacji i sztucznej inteligencji, efektywne zarządzanie rozszerzeniami jest kluczem do produktywności. Skills Janitor to dedykowana wtyczka oraz zestaw narzędzi dla Claude Code, zaprojektowany w celu audytowania, śledzenia użycia i porównywania Twoich umiejętności. Jeśli Twój ekosystem staje się nieuporządkowany, Skills Janitor pomoże Ci utrzymać go w czystości, oferując 9 skoncentrowanych funkcji przy zerowej liczbie zewnętrznych zależności.

What's Skills Janitor

Skills Janitor to rozwiązanie typu open-source (dostępne w repozytorium khendzel/skills-janitor), które pełni rolę administratora dla Twoich umiejętności wewnątrz Claude Code. Jest to narzędzie, które dba o zdrowie, organizację i optymalizację Twojego środowiska pracy.

Projekt opiera się na prostocie i niezawodności – wymaga jedynie Bash, Python 3 oraz curl, eliminując potrzebę instalowania modułów node czy pakietów pip. Skills Janitor pozwala nie tylko przeglądać to, co już masz zainstalowane, ale także analizować, jak często korzystasz z poszczególnych funkcji, co pozwala na skuteczną eliminację zbędnego kodu i zasobów.

Features

Narzędzie Skills Janitor oferuje szeroki wachlarz funkcjonalności podzielonych na konkretne komendy slash, z których każda posiada dedykowane autouzupełnianie:

• Pełny Audyt Umiejętności: Za pomocą komendy /janitor-audit możesz wyświetlić pełny inwentarz wszystkich zainstalowanych umiejętności.
• Wykrywanie Duplikatów: Funkcja /janitor-duplicates identyfikuje powtarzające się umiejętności, które wykonują te same zadania.
• Kontrola Błędów: /janitor-check skanuje Twoje umiejętności pod kątem błędów oraz brakujących informacji.
• Automatyczna Naprawa: /janitor-fix pozwala na automatyczne usuwanie problemów, oferując bezpieczny tryb podglądu (dry-run) przed wprowadzeniem zmian.
• Czyszczenie i Konserwacja: /janitor-cleanup znajduje i pomaga usunąć uszkodzone lub niedziałające komponenty.
• Raportowanie Stanu: /janitor-report generuje pełny raport kondycji Twojego ekosystemu w jednym miejscu.
• Analiza Użycia: /janitor-usage pokazuje statystyki wywołań, wskazując, które funkcje są kluczowe, a które pozostają nieużywane.
• Odkrywanie Nowości: /janitor-search przeszukuje GitHub w poszukiwaniu nowych umiejętności do zainstalowania.
• Analiza Porównawcza: /janitor-compare pozwala zestawić Twoje lokalne rozwiązania z alternatywami dostępnymi w sieci.

Use Case

Skills Janitor znajduje zastosowanie w wielu scenariuszach pracy z Claude Code:

1. Optymalizacja Środowiska: Jeśli zauważysz, że Twoje menu komend jest przeładowane, użyj Skills Janitor, aby zidentyfikować 89% nieużywanych skryptów i je usunąć.
2. Rozwiązywanie Problemów Technicznych: Gdy nowo dodana umiejętność nie działa, /janitor-check szybko wskaże przyczynę usterki.
3. Research i Rozwój: Deweloperzy mogą użyć /janitor-search "marketing", aby znaleźć gotowe rozwiązania na GitHubie i porównać ich popularność (gwiazdki) oraz status instalacji.
4. Bezpieczne Zarządzanie: Dzięki zasadzie dry-run, Skills Janitor nigdy nie usunie niczego bez Twojej wyraźnej zgody, co jest kluczowe w profesjonalnych środowiskach programistycznych.

How to Use

Instalacja i obsługa Skills Janitor są niezwykle proste i można je przeprowadzić na kilka sposobów.

Instalacja

Zalecana metoda przez marketplace Claude Code:

/plugin marketplace add khendzel/skills-janitor
/plugin install skills-janitor

Alternatywnie, możesz sklonować repozytorium bezpośrednio:

git clone https://github.com/khendzel/skills-janitor ~/.claude/skills/skills-janitor

Obsługa Komend

Możesz korzystać z bezpośrednich komend slash lub języka naturalnego. Przykładowo:

• Wpisz /janitor-usage, aby zobaczyć raport z ostatnich 4 tygodni.
• Powiedz: "audit my skills" lub "which skills do I use?", aby wyzwolić odpowiednie skrypty na podstawie ich opisów.

Wskazówka: Aby uzyskać lepsze wyniki wyszukiwania na GitHub i uniknąć limitów zapytań, ustaw zmienną środowiskową GITHUB_TOKEN.

FAQ

Czy Skills Janitor może usunąć moje pliki bez wiedzy? Nie. Skills Janitor nigdy nie usuwa niczego bez jawnego potwierdzenia ze strony użytkownika. Wszystkie operacje niszczące są domyślnie uruchamiane w trybie testowym (dry-run).

Czy narzędzie modyfikuje wtyczki z marketplace? Nie, Skills Janitor nie modyfikuje wtyczek pochodzących bezpośrednio z oficjalnego marketplace.

Jakie są wymagania systemowe? Wymagane są: Bash, Python 3 oraz curl. Narzędzie nie wymaga instalacji żadnych dodatkowych bibliotek przez pip czy npm.

Jak działa śledzenie użycia? Skrypt /janitor-usage analizuje historię Twoich konwersacji, aby zidentyfikować, które komendy były faktycznie wywoływane w określonym czasie, a następnie generuje rekomendacje dotyczące usunięcia zbędnych zasobów.