Anthropic Agent Skills

Anthropic은 사용자가 지침, 스크립트 및 리소스가 정리된 폴더를 통해 범용 에이전트에게 도메인 특화 전문 지식을 갖추게 할 수 있는 프레임워크인 Agent Skills를 도입했습니다. 이 시스템을 통해 에이전트는 특정 작업에 필요한 기능을 동적으로 발견하고 로드함으로써 일반론자에서 전문화된 에이전트로 변모할 수 있습니다.

The Architecture of Agent Skills

Agent Skills는 디렉토리 기반 구조를 활용하여 에이전트에게 추가적인 기능을 제공합니다. 하나의 스킬은 에이전트의 주요 진입점 역할을 하는 SKILL.md 파일을 포함하는 디렉토리로 구성됩니다.

Progressive Disclosure of Context

컨텍스트 창을 효율적으로 관리하기 위해, Agent Skills는 "progressive disclosure"라고 불리는 설계 원칙을 채택합니다. 이는 에이전트가 세 가지 상세 수준에 걸쳐 현재 작업에 필요한 정보만을 로드하도록 보장합니다:

Metadata Level: 모든 SKILL.md 파일은 name과 description을 포함하는 YAML frontmatter로 시작합니다. 이 정보는 시작 시 에이전트의 시스템 프롬프트에 미리 로드되어, 에이전트가 전체 내용을 로드하지 않고도 스킬이 관련 있는지 여부를 식별할 수 있게 합니다.
Core Instruction Level: 에이전트가 특정 스킬이 관련이 있다고 판단하면, SKILL.md 파일 전체를 컨텍스트 창으로 읽어 들입니다.
Deep Detail Level: 복잡한 스킬의 경우, 작성자는 스킬 디렉토리 내에 추가 파일(예: reference.md 또는 forms.md)을 묶을 수 있습니다. 에이전트는 필요할 때만 이러한 파일들을 탐색하고 발견할 수 있으므로, 묶인 컨텍스트의 양은 사실상 무제한입니다.

Integration with Code Execution

Agent Skills는 에이전트가 도구로서 실행할 수 있는 미리 작성된 스크립트를 포함할 수 있습니다. 이 방식은 리스트 정렬이나 PDF에서 양식 필드 추출과 같이 토큰 생성보다 전통적인 코드가 더 적합한 작업에 대해 결정론적 신뢰성과 효율성을 제공합니다.

Implementation and Best Practices

효과적인 스킬을 개발하려면 평가와 확장성에 초점을 맞춘 반복적인 접근 방식이 필요합니다.

Development Guidelines

Evaluation-First Approach: 대표적인 작업을 에이전트에게 실행시켜 기능적 격차를 파악하고, 이러한 부족한 점을 해결하기 위해 스킬을 점진적으로 구축합니다.
Scaling Structure: 다루기 힘든 SKILL.md 파일을 별도의 참조 파일로 분리하여 토큰 사용량을 줄이고 상호 배타적인 컨텍스트를 분리합니다.
Agent-Centric Design: 에이전트의 궤적(trajectories)을 모니터링하고 name과 description 메타데이터를 개선합니다. 이들은 스킬 활성화의 주요 트리거입니다.
Collaborative Iteration: 에이전트를 활용하여 성공적인 접근 방식과 흔한 실수를 재사용 가능한 컨텍스트와 코드 내에 캡처하여 스킬에 반영합니다.

Security Considerations

스킬에는 실행 가능한 코드와 외부 소스에 연결하는 지침이 포함될 수 있으므로, Anthropic은 신뢰할 수 있는 소스에서만 스킬을 설치할 것을 권장합니다. 사용자는 설치 전에 묶인 파일, 코드 종속성 및 네트워크 요청을 감사해야 합니다.

Availability and Future Roadmap

Agent Skills는 현재 Claude.ai, Claude Code, Claude Agent SDK, 그리고 Claude Developer Platform에서 지원됩니다. 또한, Agent Skills는 2025년 12월 18일부로 교차 플랫폼 이식성을 위한 오픈 표준으로 발표되었습니다.

Future Directions

Anthropic은 스킬을 생성, 편집 및 공유하는 라이프사이클을 확장할 계획입니다. 향후 개발 계획은 다음과 같습니다:

MCP Integration: 스킬이 Model Context Protocol (MCP) 서버를 어떻게 보완하여 에이전트에게 외부 소프트웨어를 포함한 복잡한 워크플로우를 가르칠 수 있는지 탐색합니다.
Autonomous Evolution: 에이전트가 자신의 행동 패턴을 코드로 정형화하여 재사용 가능한 기능으로 만들기 위해, 스스로 스킬을 생성, 편집 및 평가할 수 있도록 합니다.