현실 세계를 위한 에이전트 스킬: Anthropic의 Agent Skills 요약
AI 에이전트의 역량이 발전함에 따라, Anthropic은 도메인별 전문성을 손쉽게 추가할 수 있는 Agent Skills를 도입했습니다. Skill은 디렉터리 형태의 지식과 코드 꾸러미로, 에이전트가 필요할 때만 정보를 점진적으로 불러와 더욱 능동적이고 효율적으로 작업할 수 있게 해줍니다. 이 글에서는 Skill의 구조, 작동 방식, 개발 및 보안 팁을 비롯해 앞으로의 방향까지 쉽고 자세하게 설명합니다.
1. 더 똑똑해진 에이전트, 그리고 새로운 필요성
최근에는 Claude Code와 같은 범용 AI 에이전트가 로컬 코드 실행과 파일 시스템을 활용해 다양한 복잡한 업무를 수행할 수 있게 되었습니다. 하지만 이런 에이전트들이 더 강력해질수록, 특정 업무에 필요한 전문 지식을 쉽고 효과적으로 제공하는 방식이 필요해졌어요.
이를 해결하기 위해 Anthropic이 만든 것이 바로 Agent Skills입니다. Skill은 "명확하게 정리된 지시, 스크립트, 그리고 자료"를 담은 디렉터리로, 에이전트가 필요한 순간 스스로 찾아서 읽고 능력을 확장할 수 있는 구조예요.
"에이전트에게 Skill을 만드는 것은 마치 신입사원을 위한 온보딩 가이드를 만드는 것과 비슷합니다."
이제 누구든지 자신만의 procedural knowledge(절차적 지식)를 만든 Skill로 공유하고, 분절된 에이전트 대신 하나의 범용 에이전트를 여러 용도에 맞게 특화할 수 있게 된 것이죠.
2. Skill의 구조와 동작 원리
Skill은 최소한 하나의 SKILL.md 파일을 포함한 폴더입니다. 이 파일에는 이름(name)과 설명(description)이 YAML 형식으로 적혀 있어, 에이전트는 시작할 때 모든 Skill의 "이름"과 "설명"만 미리 머릿속(시스템 프롬프트)에 기억해 둡니다.
"이 메타데이터는 점진적 공개(progressive disclosure)의 첫 단계로, Skill이 필요할 때 언제 불러야 할지 판단할 수 있는 최소한의 정보를 제공합니다."
점진적 공개(Progressive Disclosure) 구조
Skill은 필요할 때만 정보를 단계적으로 불러오는 구조를 지니고 있습니다. 예를 들어, 어떤 업무에 PDF를 다루는 Skill이 필요하다면, Claude는 우선 SKILL.md를 읽습니다. 만약 더 깊은 설명(예를 들어 폼작성 방법 등)이 필요한 경우, forms.md, reference.md와 같이 Skill 폴더 안의 추가 파일도 선택적으로 불러와 참고할 수 있습니다.
"잘 정리된 매뉴얼처럼, Skill은 처음엔 목차만 보여주고, 필요할 때만 챕터와 부록을 펼치는 구조입니다."
이 때문에 Skill에 넣을 수 있는 정보량에는 사실상 제한이 없습니다. Claude와 같은 에이전트는 자신에게 주어진 '맥락 창(context window)' 자원을 효율적으로 활용할 수 있으니까요.
3. Skill이 실제로 동작하는 과정
Skill이 사용자 메시지에 따라 어떻게 호출되고, 어떤 내용이 에이전트의 맥락 창에 들어가는지 구체적으로 살펴볼게요.
- 우선 기본 시스템 프롬프트와 함께, 각 Skill의 이름과 설명, 그리고 사용자의 메시지가 맥락 창에 들어갑니다.
- Claude가 PDF Skill이 필요하다고 판단하면, Bash 도구로
pdf/SKILL.md내용을 읽습니다. - 필요하다면
forms.md등 연관 자료도 추가로 읽어옵니다. - 이제 필요한 모든 정보를 갖춘 Claude가 실제 문서 처리 같은 사용자의 요청을 이어서 수행하게 됩니다.
코드 실행과 Skill
Skill에는 파일 명령과 더불어, 스크립트 등 실행 가능한 코드도 포함할 수 있어요. 예를 들어, PDF Skill에는 특정 Python 스크립트가 들어 있어 Claude가 이를 직접 실행해, PDF의 폼 필드를 자동으로 추출하는 복잡한 작업도 빠르고 정확하게 처리할 수 있습니다.
"코드는 결정론적이기 때문에, 이런 작업 흐름은 항상 일관되고 재현 가능합니다."
4. Skill 개발과 평가, 그리고 보안 🛡️
직접 Skill을 만들 때, Anthropic은 아래와 같은 실질적인 팁을 전해줍니다.
- 평가에서 시작하기: 우선 에이전트가 어떤 업무에서 부족한지 실험해보고, Skill을 점진적으로 만들어 개선하세요.
- 확장성 고려:
SKILL.md가 너무 커질 경우, 내용을 별도 파일로 나누세요. 서로 관련 없는 맥락은 분리해서 토큰 낭비를 막을 수 있습니다. - Claude의 시각에서 설계: 실제 현장 상황에서 Claude가 Skill을 어떻게 쓰는지 꼭 관찰하고, 이름과 설명을 직관적으로 유지하세요.
- Claude와 함께 반복 개선: Claude가 업무를 하며 성공/실패 사례를 Skill로 정리하게 하고, 구체적으로 어디서 실수했는지 자기피드백을 유도하세요.
"Skill을 직접 만들었다면, Claude에게 자신의 성공적인 방법이나 흔한 실수를 스스로 Skill의 context(문맥)와 코드에 옮겨보라고 지시해보세요."
보안상 주의할 점
Skill은 에이전트의 능력을 크게 높이지만, 악의적인 의도를 가진 Skill은 보안위협이 될 수도 있습니다.
- 꼭 신뢰할 수 있는 소스에서만 Skill을 설치하세요.
- 코드, 외부 네트워크 접근 등 위험 요소가 숨겨져 있지 않은지 파일 내용을 꼼꼼히 읽어보세요.
5. Agent Skills의 미래와 앞으로의 계획
2025년 현재, Claude.ai, Claude Code, SDK, 개발자 플랫폼 등 다양한 곳에서 Agent Skills가 정식 지원되고 있습니다. 앞으로는 Skill의 생성, 수정, 공유, 사용 전 과정을 지원하는 다양한 기능이 추가될 예정이에요.
"우리는 앞으로 에이전트가 스스로 Skill을 만들고, 고치고, 성능을 평가해 자기만의 행동 패턴을 능력으로 저장할 수 있게 되기를 기대합니다."
이처럼 단순하고 명확한 포맷의 Skill 덕분에 누구나 쉽게 자신만의 특화 에이전트를 만들고, 새로운 능력을 덧붙일 수 있습니다. Anthropic은 많은 개발자와 기업이 Skill을 활용해 창의적인 결과물을 만들길 기대하고 있습니다.
마치며
Agent Skills를 이용하면 AI 에이전트의 능력을 빠르고 안전하게 확장할 수 있습니다. 쉽고 유연하며, 필요한 정보를 단계적으로 불러오는 이 방식은 앞으로의 AI 활용을 더욱 풍요롭게 할 것입니다. 지금 바로 Skill 개발에 도전해 보세요! 🚀