Using skills with Deep Agents

🖼️ 인포그래픽

🖼️ 4컷 인포그래픽

💡 한 줄 요약

Anthropic의 agent skills 개념을 deepagents-CLI에 도입해, 적은 도구와 파일시스템 기반 스크립트/지침으로 작업을 동적으로 수행하는 방식을 설명한다.

📌 핵심 요약

• Anthropic이 제안한 skills는 SKILL.md와 관련 파일(문서·스크립트)이 들어 있는 폴더로, 에이전트가 동적으로 발견·로드해 특정 작업을 더 잘 수행하게 한다.
• Claude Code는 약 12개, Manus는 20개 미만의 도구만 쓰며, bash·파일시스템 등 컴퓨터 접근으로 전용 도구 없이도 다양한 행동을 한다.
• deepagents는 파일시스템 연산과 코드 실행을 갖춘 오픈소스 에이전트 하네스이며, deepagents-CLI에 skills 지원이 추가되었다.
• skills는 기본적으로 YAML frontmatter만 로드하고 필요할 때 전체 SKILL.md를 읽어 토큰을 아끼며, 원자적 소수 도구로 인지 부하를 줄인다.
• skills는 신규 작업에서 즉석 생성·공유·조합이 가능하고, ~/.deepagents/agent/skills에 두면 시작 시 로드되며 deepagents skills list로 확인할 수 있다.

🧩 주요 포인트

1. 범용 에이전트는 도구 수를 늘리기보다 컴퓨터(bash·파일시스템) 접근으로 행동을 일반화한다.
2. skills는 도구 정의를 전부 컨텍스트에 올리지 않고 점진 공개해 토큰 효율과 도구 혼선을 동시에 개선한다.
3. deepagents-CLI는 공개 skills 컬렉션을 로컬 폴더로 가져와 Claude Code와 유사한 코딩 어시스턴트 흐름에 붙인다.
4. 관련 요청 시 해당 SKILL.md를 자동 읽고 실행하므로, 지침·스크립트를 파일로 쌓는 패턴이 곧 역량 확장이 된다.

🧠 상세 정리

1. 배경과 문제의식

Anthropic이 최근 agent skills 개념을 소개했다. skills는 SKILL.md와 문서·스크립트 같은 연관 파일이 들어 있는 폴더이며, 에이전트가 이를 동적으로 발견하고 로드해 특정 작업을 더 잘 수행한다. 글의 핵심은 이 패턴을 deepagents-CLI에 추가했다는 점이다. 범용 에이전트가 도구를 무한정 늘리지 않고도 다양한 일을 하려면, 행동을 어디에 두고 어떻게 불러올지에 대한 설계가 필요하다. skills는 그 설계를 폴더와 마크다운 지침 단위로 표준화한 접근이다.

2. 범용 에이전트와 적은 도구

Claude Code와 Manus 같은 범용 에이전트가 널리 쓰이면서, 예상과 달리 도구 수가 매우 적다는 경향이 드러났다. Claude Code는 약 12개, Manus는 20개 미만 수준이다. 핵심 통찰은 에이전트에게 컴퓨터를 준다는 것이다. bash와 파일시스템 도구가 있으면 사람이 하듯 행동할 수 있어, 모든 작업마다 전용으로 바인딩된 도구가 필수는 아니다. deepagents는 이 원칙을 파일시스템 연산과 코드 실행이 있는 오픈소스 에이전트 하네스로 구현한 사례로 제시된다.

3. skills의 핵심 개념

적은 도구로 다양한 행동을 하는 한 방법은 Manus 웹inar에서 논의된 것처럼 행동을 도구에서 파일시스템으로 옮기는 것이다. 많은 도구 대신 광범위한 행동을 위한 스크립트와 지침이 있는 컴퓨터를 주고, 파일시스템·셸 도구로 자원을 쓰게 한다. Anthropic skills도 같은 패턴을 따른다. 각 폴더의 SKILL.md는 YAML frontmatter와 Markdown 지침을 담으며, 연관 파일과 함께 작업 단위 역량을 구성한다. 즉 skills는 새 API 형태라기보다, 발견 가능한 지침·스크립트 묶음으로 행동을 인코딩하는 방식이다.

