Tool Loadout은 AI 에이전트가 사용할 스킬과 도구 목록을 작업에 맞게 제한하는 패턴이다. 에이전트 성능은 모델뿐 아니라 컨텍스트에 들어간 도구 설명, 스킬 설명, MCP 서버 메타데이터에도 좌우된다. 너무 많은 도구를 기본 로드하면 모델은 잘못된 도구를 고르거나 중요한 지시를 놓친다.
왜 필요한가
스킬과 MCP 서버가 늘어나면 “능력 확장”이 곧 “컨텍스트 부채”가 된다. 전역 환경에 수백 개 스킬이 자동 로드되면 사용자는 모르는 사이에 토큰을 낭비하고, 설명이 겹치는 스킬끼리 라우팅 충돌을 만든다.
Tool Loadout 관점에서는 도구를 설치하는 것보다 현재 작업에 노출할 도구 묶음을 관리하는 것이 더 중요하다.
| 문제 | 영향 |
|---|---|
| 중복 스킬 | 같은 요청에서 어느 스킬을 써야 할지 모호해짐 |
| 설명 충돌 | 라우터가 잘못된 스킬을 선택 |
| unpinned MCP 서버 | 실행 시점에 도구 설명과 동작이 바뀜 |
| 비밀값 포함 설정 | 에이전트 컨텍스트나 로그로 유출 위험 |
| 실제 미사용 도구 | 토큰과 주의력만 소비 |
Dr. Skill의 접근
Drew Breunig의 drskill은 전역·프로젝트 환경의 Skills와 MCP 설정을 스캔해 loadout 문제를 찾는 도구다.
uv tool install drskill
drskill scan
drskill list --harness claude-code
drskill auditscan은 누락된 description, 중복 설치, 위험한 설정 같은 34개 이슈 범주를 확인한다. --deep 옵션은 LLM을 사용해 두 스킬이 실제로 구분되는지, 설명 범위가 겹치는지 판단한다. audit은 실행 trace를 읽어 어떤 스킬과 MCP 도구가 실제로 호출됐는지 보여준다.
운영 원칙
- 기본 loadout은 작게 유지한다.
- 스킬 설명은 서로 구분되는 동사와 대상 도메인을 가져야 한다.
- 프로젝트별 loadout과 전역 loadout을 분리한다.
- MCP 서버 패키지와 스킬 버전을 lockfile로 고정한다.
- 정기적으로 trace를 보고 쓰이지 않는 도구를 제거한다.
관련 문서
- agent-skills — 에이전트 스킬 생태계 개요
- mcp — 외부 도구와 에이전트를 연결하는 표준 프로토콜
- context-memory-engineering-tips-boundary — 컨텍스트 엔지니어링과 메모리 엔지니어링의 경계
- agent-harness — AI 에이전트 성능을 결정하는 하네스 설계
참고 자료
- Manage Your Agent’s Loadout with Dr. Skill — Drew Breunig (2026-07-24)