LLM Wiki

skills-cleaner — Claude Code 스킬 사용량 추적·중복 정리 플러그인

4 min read

skills-cleaner — Claude Code 스킬 사용량 추적·중복 정리 플러그인

Claude Code의 스킬이 많아질수록 보이지 않던 토큰 비용과 중복 스킬 문제가 커지는데, skills-cleaner는 이를 가시화하고 정리하는 운영 도구다.

개요

GeekNews에 소개된 skills-cleaner의 핵심은 단순한 스킬 목록 출력이 아니라, Claude Code 세션에서 어떤 스킬이 얼마나 자주 호출되고 토큰을 얼마나 소비하는지 추적할 수 있게 만든다는 점이다. 원문 소개 문구는 /profile-skills 한 번으로 사용 현황을 분석할 수 있다고 요약했고, GitHub README를 보면 여기에 스킬 검색·중복 정리·HTML 시각화까지 포함된다.

이 도구는 최근 moc-claude-code 생태계가 스킬 중심으로 빠르게 커지면서 생긴 운영상의 병목을 정확히 겨냥한다. 스킬이 쌓일수록 “무엇이 실제로 쓰이는지”, “어떤 스킬이 토큰을 많이 먹는지”, “비슷한 스킬이 중복 설치되어 있는지”를 사람이 감으로만 관리하기 어려워지는데, skills-cleaner는 그 문제를 관측 가능성(observability) 도구로 해결하려 한다.

핵심 기능

  • /profile-skills — 스킬별 호출 수와 토큰 사용량을 집계하고, --detail 옵션으로 HTML 리포트를 생성
  • /list-skills — 설치된 스킬을 플러그인/개인 스킬 단위로 그룹화해 나열
  • /search-skills — 스킬 이름으로 설치 위치를 검색
  • /clean-skills — 유사도 70% 이상인 스킬 쌍을 비교해 중복 정리를 돕는 인터랙티브 흐름 제공

README 기준으로 사용량 추적은 PostToolUse, UserPromptSubmit, Stop 훅을 통해 구현되며, 결과는 ~/.claude/skill-usage.jsonl에 기록된다. 즉 단순 추측이 아니라 세션 로그 기반의 계량 데이터를 남긴다.

왜 중요한가

최근 Claude Code 관련 노트들에서 비용 절감 프록시(2026-04-10-rtk-token-optimization-proxy), 세션 모니터링(2026-04-10-claude-code-monitor-tool, 2026-04-10-ccmonitor-claude-code-tui-dashboard), 스킬 라이브러리(2026-03-22-skillsmp-claude-code-skill-library)가 잇따라 등장하고 있다. skills-cleaner는 이 흐름을 “스킬 자체의 운영 가시성”으로 확장한다.

특히 토큰이 빠르게 소모되는 이유가 모델 자체인지, 특정 스킬 호출 패턴인지, 중복 설치된 스킬로 인한 과도한 로딩인지 분리해서 볼 수 있다는 점에서 실무 가치가 크다. Claude Code 사용이 일회성 프롬프트가 아니라 지속 운영되는 코딩 환경으로 진화할수록, 이런 메타 레이어 도구의 중요성은 더 커질 가능성이 높다.

Sources

그래프 뷰

백링크