AI 요약
Anthropic이 개발하고 오픈 표준으로 릴리스한 'Claude Code Skills(Agent Skills)'는 AI 에이전트에게 새로운 기능과 전문 지식을 부여하는 폴더 기반의 가벼운 포맷입니다. 클래스메소드 클라우드 사업본부는 팀원들의 업무 효율화를 위해 이 스킬의 셋업부터 실무 활용까지 아우르는 스터디를 진행했습니다. 스킬의 핵심은 SKILL.md라는 단일 필수 파일에 정의된 지시어와 메타데이터이며, 이를 통해 에이전트가 특정 상황에서 필요한 스크립트나 리소스를 자동으로 발견하고 실행할 수 있게 합니다. 특히 기존의 슬래시 명령어(/command) 체계가 스킬로 통합되었다는 점과, '단계적 정보 공개' 메커니즘을 통해 AI의 기억 용량을 효율적으로 관리한다는 점이 기술적 핵심입니다. 최종적으로는 이 기술을 통해 팀 내 베스트 프랙티스를 축적하고 개별 맞춤형 에이전트 환경을 구축하는 것을 목표로 합니다.
핵심 인사이트
- 오픈 표준 포맷: Anthropic은 이 규격을 Claude Code 전용이 아닌 에이전트 공통의 스킬 포맷으로 확산시키기 위해 오픈 표준으로 릴리스했습니다.
- 효율적인 컨텍스트 관리: 모든 정보를 한꺼번에 읽지 않고, 이름과 설명만 먼저 확인한 뒤 필요할 때만 상세 내용을 로드하는 '단계적 정보 공개(Progressive Disclosure)' 방식을 채택했습니다.
- 기술 사양의 가이드라인: 최적의 성능을 위해
SKILL.md파일은 500행 이하로 유지할 것을 권장하며, 상세 내용은 별도의 리퍼런스 파일로 분리하는 구조를 가집니다.
주요 디테일
- 폴더 구조: 필수 파일인
SKILL.md와 선택 사항인scripts/,references/,assets/폴더로 구성되어 관리와 공유가 용이합니다. - 저장 위치: 사용자 전체에 적용되는 유저 스코프(
~/.claude/skills/)와 특정 프로젝트에 한정되는 프로젝트 스코프(.claude/skills/)로 구분됩니다. - 자동 발화 메커니즘:
SKILL.md의 프론트매터(Frontmatter)에 기재된description을 기준으로 Claude가 해당 스킬을 사용해야 할 타이밍을 스스로 판단합니다. - 서브 에이전트 실행:
context: fork옵션을 활용하면 메인 대화 맥락을 오염시키지 않고 격리된 환경에서 작업을 수행하는 서브 에이전트(Sub-agent)를 구동할 수 있습니다. - 실무 데모 예시: 잡다한 메모를 기반으로 S3 버킷 생성 절차서를 작성할 때, 미리 정의된 템플릿과 리퍼런스를 활용해 정해진 형식에 맞춰 결과를 자동 생성하는 과정을 입증했습니다.
향후 전망
- 에코시스템 확장: Claude Code 외에도 다양한 에이전트 제품들이 이 포맷을 채택함에 따라 범용적인 AI 스킬 공유 생태계가 활성화될 것으로 보입니다.
- 기업 자산화: 단순한 대화형 AI 사용을 넘어, 사내의 표준 운영 절차(SOP)와 스크립트를 '스킬'로 변환하여 기업 고유의 지식 자산으로 축적하는 트렌드가 강화될 것입니다.