에이전트 스킬과 도구 활용 (Skill-Driven Tool Calling)

에이전트 시스템에서 스킬(Skill)은 ‘두뇌’ 역할을 하며, 도구(Tool/MCP)는 ‘손’ 역할을 합니다. 지능적인 에이전트는 단순히 도구를 호출하는 것이 아니라, 스킬에 정의된 전략에 따라 도구를 제어합니다.

1. 스킬과 도구의 상호작용 아키텍처

스킬은 도구 사용의 전후 맥락(Context)을 관리합니다.

  1. 전략 수립 (Pre-Action): 어떤 도구를, 어떤 순서로, 어떤 파라미터를 사용하여 호출할지 스킬의 지침(SKILL.md)에 따라 결정합니다.
  2. 도구 호출 (Tool Call): 모델이 실제 API나 기능을 호출합니다. (Function Calling / MCP)
  3. 결과 해석 및 대응 (Post-Action): 도구의 결과값(Observation)이 스킬에서 기대한 조건에 맞는지 검증하고, 실패 시의 대응(Retry/Fallback) 전략을 수행합니다.

2. SKILL.md 내 도구 사용 명시법

스킬을 설계할 때, 해당 워크플로우에서 필요한 도구들을 명확히 기술해야 합니다.

YAML Frontmatter에서의 도구 매핑

스킬이 활성화될 때 특정 MCP 서버나 로컬 도구가 활성 상태여야 함을 명시할 수 있습니다. (표준 확장에 따라 다름)

지시사항(Instructions) 내 도구 제어

### 3단계: 보안 취약점 스캔 실행
1. `list_files` 도구를 사용하여 프로젝트 구조를 먼저 파악하십시오.
2. `read_file` 도구로 `package.json` 또는 `requirements.txt`를 읽어 의존성을 확인하십시오.
3. 발견된 라이브러리 목록을 기반으로 `vulnerability_database_lookup` 도구를 호출하십시오.
4. 만약 도구 결과에 'High Severity'가 포함되어 있다면, 즉시 작업을 중단하고 사용자에게 보고하십시오.

3. 도구 실행 결과의 지능적 해석

단순한 도구 사용과 ‘스킬 기반 도구 사용’의 가장 큰 차이점은 결과에 대한 판단력입니다.

  • 데이터 정제: 도구에서 반환된 원시 데이터(Raw data)를 스킬에서 정의한 형식으로 가공합니다.
  • 오류 복구 (Self-Correction): 도구 호출 에러가 발생했을 때, 스킬의 지침에 따라 파라미터를 수정하여 재시도하거나 대체 도구를 선택합니다.
  • 정보 통합: 여러 도구의 결과를 조합하여 하나의 완성된 통찰(Insight)을 도출합니다.

4. MCP(Model Context Protocol)와의 시너지

Agent Skills 표준은 MCP와 결합될 때 가장 강력합니다.

  • 표준화된 연결: MCP 서버를 통해 전 세계의 수많은 도구(Slack, GitHub, SQL 등)를 연결하고, Agent Skills를 통해 그 도구들을 사용하는 ‘전문가적 방법론’을 배포합니다.
  • 이식성: 특정 MCP 도구를 사용하는 ‘보안 감사 스킬’ 폴더 하나만 있으면, 어떤 환경에서든 동일한 보안 감사 워크플로우를 즉시 실행할 수 있습니다.

실무 팁: 도구 사용 가이드라인 작성

에이전트에게 도구 사용법을 가르칠 때 다음 사항을 SKILL.md에 포함하십시오.

  • 도구 호출 조건: “언제” 이 도구를 써야 하는가?
  • 필수 파라미터 설명: 도구 인자를 채울 때 주의할 점.
  • 예상되는 실패 시나리오: 도구가 정보를 찾지 못했을 때 에이전트가 취해야 할 행동.
  • 비용 관리: 토큰을 많이 쓰는 도구(예: 대용량 파일 읽기) 사용을 자제해야 하는 상황 명시.

This site uses Just the Docs, a documentation theme for Jekyll.