Skills Janitor

Skills Janitor: Claude Code 스킬 생태계를 위한 완벽한 관리 솔루션

Claude Code 사용자라면 수많은 스킬을 설치하고 관리하는 과정에서 혼란을 겪어본 적이 있을 것입니다. Skills Janitor는 Claude Code의 스킬 생태계를 청결하고 조직적이며 건강하게 유지하기 위해 설계된 강력한 플러그인입니다.

이 도구는 별도의 의존성(Zero dependencies) 없이 작동하며, 9가지의 집중된 스킬 기능을 통해 사용자의 워크플로우를 최적화합니다. Skills Janitor를 사용하면 설치된 스킬을 감사하고, 실제 사용량을 추적하며, GitHub의 다른 스킬과 비교하는 등 전문적인 관리가 가능해집니다.

---

What's Skills Janitor?

Skills Janitor는 Claude Code 내에서 스킬(Skills)을 전문적으로 관리해주는 '청소부'이자 '관리자' 역할을 하는 도구입니다. 복잡해진 스킬 환경에서 어떤 스킬이 유용한지, 어떤 스킬이 오류를 일으키는지, 혹은 어떤 스킬이 서로 중복되는지를 한눈에 파악할 수 있게 해줍니다.

이 플러그인은 각 작업마다 고유한 자동 완성 기능을 갖춘 전용 슬래시 명령어를 제공하며, 자연어 입력을 통해서도 활성화될 수 있습니다. 특히 외부 라이브러리(Node modules, Pip 등) 설치가 필요 없는 Bash와 Python 3 기반의 가벼운 구조가 특징입니다.

---

Skills Janitor의 주요 기능 (Features)

Skills Janitor는 총 9가지의 핵심 스킬 기능을 통해 Claude Code 환경을 개선합니다.

1. 스킬 감사 및 상태 체크

• /janitor-audit: 현재 설치된 모든 스킬의 인벤토리를 보여줍니다.
• /janitor-check: 스킬 내부의 오류나 누락된 정보를 정밀하게 검사합니다.
• /janitor-report: 전체 스킬의 건강 상태를 하나의 종합 보고서로 출력합니다.

2. 최적화 및 정리

• /janitor-duplicates: 동일한 기능을 수행하는 중복 스킬을 찾아냅니다.
• /janitor-fix: 발견된 문제점을 자동으로 수정합니다 (안전을 위해 미리보기를 먼저 제공합니다).
• /janitor-cleanup: 손상되거나 작동하지 않는 스킬을 찾아 제거합니다.

3. 사용량 분석 및 탐색

• /janitor-usage: 대화 내역을 분석하여 실제로 자주 사용하는 스킬과 전혀 사용하지 않는 스킬을 구분합니다.
• /janitor-search: GitHub에서 설치 가능한 새로운 Claude Code 스킬을 키워드로 검색합니다.
• /janitor-compare: 내가 보유한 스킬과 GitHub의 유사 스킬을 비교 분석합니다.

---

Skills Janitor 설치 방법 (Install)

Skills Janitor는 두 가지 방법으로 설치할 수 있습니다. 사용자 환경에 맞는 방법을 선택하세요.

플러그인 마켓플레이스 이용 (권장)

Claude Code 터미널에서 다음 명령어를 입력합니다.

1. /plugin marketplace add khendzel/skills-janitor
2. /plugin install skills-janitor

직접 클론 설치

Git을 사용하여 로컬 디렉토리에 직접 설치할 수도 있습니다.

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

---

사용 사례 및 활용 방법 (Use Case & How to Use)

실제 사용 사례

• 스킬 다이어트: 사용량 보고서(/janitor-usage)를 확인하여 지난 4주간 사용하지 않은 90%의 불필요한 스킬을 정리할 때 유용합니다.
• 오류 해결: 스킬이 제대로 작동하지 않을 때 /janitor-check와 /janitor-fix를 통해 즉각적인 수리가 가능합니다.
• 벤치마킹: 새로운 기능을 추가하기 전 /janitor-compare를 통해 GitHub에 공개된 유사 스킬과 성능을 비교할 수 있습니다.

활용 방법 (How to Use)

Skills Janitor는 슬래시 명령어와 자연어 두 가지 방식을 모두 지원합니다.

• 명령어 입력: /janitor-usage를 입력하여 사용 통계를 확인합니다.
• 자연어 명령: "내 스킬들 감사해줘(audit my skills)" 또는 "n8n 관련 스킬 찾아줘"라고 입력하면 관련 기능이 실행됩니다.
• GitHub 검색: 검색 결과의 정확도를 높이려면 GITHUB_TOKEN 환경 변수를 설정하는 것이 좋습니다.

주의 사항: Skills Janitor는 명시적인 확인 없이는 어떤 데이터도 삭제하지 않습니다. 또한 플러그인/마켓플레이스 스킬은 직접 수정하지 않으며, 파괴적인 작업은 기본적으로 '드라이 런(Dry-run)' 모드로 작동하여 안전을 보장합니다.

---

자주 묻는 질문 (FAQ)

Q: Skills Janitor를 실행하기 위해 별도의 라이브러리 설치가 필요한가요? A: 아니요. Bash, Python 3, curl만 있으면 작동하며 Node modules나 Pip install이 전혀 필요 없는 구조입니다.

Q: 중복 스킬을 찾으면 자동으로 삭제되나요? A: 아닙니다. /janitor-duplicates는 중복을 찾아낼 뿐이며, 삭제는 사용자의 명시적인 확인 후에만 진행됩니다.

Q: GitHub 검색 시 속도 제한이 걸립니다. A: 더 나은 검색 결과와 높은 호출 한도를 확보하려면 시스템에 GITHUB_TOKEN 환경 변수를 설정하는 것을 권장합니다.

Q: 이 도구는 오픈 소스인가요? A: 네, Skills Janitor는 MIT 라이선스 하에 배포되는 오픈 소스 프로젝트입니다.