Dr. Skill로 에이전트 스킬 세트 관리하기

에이전트의 스킬과 도구를 효과적으로 제어하세요

"컨텍스트를 고치는 방법"을 쓸 당시에는 Tool Loadout 패턴의 실제 사례를 찾기가 꽤 어려웠습니다. 하지만 스킬이 점점 대중화되면서, 컨텍스트도 덩달아 뒤엉키기 시작했습니다.

얼마 전, 한 개발자를 만났는데 그의 엔터프라이즈 에이전트가 600개가 넘는 스킬을 불러오고 있다는 이야기를 들었습니다. 동료들이 만든 스킬이 기본값으로 전부 로드되고 있었던 것입니다. 개발자에게 아무런 알림도 없이, 첫 글자를 입력하기도 전에 컨텍스트가 조용히 망가지고 있었던 셈이죠.

지난주에는 제 Hermes 에이전트가 엉뚱한 노트 앱 스킬을 계속 불러오는 문제가 생겼습니다. SSH로 직접 접속해 확인해 보니, Hermes에는 거의 100개에 달하는 스킬이 기본 탑재되어 있었습니다. 기본 노트 앱 스킬을 삭제하자 조금 나아지긴 했지만, 문제가 완전히 해결되지는 않았습니다. 그렇다고 Hermes의 스킬을 하나하나 뒤지고 싶지는 않았습니다.

그래서 전역 또는 프로젝트 환경에 설치된 스킬과 MCP를 전수 점검하는 도구, drskill를 직접 만들었습니다.

drskill는 uv tool install drskill 또는 pip install drskill로 설치할 수 있습니다.

설치 후 drskill scan를 실행하세요:

여기서 drskill는 오류 하나(plumb 스킬에 설명이 빠져 있음)와 경고 몇 가지(Overture용으로 개발 중인 스킬이 서로 다른 두 위치에 중복 설치되어 있음)를 발견했습니다. drskill는 해당 경로와 해결 방법(해당하는 경우)을 출력해 주기 때문에 빠르게 수정할 수 있습니다.

drskill는 MCP와 스킬 전반에 걸쳐 34가지 이슈 유형을 검사합니다. --deep 플래그를 추가하면 LLM(API 키는 직접 제공해야 합니다)을 활용해 두 스킬의 설명이 충돌하는지, 또는 역할 범위가 겹치는지를 판단해 줍니다.

drskill list를 실행하면 현재 스킬 세트 구성을 한눈에 확인할 수 있습니다. --harness claude-code를 추가하면 Claude Code가 인식하는 항목만 필터링해 볼 수 있습니다:

실제로 사용되는 스킬이 무엇인지 알고 싶다면 drskill audit를 실행하세요. 트레이스를 분석해 스킬이나 도구가 호출된 모든 시점을 찾아 리포트로 출력해 줍니다:

출시한 지 겨우 일주일이 지났지만, drskill는 이미 충분한 가치를 증명하고 있습니다. Hermes 디버깅과 로컬 이슈 발견은 물론, 직접 스킬을 개발하거나 실제 환경에서의 동작을 테스트할 때도 유용하게 활용하고 있습니다.

사용자들이 이런 용도로 활용하고 있다는 이야기도 들었습니다:

• 에이전트가 엉뚱한 스킬이나 도구를 선택하는 원인 파악 — 예: 두 스킬의 설명이 비슷해 라우터가 구분하지 못하는 경우
• 배포 전 설정 위험 요소 사전 차단 — 예: 커밋된 파일에 포함된 시크릿이나 버전이 고정되지 않은 서버 패키지
• 스킬 세트 변경 감지 — 예: lockfile과 달라진 스킬이나 도구 설명이 바뀐 서버
• 다른 라이브러리와 충돌하지 않는 스킬 및 도구 설명 작성
• 에이전트가 실제로 사용하는 스킬과 MCP 도구 확인, 그리고 해당 호출을 유발한 쿼리 분석

drskill는 로컬 환경이나 CI 파이프라인에서 편리하게 활용할 수 있는 기능도 갖추고 있습니다.

한번 사용해 보세요! 도움이 됐거나 개선할 점이 있다면 알려주세요.

---

이메일을 등록하고 주요 업데이트 소식을 받아보세요.