Agent Skills 문서

Agent Skills는 지침과 메타데이터, 스크립트나 템플릿 같은 선택적 리소스를 하나로 묶어 Claude의 기능을 확장하는 모듈형 단위입니다. 요청과 관련이 있을 때 Claude가 자동으로 해당 스킬을 사용합니다. 주요 내용 · 구조: 모든 스킬은 YAML 프론트매터를 갖춘 SKILL.md 파일을 필요로 하며, name과 description이 필수 항목입니다 · 필드 제약: name은 소문자와 숫자, 하이픈만 허용하고 anthropic·claude 같은 예약어를 쓸 수 없으며, description은 무엇을 하는지와 언제 쓰는지를 모두 담아야 합니다 · 점진적 공개: 메타데이터는 항상 로드되고, 본문 지침은 스킬이 발동될 때, 번들된 참조 파일과 스크립트는 필요한 시점에만 로드됩니다 · 스크립트 실행: 스크립트 코드는 컨텍스트에 들어가지 않고 실행 결과만 반영되므로 번들 자료가 커져도 부담이 적습니다 · 사용 환경: Claude API와 Claude Code, claude.ai에서 사용할 수 있으나 커스텀 스킬은 표면 간에 동기화되지 않습니다 · 보안: 신뢰할 수 있는 출처의 스킬만 사용하고, 외부 출처 스킬은 번들된 모든 파일을 사전에 검토해야 합니다 스킬 작성 규칙이나 컨텍스트 로딩 동작, 환경별 제약을 확인하려 할 때 참고하면 좋습니다.