#대모델 SKILL은 어떻게 로딩해야 전문적인가

점진적 공개(Progressive Disclosure): 1계층 스킬 메타데이터는 상주, 2계층 스킬 본문은 발동 후 로딩, 3계층 번들 리소스는 단계에 따라 접근. 본질은 컨텍스트 예산 관리 방안이며, 토큰 절약·오발동 감소·모델 주의력 집중이라는 세 가지 목표를 동시에 달성한다.

공학적 문제는 "모델이 스킬을 볼 수 있는가"가 아니라 "언제 / 얼마의 비용으로 / 딱 충분한 정보만"이라는 세 차원이다.

#1계층: 스킬 메타데이터 (상주)

• 내용은 극도로 간결하게. 스킬 이름 + 적용 장면 + 한 줄 설명만 포함
• 충분히 짧기 때문에 컨텍스트에 장기 상주한다(「상주 메모리」)
• 역할 규정: 모델에게 "어떻게 실행하는지"를 가르치는 게 아니라, "어떤 유형의 작업을 만나면 고려할 수 있는 스킬이 무엇인지" 알게 하는 것

#2계층: 스킬 본문 (발동 후 로딩)

• 발동 조건: 사용자가 실제로 표를 업로드했고, 모델이 목차 카드로부터 표 스킬이 필요하다고 판단하면, 시스템이 그제서야 완전한 설명을 로딩한다
• 본문에 명확히 써야 할 것: 읽는 방법, 수식 처리, 포맷 검사, 출력 제약, 그리고 밟으면 안 되는 함정
• 핵심 성질: 스킬 본문은 상주 정보가 아니다. 발동된 뒤에야 컨텍스트에 들어오므로 모델이 보는 내용이 매우 집중된다. 필요한 스킬의 조작 매뉴얼만 읽지, 무관한 매뉴얼 더미에서 방향을 찾지 않는다
• 해결하는 문제는 실행 지도: 모델을 "이 스킬이 있다는 걸 안다"에서 "이번에 그것을 어떻게 써야 하는지 안다"로 업그레이드

#3계층: 번들 리소스 (단계별 접근)

• 리소스 유형: 스크립트, 템플릿, 예시 파일, 참고 자료
• 미리 넣으면 더 안 되는 이유: 스크립트 하나가 수백 줄, 템플릿 하나가 아주 클 수 있는데 모델이 먼저 전문을 읽을 필요가 없다
• 올바른 방식(온디맨드 읽기 3예):
  1. 문서를 렌더링해야 할 때 → 해당 스크립트 실행
  2. 특정 참고 파일을 조회해야 할 때 → 관련 조각 읽기
  3. 템플릿을 적용해야 할 때 → 그 템플릿 하나만 로딩
• 모델이 알아야 할 것은 세 가지뿐: 리소스가 존재한다, 언제 쓴다, 입출력이 무엇이다

#3계층 메커니즘 = 컨텍스트 예산 관리

• 메타데이터 — 발견 — 충분히 가벼워서 컨텍스트에 상주
• 스킬 본문 — 실행 — 발동 후 로딩
• 리소스 — 수행 — 구체적 단계에서 필요할 때 호출

결과: 토큰 절약, 오발동 감소, 모델 주의력을 현재 작업에 집중.

#핵심 통찰

1. 컨텍스트는 창고가 아니라 예산이다 — 이 문서의 핵심 주제. Skill 시스템의 좋고 나쁨은 "능력을 다 걸어놨는가"가 아니라 "작업 한 번에 실제로 컨텍스트를 얼마나 소모했는가"로 평가한다.
2. 정보는 「확실성」에 따라 단계별로 해제해야 한다 — 메타데이터는 "있는가 없는가"에 답하고, 본문은 "어떻게 하는가"에 답하며, 리소스는 "이 단계에서 구체적으로 무엇을 쓰는가"에 답한다. 확실성이 낮은 단계일수록 주는 정보가 적고, 확실성이 한 단계 올라가야 한 단계 더 로딩하도록 허용한다.
3. 무관 정보의 대가는 이중이다: 돈도 들고 정확도도 떨어진다 — 많은 사람이 Token 과금만 떠올리고, 수십 개 스킬이 나열되면 모델이 어느 것을 써야 할지 오판한다는 점을 놓친다. 오발동을 줄이는 것이 돈을 아끼는 것보다 값지다.
4. 「있는 걸 안다」 ≠ 「어떻게 쓰는지 안다」, 둘을 두 계층으로 나눠야 한다 — 스킬 발견(discovery)과 실행 지도(instruction)는 서로 다른 두 직책이며, 섞어 쓰면 반드시 정보가 부족하거나 전량 주입하게 된다.
5. 결정론적으로 실행할 수 있는 것은 모델에게 흉내내게 하지 말 것 — 스크립트를 직접 돌리고 결과를 회신하는 것이, 모델에게 "코드를 복창하고 실행한 척하게" 하는 것보다 토큰도 절약되고 더 신뢰할 수 있다. 이것은 Agent 설계 전반의 「결정론적 외주」 원칙이다.
6. 상주하는 것은 반드시 충분히 짧아야 한다 — 어떤 내용이 상주 가능한지 판단하는 유일한 기준은 길이/이득 비율이지 "중요한가"가 아니다. 보안 검사는 중요하지만 본문이 길면 본문 상주에는 적합하지 않을 수 있다.

#엔지니어링 실전 Tips

• 메타데이터 카드 작성 템플릿을 3단으로 고정할 것: 스킬 이름 + 적용 장면 + 한 줄 설명. 예: "표 스킬: xlsx와 csv 처리에 사용". 한 글자를 더 넣을 때마다 상주할 가치가 있는지 물을 것.
• 스킬 본문에 반드시 써야 할 5항: 읽는 방법, 수식 처리(혹은 그에 상응하는 핵심 알고리즘 약정), 포맷 검사, 출력 제약, 이미 알려진 함정. 「함정 회피 항목」 누락이 가장 흔한 실수다.
• 스크립트와 템플릿은 일률적으로 파일 시스템에 두고 경로로 참조할 것. Prompt에는 「리소스 존재 + 언제 쓰는지 + 입출력」 세 줄의 메타 정보만 남길 것.
• 비용 자가진단 방법: 최소 작업(예: "작은 표 하나 수정")을 한 번 돌려보고, 실제 소모된 Token 중 그 작업과 무관한 스킬 설명이 차지하는 비율을 볼 것. 이 비율이 곧 전량 주입의 직접 손실이다.
• 발동 판단 오류가 Token 초과보다 트러블슈팅이 어렵다. 상용 전에 "주어진 사용자 입력에 대해 메타데이터 계층이 선택한 스킬이 올바른가"라는 단일 지표를 별도로 평가해야 한다.
• 고빈도 기초 스킬(보안 검사, 포맷 검증)에 대해서는 "메타데이터 상주 + 본문 극단 간소화"라는 절충안을 고려할 수 있다. 단순 양자택일이 아니다.