skills-janitor

skills-janitor란 무엇인가요?

skills-janitor는 Claude Code 플러그인으로, 사용자의 Claude Code 기술을 감사하고 사용량을 추적하며 비교합니다. 중복 식별, 오류 또는 누락 정보 확인, 실제 호출하는 기술 요약을 통해 기술 세트를 정리하는 데 목적이 있습니다.

플러그인은 자동 완성 기능이 있는 9개의 슬래시 커맨드로 구성된 집중된 액션들로 나뉘어 있습니다. 또한 GitHub에서 설치할 기술을 검색하고 GitHub에서 찾은 유사 기술과 비교하는 기능도 포함합니다.

9개의 개별 기술/커맨드로 노출된 감사 액션: /janitor-audit, /janitor-duplicates, /janitor-check, /janitor-fix, /janitor-cleanup, /janitor-report, /janitor-usage, /janitor-search, /janitor-compare.
기술별 자동 완성: 각 액션이 독립된 슬래시 커맨드이므로 Claude Code UI에서 직접 사용 가능한 기능을 쉽게 발견할 수 있습니다.
대화 기록 기반 사용량 추적: 대화 기록을 분석하여 호출한 기술과 한 번도 사용하지 않은 기술을 보여줍니다.
무결성 검사 및 정리 워크플로: 기술의 오류/누락 정보를 확인하고 손상된 기술을 제거하는 명령어를 포함합니다 (파괴적 작업은 dry-run 미리보기 우선).
중복 감지: 동일한 기능을 하는 중복 기술을 찾을 수 있습니다.
GitHub에서의 기술 발견 및 비교: 키워드로 GitHub에서 기술을 검색하고 자신의 기술을 GitHub의 유사 기술과 비교합니다.

플러그인 설치 (문서화된 방법 중 하나):
- Claude Code 마켓플레이스에서 khendzel/skills-janitor 추가, 또는
- 저장소를 ~/.claude/skills/skills-janitor에 직접 복제.
슬래시 구문을 사용해 명령어 실행. 프로젝트에 표시된 예시:
- 인벤토리: /janitor-audit
- 사용량: /janitor-usage
- 검색: /janitor-search
- 비교: /janitor-compare
- 유효성 검사: /janitor-check
- 자동 수정 (미리보기 우선): /janitor-fix
선택적으로 자연어 키워드 사용. 기술 설명의 키워드로 기술을 트리거할 수 있습니다 (예: “audit my skills”, “which skills do I use?”, “search for n8n skills”, “compare my-skill against alternatives”).
변경 전에 dry-run 출력 검토. 프로젝트에서 파괴적 작업은 기본적으로 dry-run을 사용하며 명시적 확인 없이 아무것도 삭제하지 않습니다.

월간 기술 위생 관리: /janitor-report와 /janitor-cleanup을 사용해 설치된 기술의 전체 보고서를 생성하고 문제, 중복 또는 누락 정보가 있는 기술을 식별합니다.
미사용 기술 발견: /janitor-usage를 실행해 활성 사용 기술과 호출되지 않은 기술을 확인한 후 제거할 기술을 결정합니다.
중복 감소: /janitor-duplicates를 사용해 동일한 작업을 수행하는 기술을 찾아 기술 세트를 통합합니다.
세부 정보 누락 기술 디버깅: /janitor-check를 실행해 오류 또는 누락 정보를 확인한 후 /janitor-fix (기본 dry-run)로 변경 사항을 미리 봅니다.
새 기술 찾기 및 비교: /janitor-search로 GitHub에서 기술을 검색하고 /janitor-compare로 대안을 평가한 후 기술 라이브러리를 설치 또는 업데이트합니다.

skills-janitor가 기술을 자동으로 삭제하나요? 프로젝트에서 명시적 확인 없이 절대 아무것도 삭제하지 않습니다.
파괴적 작업이 즉시 적용되나요? 저장소에서 파괴적 작업은 기본적으로 dry-run을 사용합니다.
마켓플레이스나 플러그인 제공 기술을 수정하나요? 플러그인/마켓플레이스 기술은 절대 수정하지 않습니다.
사용량 보고서는 무엇에 의존하나요? 대화 기록을 분석하여 호출한 기술과 사용하지 않은 기술을 판단합니다.
플러그인 코드를 실행하려면 로컬에 무엇이 필요한가요? 요구 사항은 Bash, Python 3, curl입니다 (저장소에서 pip 설치 없음, node 모듈 없음이라고 명시).

Claude Code에서의 수동 스킬 큐레이션: 설치된 스킬을 검토하여 선택적으로 제거하거나 업데이트함으로써 스킬을 정리; 자동 감사 기능이 없어 구조화된 인벤토리, 중복 감지, 사용 요약이 부족하지만 더 간단함.
일반 GitHub 검색 + README 비교: GitHub에서 스킬을 검색하고 저장소를 직접 비교; 검색 및 비교에는 유용하지만 플러그인의 사용 추적이나 내장 헬스 체크 기능은 제공하지 않음.
기타 Claude Code 스킬 관리 도구 (카테고리 대안): 사용 가능한 스킬을 정리, 검증 또는 나열하는 데 중점을 둔 도구; 사용 분석, 중복 감지 또는 GitHub 기반 검색 강조 여부에서 차이가 있음.
커스텀 CLI를 사용한 스크립트 감사: ~/.claude/skills 디렉토리를 스캔하는 로컬 스크립트를 작성 또는 사용; 자동화는 가능하지만 플러그인의 슬래시 커맨드 워크플로우보다 설정이 더 필요함.