skills-janitor

Что такое skills-janitor?

skills-janitor — это плагин для Claude Code, который проводит аудит, отслеживает использование и сравнивает навыки Claude Code пользователя. Его цель — помочь поддерживать набор навыков в порядке, выявляя дубликаты, проверяя на ошибки или отсутствие информации и суммируя, какие навыки вы реально вызываете.

Плагин организован как девять специализированных действий, каждое из которых доступно как отдельная команда со слешем и автодополнением. Он также включает функции поиска навыков на GitHub для установки и сравнения навыка с похожими на GitHub.

Ключевые возможности

• Девять действий аудита как отдельные навыки/команды: /janitor-audit, /janitor-duplicates, /janitor-check, /janitor-fix, /janitor-cleanup, /janitor-report, /janitor-usage, /janitor-search и /janitor-compare.
• Автодополнение для каждого навыка: каждое действие — это отдельная команда со слешем, что упрощает обнаружение возможностей прямо в интерфейсе Claude Code.
• Отслеживание использования из истории бесед: анализирует историю бесед, чтобы показать, какие навыки вы вызывали, а какие — никогда.
• Проверки целостности и рабочие процессы очистки: включает команды для проверки навыков на ошибки/отсутствующую информацию и удаления сломанных навыков (деструктивные операции сначала в режиме dry-run).
• Обнаружение дублей: находит дублирующиеся навыки, которые выполняют одно и то же.
• Поиск и сравнение навыков на GitHub: ищет навыки на GitHub по ключевым словам и сравнивает ваш навык с похожими на GitHub.

Как использовать skills-janitor

1. Установите плагин (одним из описанных способов):
   • Из маркетплейса Claude Code, добавив khendzel/skills-janitor, или
   • Клонируйте репозиторий прямо в ~/.claude/skills/skills-janitor.
2. Запускайте команды через слеш-синтаксис. Примеры из проекта:
   • Инвентарь: /janitor-audit
   • Использование: /janitor-usage
   • Поиск: /janitor-search
   • Сравнение: /janitor-compare
   • Валидация: /janitor-check
   • Автоисправление (сначала preview): /janitor-fix
3. Опционально используйте ключевые слова в естественном языке. Плагин может запускать навыки по ключевым словам в описаниях (примеры: “audit my skills”, “which skills do I use?”, “search for n8n skills”, “compare my-skill against alternatives”).
4. Просматривайте выводы dry-run перед изменениями. Проект указывает, что деструктивные операции по умолчанию используют dry-run и ничего не удаляют без явного подтверждения.

Сценарии использования

• Ежемесячная гигиена навыков: генерируйте полный отчет по установленным навыкам и выявляйте проблемные, дубликаты или с отсутствующей информацией с помощью /janitor-report и /janitor-cleanup.
• Выявление неиспользуемых навыков: запустите /janitor-usage, чтобы увидеть, какие навыки активно используются, а какие — нет, и решите, что удалить.
• Снижение избыточности: используйте /janitor-duplicates для поиска навыков, выполняющих одну работу, чтобы консолидировать набор.
• Отладка навыков с отсутствующими деталями: запустите /janitor-check для выявления ошибок или отсутствующей информации, затем /janitor-fix (по умолчанию dry-run) для просмотра изменений.
• Поиск и сравнение новых навыков: ищите на GitHub с /janitor-search и оценивайте альтернативы с /janitor-compare перед установкой или обновлением библиотеки навыков.

FAQ

• Удаляет ли skills-janitor навыки автоматически? Проект явно указывает, что никогда ничего не удаляет без явного подтверждения.

• Применяются ли деструктивные операции сразу? Репозиторий указывает, что деструктивные операции по умолчанию используют dry-run.

• Изменяет ли он навыки из маркетплейса или плагинов? Указано, что он никогда не изменяет навыки из плагинов/маркетплейса.

• На чем основан отчет об использовании? Он анализирует историю ваших бесед, чтобы определить, какие навыки вы вызываете, а какие — нет.

• Что нужно локально для запуска кода плагина? Требования: Bash, Python 3 и curl (репозиторий отмечает без pip-установок и без node-модулей).

Альтернативы

• Ручная настройка навыков в Claude Code: поддержание порядка в навыках путём просмотра установленных навыков и выборочного удаления или обновления без автоматизированного аудита; проще, но без структурированного инвентаря, обнаружения дублей и сводок использования.
• Общий поиск в GitHub + сравнение README: поиск навыков в GitHub и самостоятельное сравнение репозиториев; подходит для поиска и сравнения, но не даёт отслеживания использования плагина или встроенных проверок состояния.
• Другие инструменты управления навыками Claude Code (альтернативы в категории): инструменты, ориентированные на организацию, валидацию или перечисление доступных навыков; они могут отличаться акцентом на аналитику использования, обнаружение дублей или поиск на базе GitHub.
• Скриптовые аудиты с помощью кастомного CLI: создание или использование локальных скриптов для сканирования директории ~/.claude/skills; обеспечивает автоматизацию, но требует больше настройки, чем рабочий процесс slash-команд плагина.