안 쓰는 스킬이 매번 컨텍스트를 깎아 먹고 있었다

무엇이 바뀌었나

확인 Claude Code 공식 "What's new" 주간 다이제스트(Week 36, 2026-08-31~09-04)에 따르면 이 주간에 /skill-doctor 명령이 추가됐다. 등록해 둔 스킬 하나하나가 대화창 목록에 이름과 설명이 실리는 것만으로도 매 턴 컨텍스트를 차지한다는 것이 이 명령이 있는 이유다 — Claude가 그 스킬을 실제로 부르든 안 부르든 상관없이.

확인 리포트는 번들 스킬과 엔터프라이즈 스킬은 빼고 내가 직접 등록한 것만 보여준다. 끌 것을 고를 때는 컨텍스트 비용이 가장 큰 것부터 보라고 문서에 적혀 있다.

확인 못 함 정확히 8월 31일부터 9월 4일 중 어느 날 이 명령이 실제로 내려왔는지는 주간 단위 다이제스트로만 적혀 있어 하루 단위로는 특정하지 못했다. 필요 버전은 v2.1.252 이상이라고 명시돼 있다.

왜 중요한가

이 사이트 교육 과정 L1·05 반복을 스킬로 굳히기 에서 "절차도 낡는다"고 적었다 — 자료 형식이 바뀌거나, 더 나은 방법을 찾거나, 안 쓰는 단계가 생긴다고. 그런데 그 글에서도 낡았는지 확인하는 방법은 "꺼낼 때마다 다시 보라"는 것뿐이었다. 안 꺼내는 스킬은 그럼 어떻게 아나 — 라는 질문에 /skill-doctor가 답 하나를 준다.

확인 스킬 목록에 있다는 사실 자체가 매 턴 토큰을 쓴다. 한 번 만들어 두고 안 쓰는 스킬이 열 개 쌓이면, 실제로 하는 일 없이 대화마다 그 열 개의 설명이 먼저 얹힌다는 뜻이다. 늘리는 법은 L1·05에서 배웠으니, 이 글은 줄이는 법 쪽이다.

직접 해 보기 — 5분

1. 버전을 확인한다. /skill-doctor는 2.1.252부터 있으니 그 아래 버전이면 먼저 올린다.

   claude --version

2. 대화형 세션에서 명령을 친다.

   /skill-doctor

   /plugin 매니저의 Stats 탭이 열리면서 등록해 둔 스킬이 쭉 나온다.
3. 컨텍스트 비용이 큰 것부터 본다. 그중 호출된 적이 없다고 표시된 것을 추린다. 만든 지 오래됐는데 한 번도 안 불렸다면 후보 1순위다.
4. 끌지 말지 정한다. 리포트가 안내하는 자리에서 끈다. 아직 판단이 안 서면 이번 주만 더 지켜본다도 답이다 — 지우는 것보다 끄는 것이 되돌리기 쉽다.
5. 터미널 세션이 없다면 -p로 뽑아 기록해 둔다.

   claude -p "/skill-doctor 결과를 그대로 보여줘"

   화면이 아니라 텍스트로 나오니 파일로 저장해 두고 다음에 비교하기 좋다.

한 줄 정리

1. Claude Code v2.1.252부터(2026년 8월 말~9월 초) /skill-doctor로 스킬별 컨텍스트 비용·호출 빈도를 볼 수 있다.
2. 등록만 해 두고 한 번도 안 불린 스킬부터, 비용이 큰 순서로 끈다.
3. 휴대폰·브라우저의 원격 제어에서는 안 되니 터미널에서 실행한다.