Anthropic이 SKILL.md 포맷을 개발해 AI 코딩 에이전트가 마크다운 파일 하나로 반복 작업을 자동화하고 여러 도구 간 호환성 확보

Context

AI 코딩 에이전트(Claude Code, Cursor 등)를 사용하는 개발자들이 코드 리뷰, Git 워크플로우, 배포 등 반복적인 작업을 매번 지시해야 하는 비효율이 발생했다. 또한 도구별로 다른 포맷을 사용하면 같은 지시사항을 여러 번 작성해야 한다.

Technical Solution

• SKILL.md 포맷 도입: YAML 프론트매터(메타데이터, 트리거 조건)와 마크다운 본문(실행 지시사항)으로 구성된 표준 파일 형식 정의
• 자동 스킬 발견 메커니즘: 에이전트가 ~/.claude/skills/ 또는 .claude/skills/ 디렉토리를 스캔하고 description 필드로 관련성 판단해 자동 로드
• 개인/팀 스킬 구분 저장: 개인 스킬은 ~/.claude/skills/에, 프로젝트 스킬은 리포지토리의 .claude/skills/에 저장해 버전 관리와 팀 공유 활성화
• 선택적 보조 파일 지원: SKILL.md 외에 scripts/, references/, assets/ 폴더로 배포 스크립트, 문서, 템플릿 등 참조 자료 포함 가능
• 수동 호출 옵션: /skill-name 슬래시 커맨드로 직접 실행 가능하며, disable-model-invocation으로 자동 로드 방지(배포 같은 부작용 있는 작업용)

Impact

아티클에 정량적 수치가 명시되지 않음.

Key Takeaway

표준화된 마크다운 기반 포맷으로 AI 에이전트의 행동을 선언적으로 정의하면, 도구 간 호환성을 유지하면서 반복 작업을 체계적으로 자동화할 수 있으며, 팀 전체가 일관된 워크플로우를 공유할 수 있다.