4. 토큰 효율과 인지 부하

skills가 전통적 도구 대비 갖는 첫 이점은 토큰 효율이다. 점진적 공개 덕분에 기본으로는 YAML frontmatter만 로드되고, 에이전트는 필요할 때만 전체 SKILL.md를 읽는다. 전통적 도구는 정의를 컨텍스트에 미리 모두 올려 창을 비대화하기 쉽다. 둘째 이점은 인지 부하 감소다. 겹칠 수 있는 많은 도구를 고르는 대신 소수의 원자적 도구를 호출하므로 컨텍스트 혼선이 줄어든다. 글은 skills와 tools를 비교하는 표로, 행동을 인코딩할 때 skills가 주는 이점을 함께 강조한다.

5. 학습·공유·조합 가능성

skills는 토큰 사용 절감 이상의 역량을 연다. Anthropic의 Barry Zhang이 언급하듯, skills는 지속 학습으로 가는 한 걸음으로 볼 수 있다. 에이전트는 새로운 작업을 만나면 즉석에서 새 skills를 만들 수 있다. 또한 skills는 에이전트 간에 쉽게 공유되고, 세션 안에서 여러 개를 조합해 끌어올 수 있다. 행동이 파일 단위로 모듈화되면, 도구 스키마를 늘리지 않고도 역량 집합을 확장·재사용할 수 있다. 이 지점이 범용 에이전트 설계에서 skills를 도구 대체 축으로 보는 이유다.

6. deepagents-CLI 적용 방법

deepagent-CLI는 로컬 파일시스템을 쓰는 오픈소스 코딩 어시스턴트로, Claude Code와 유사한 위치다. 여기에 skills가 추가되어 공개 skills 컬렉션을 사용할 수 있다. 사용자는 ~/.deepagents/agent/skills 폴더를 만들고 저장소 예제 skills를 복사하면 된다. 예로 web-research skills를 복사하는 명령이 제시된다. 이 skills는 deepagent CLI 시작 시 기본 로드되며, 터미널에서 deepagents skills list로 목록을 볼 수 있다. 관련 요청을 주면 해당 SKILL.md를 자동으로 읽어 실행한다.

7. 결론과 시사점

정리하면, 범용 에이전트의 실무 패턴은 도구 폭증이 아니라 컴퓨터 접근과 파일 기반 지침·스크립트다. Anthropic skills는 그 패턴을 SKILL.md 폴더 구조와 점진 공개로 구체화했고, deepagents-CLI는 이를 로컬 코딩 어시스턴트에 연결했다. 사용자는 예제 skills를 복사해 바로 목록 확인과 자동 로드·실행 흐름을 쓸 수 있다. 결과적으로 역량 추가는 새 바인딩 도구보다 공유 가능한 skills 폴더를 늘리는 쪽에 가깝다. 상세 개요는 글에서 안내하는 비디오와 README를 보도록 한다.

🧾 핵심 주장 / 시사점

• 도구 수를 늘리는 대신 파일시스템과 셸로 행동을 일반화하는 설계가 Claude Code·Manus·deepagents 공통 축이다.
• skills의 점진 공개는 컨텍스트 비용과 도구 선택 혼선을 함께 줄이는 실무적 이점이 있다.
• deepagents-CLI에서 skills는 설치형 확장이 아니라 시작 시 로드되는 로컬 폴더 자원으로 동작한다.

✅ 액션 아이템

• Anthropic skills와 deepagents-CLI 연동 방식을 SKILL.md 점진 공개 기준으로 정리한다.
• Claude Code·Manus의 적은 도구 수와 bash·파일시스템 접근 원칙을 deepagents 설계 비교에 반영한다.
• ~/.deepagents/agent/skills 배치와 deepagents skills list 확인 절차를 사용 흐름에 포함한다.

❓ 열린 질문

• deepagents-CLI가 공개 skills 컬렉션 중 어떤 범위를 기본 예제로 가장 안정적으로 다루나?
• SKILL.md 점진 공개만으로 Claude Code 수준의 작업 다양성을 어디까지 유지할 수 있나?
• 에이전트가 신규 작업에서 skills를 즉석 생성할 때 deepagents 하네스의 파일시스템 경계는 어떻게 관리되나?