원문: Using skills with Deep Agents

2025년 11월 25일

Using skills with Deep Agents

요약: Anthropic은 최근 에이전트 스킬 개념을 소개했습니다. 스킬은 SKILL.md 파일과 관련 파일들(예: 문서나 스크립트)을 담은 폴더로, 에이전트가 특정 작업을 더 잘 수행하기 위해 동적으로 발견하고 로드할 수 있습니다. deepagents-CLI에 스킬 지원을 추가했습니다.

범용 에이전트의 부상

Claude Code와 Manus 같은 범용 에이전트들이 널리 채택되고 있습니다. 범용 에이전트가 많은 도구를 사용할 것으로 예상하지만, 놀랍게도 이들은 매우 적은 수의 도구만 사용합니다. Claude Code는 약 12개를, Manus는 20개 미만의 도구를 사용합니다.

범용 에이전트가 어떻게 적은 수의 도구만으로 작업을 수행할 수 있을까요? 핵심은 에이전트에게 컴퓨터 접근 권한을 부여하는 것입니다. bash파일시스템 도구를 사용하면, 에이전트는 모든 작업에 대해 특화된 도구를 필요로 하지 않고도 인간처럼 작업을 수행할 수 있습니다.

저희는 파일시스템 작업과 코드 실행 기능을 갖춘 오픈소스 에이전트 하네스인 deepagents에 이러한 원칙을 적용했습니다. 개요 영상은 여기에서, 관련 슬라이드는 여기에서 확인하실 수 있습니다.

Deep Agents overview

스킬을 갖춘 범용 에이전트

적은 도구를 가진 범용 에이전트가 어떻게 다양한 작업을 수행할 수 있을까요? 저희 웨비나에서 Manus가 한 가지 접근법을 소개했습니다: 도구에서 파일시스템으로 작업을 오프로드하는 것입니다. 많은 도구 대신, 다양한 작업을 위한 스크립트/지침이 담긴 컴퓨터를 에이전트에게 제공하세요. 에이전트는 파일시스템과 셸 도구만 사용하여 이러한 리소스로 많은 작업을 수행할 수 있습니다.

Anthropic 스킬은 바로 이 패턴을 따릅니다. 스킬은 YAML 프론트매터와 마크다운 지침을 담은 SKILL.md 파일이 있는 폴더들의 모음입니다. 다음은 실전 에이전트를 위한 에이전트 스킬에서 가져온 SKILL.md 파일 구조를 보여주는 그림입니다:

Bundling additional content

스킬은 기존 도구에 비해 두 가지 이점을 제공합니다. 첫 번째는 토큰 효율성입니다. 스킬은 점진적으로 공개됩니다. 기본적으로 YAML 프론트매터만 로드되고, 에이전트는 필요할 때만 전체 SKILL.md를 읽습니다. 기존 도구는 모든 정의를 컨텍스트에 미리 로드해야 하므로 컨텍스트 윈도우가 비대해질 수 있습니다. 이를 설명하는 스킬과 컨텍스트 윈도우의 그림을 확인하실 수 있습니다:

Skills and the Context Window

두 번째 이점은 인지 부하 감소입니다. 에이전트는 중복될 수 있는 많은 도구를 탐색하는 대신 소수의 원자적 도구만 호출합니다 — 이는 컨텍스트 혼란의 흔한 원인입니다. 다음은 스킬과 도구를 비교한 표와 작업 인코딩에 대한 스킬의 장점입니다.

Comparing skills to tools

스킬은 토큰 사용량 감소를 넘어 강력한 기능을 제공합니다. Anthropic의 Barry Zhang이 언급한 것처럼, 스킬은 지속적 학습을 향한 한 걸음입니다: 에이전트는 새로운 작업을 만날 때 즉석에서 새로운 스킬을 만들 수 있습니다. 또한 스킬은 에이전트 간에 쉽게 공유되고 세션 내에서 조합 가능하므로, 에이전트가 필요에 따라 여러 스킬을 가져올 수 있습니다.

Deep Agents CLI + 스킬

저희 deepagent-CLI는 Claude Code처럼 로컬 파일시스템을 사용할 수 있는 오픈소스 코딩 어시스턴트입니다. deepagent-CLI에 스킬을 추가하여 방대하고 계속 증가하는 공개 스킬 컬렉션을 사용할 수 있게 되었습니다.

에이전트용 스킬 폴더를 만들고 저희 리포지토리에서 예제 스킬을 복사하면 됩니다:

mkdir -p ~/.deepagents/agent/skills
cp -r examples/skills/web-research ~/.deepagents/agent/skills/

이러한 스킬들은 시작 시 deepagent CLI에 기본적으로 로드되며, 터미널에서 deepagents skills list를 실행하여 사용 가능한 모든 스킬을 확인할 수 있습니다:

Deep Agents skills list

스킬과 관련된 요청을 deepagents에 하면, 자동으로 관련된 SKILL.md 파일을 읽고 스킬을 실행합니다. 스킬에 대한 전체 개요는 저희 영상을 보시고 README를 참조하세요.