스킬 100개 켜둬도 토큰 0, 제3의 계층

클로드 코드(Claude Code)에 스킬을 많이 설치한 사용자일수록 손해를 본다는 구조적 문제를 겨냥한 플러그인이 공개됐다. 다니엘 루블린스키(danielLublinsky)가 만든 스킬 아틀라스(Skill Atlas)로, 스킬 컬렉션 전체를 그래프로 검색해 세션당 토큰을 85% 안팎 줄인다고 밝혔다.

무슨 일인가

문제의 출발점은 클로드 코드의 동작 방식이다. 활성화된 스킬은 설명문이 모든 세션에 자동으로 주입된다. 저장소 설명에 따르면 스킬 하나당 약 48토큰이며, 100개를 넘기면 아무 일도 시키지 않은 상태에서 매 세션 수천 토큰을 상시 지불하게 된다. 비용만의 문제도 아니다. 기능이 비슷한 스킬들이 나란히 올라가 있으면 모델의 주의를 두고 서로 경쟁해, 엉뚱한 스킬이 호출되는 일이 생긴다.

해결책으로 보통 떠올리는 건 안 쓰는 스킬을 끄는 것이다. 하지만 끄는 순간 그 스킬은 존재하지 않는 것이 된다. 필요할 때 다시 켜려면 무엇이 있었는지 기억해야 한다. 스킬 아틀라스는 이 사이에 계층을 하나 더 끼워 넣었다.

핵심 짚어보기

계층은 셋으로 나뉜다. 활성 스킬은 컨텍스트에 들어가고 기본 검색이 되지만 각각 약 48토큰을 쓴다. 비활성 스킬은 컨텍스트에도 없고 찾을 수도 없으며 비용은 0이다. 새로 추가된 '검색 가능' 계층은 컨텍스트에는 들어가지 않지만 필요할 때 검색으로 찾아낼 수 있고, 비용은 0이다. 이 휴면 계층 전체를 알리는 데 드는 비용은 세션 시작 시 붙는 약 50토큰짜리 한 줄뿐이다.

개발자가 공개한 실측값은 구체적이다. 스킬 53개 중 6개만 활성으로 두자 세션당 토큰이 2,544에서 338로 떨어졌다. 86.7% 감소다. 나머지 47개는 실제로 호출되기 전까지 비용이 발생하지 않는다.

설치는 마켓플레이스 등록 후 플러그인 설치 명령 두 줄이면 끝난다. 파이썬 3만 있으면 되고 외부 의존성이나 네트워크 접속이 필요 없다. 시각화에 쓰는 d3 라이브러리도 저장소에 함께 포함돼 있다. 명령은 세 개다. /skill-atlas는 그래프를 만들고 새 스킬을 분류한 뒤 브라우저로 볼 수 있는 지도 파일을 렌더링한다. 최초 1회만 실행하면 된다. /skill-atlas:edit-searchable은 어떤 스킬을 검색 계층에 넣고 뺄지 대화형으로 조정한다. /skill-atlas:skill-search는 휴면 계층까지 포함해 작업에 맞는 스킬을 찾아주는데, 실제로는 사용자가 직접 칠 일이 거의 없다. 클로드가 복잡한 작업 전에 알아서 호출하기 때문이다. 이후 갱신은 세션 시작 훅이 자동으로 처리한다.

플러그인 없이 메이크파일로 직접 쓸 수도 있다. 빌드·렌더·검사·테스트·릴리스 명령이 준비돼 있고, 검사 명령은 깨진 참조나 존재하지 않는 스킬 언급이 하나라도 있으면 실패를 반환해 CI 관문으로 쓸 수 있다. 테스트는 실제 설정 폴더를 건드리지 않고 픽스처만 사용한다.

1인기업 실전 적용 포인트

• 지금 켜져 있는 스킬 수부터 세어보라. 계산은 단순하다. 활성 스킬 수에 48을 곱한 값이 매 세션 고정 지출이다. 스킬이 30개면 세션마다 1,400토큰 이상이 대화를 시작하기도 전에 나간다.
• 자주 쓰는 대여섯 개만 활성으로 남겨라. 실측 사례가 6개다. 매일 쓰는 것만 활성에 두고 나머지는 검색 계층으로 내리면 기능은 유지한 채 비용만 사라진다.
• 비슷한 스킬이 서로 방해하는지 점검하라. 이름과 설명이 겹치는 스킬이 여럿 켜져 있으면 호출 정확도가 떨어진다. 토큰 절감보다 이쪽 효과가 더 클 수 있다.
• 검사 명령을 자동화 파이프라인에 물려라. 스킬 문서끼리 참조가 꼬이면 조용히 잘못 동작한다. 실패를 반환하는 검사 명령을 정기 점검에 넣어두면 깨진 참조를 사람이 찾아다닐 필요가 없다.

전망 / 주의점

아직 별 14개 규모의 초기 프로젝트이고, 검색 계층이라는 개념 자체가 클로드 코드의 공식 기능이 아니라 플러그인이 얹은 우회책이라는 점은 감안해야 한다. 향후 본체가 비슷한 기능을 흡수하면 역할이 겹칠 수 있다. 그래도 문제 정의만큼은 정확하다. 스킬과 도구를 계속 늘려온 사용자라면 컨텍스트 예산이 이미 새고 있을 가능성이 높다. 항상 들고 다녀야 할 것과 필요할 때 꺼내면 되는 것을 나누는 일은, 도구를 늘리는 것보다 먼저 해야 할 정리 작업이다.

출처: Skill Atlas 깃허브 저장소 (https://github.com/danielLublinsky/Skill_Atlas)