Deep Agents에서 스킬(skills) 사용하기

요약하자면, Anthropic은 최근 에이전트 스킬(agent skills)이라는 개념을 도입했습니다. 스킬이란 단순히 SKILL.md 파일과 함께 해당 에이전트가 특정 작업을 더 잘 수행하기 위해 동적으로 발견하고 로드할 수 있는 관련 파일(예: 문서 또는 스크립트)을 포함하는 폴더입니다. 저희는 deepagents-CLI에 스킬 지원 기능을 추가했습니다.

범용 에이전트의 부상

Claude Code나 Manus 같은 일반 목적 에이전트는 광범위하게 채택되고 있습니다. 저희는 일반 목적 에이전트가 많은 도구를 사용할 것이라고 예상할 수 있지만, 놀라운 추세가 나타났습니다. 바로 그들이 놀라울 정도로 적은 도구를 사용한다는 것입니다. Claude Code는 약 12개의 도구를 사용하고 Manus는 20개 미만을 사용합니다.

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

저희는 이러한 원칙들을 deepagents에 적용했습니다. deepagents는 파일 시스템 연산 및 코드 실행 기능을 갖춘 오픈 소스 에이전트 하네스입니다. 개요 비디오와 관련 슬라이드는 여기에서 확인하실 수 있습니다.

Deep Agents overview

스킬을 가진 일반 목적 에이전트

적은 도구로 어떻게 다양한 작업을 수행하는 일반 목적 에이전트는 무엇일까요? 저희 웨비나에서 Manus는 하나의 접근 방식을 논의했습니다. 바로 도구로부터 파일 시스템으로 동작을 오프로드(offload)하는 것입니다. 많은 도구를 제공하기보다는, 광범위한 작업에 대한 스크립트/지침이 있는 컴퓨터를 에이전트에게 제공합니다. 그러면 에이전트는 이 리소스를 사용하여 자신의 파일 시스템 및 셸 도구만으로 많은 작업을 수행할 수 있습니다.

Anthropic의 스킬 역시 이와 동일한 패턴을 따릅니다. 스킬은 YAML 프론트매터(frontmatter)와 마크다운 지침이 포함된 SKILL.md 파일을 가진 폴더들의 모음일 뿐입니다. Anthropic 블로그 게시물에서 가져온, SKILL.md 파일의 구조를 강조하는 그림은 다음과 같습니다:

Bundling additional content

스킬은 기존 도구에 비해 두 가지 장점을 제공합니다. 첫 번째 이점은 **토큰 효율성(token efficiency)**입니다. 스킬은 점진적으로 공개됩니다. 기본적으로 YAML 프론트매터만 로드되며, 에이전트는 전체 SKILL.md 파일을 읽습니다.

필요할 때만(only when needed) 작동합니다. 기존의 도구들은 모든 정의를 컨텍스트 내에서 미리 요구하기 때문에 컨텍스트 창을 부풀릴 수 있습니다. Anthropic의 블로그 게시물에서 이 그림을 통해 그 예시를 볼 수 있습니다:

Skills and the Context Window

두 번째 장점은 인지 부하(cognitive load) 감소입니다. 에이전트는 잠재적으로 중복되는 많은 도구들을 탐색하는 대신, 작고 원자적인(atomic) 도구 세트를 호출합니다. 이는 컨텍스트 혼란의 흔한 원인이 됩니다. 여기는 스킬과 도구를 비교하고, 액션을 인코딩하는 데 있어 스킬이 제공하는 이점을 보여주는 표입니다.

Comparing skills to tools

스킬은 토큰 사용량 감소를 넘어 강력한 기능을 가능하게 합니다. Anthropic의 Barry Zhang이 언급했듯이, 스킬은 지속적인 학습(continuous learning)을 향한 단계입니다. 에이전트는 새로운 작업을 접할 때 즉석에서 새로운 스킬을 생성할 수 있습니다. 또한 스킬은 여러 에이전트 간에 쉽게 공유할 수 있고 세션 내에서 조합(composable)될 수 있어, 필요한 만큼 여러 스킬을 불러올 수 있게 합니다.

Deep Agents CLI + Skills

저희 deepagent-CLI는 로컬 파일 시스템을 사용할 수 있는 오픈 소스 코딩 어시스턴트이며, 이는 Claude Code와 같습니다. 저희는 deepagent-CLI에 스킬 기능을 추가하여, 크고 성장하는 공개 스킬 모음들을 사용할 수 있게 했습니다.

사용자 에이전트를 위해 스킬 폴더를 만들고, 저장소(repo)의 예시 스킬 중 아무거나 복사하기만 하면 됩니다:

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를 참고해 주십시오.