AI 스킬, SKILL.md 작성법
폴더 안에 SKILL.md를 만들고, 맨 위에 이름과 설명을 적은 뒤 작업 순서를 쓰면 됩니다. 실행 스크립트는 필수가 아닙니다.
Agent Skills는 반복 업무에 필요한 지침과 자료를 묶는 공개 형식입니다. Anthropic은 10월 22일 이 표준을 Agentic AI Foundation에 기증한다고 발표했습니다. 아래는 공식 규격으로 파일을 작성하는 예시이며, 특정 AI 도구에서 실행한 후기는 아닙니다.
파일 하나로 시작하기
회의 메모 정리용이라면 meeting-summary 폴더를 만들고, 그 안의 SKILL.md에 다음처럼 적어보세요. 설명을 위한 가상 예시입니다.
---
name: meeting-summary
description: 회의 메모에서 결정과 담당자별 할 일을 정리할 때 사용합니다.
---
# 회의 메모 정리
1. 메모에 명시된 결정만 추립니다.
2. 할 일마다 담당자와 기한을 적습니다.
3. 없는 담당자나 기한은 미정으로 남깁니다.위쪽의 name과 description은 필수입니다. name은 1~64자로 폴더명과 같게 쓰고, 소문자 영문·숫자·하이픈을 사용하세요. 하이픈을 연달아 쓰거나 이름의 앞뒤에 붙이면 안 됩니다.
description에는 작업 내용과 사용할 때를 1~1,024자로 적습니다. ‘문서 작업을 돕는다’보다 ‘회의 메모에서 결정과 담당자별 할 일을 정리할 때 사용한다’처럼 범위를 잡으면 됩니다.
출처: Specification · 라이선스: CC BY 4.0
자료는 필요할 때만 추가하기
본문에는 작업 순서와 입력·출력 예시, 예외를 적습니다. 참고 문서가 길어지면 references 폴더로 나누고, 템플릿은 assets, 실행 코드가 필요하면 scripts에 둘 수 있습니다. 처음부터 모두 만들 필요는 없습니다.
파일을 작성한 다음에는 사용 중인 도구의 스킬 등록 방법을 확인하세요. 폴더를 만들었다고 모든 AI에서 자동으로 읽는 것은 아닙니다. 제공되는 도구나 실행 환경도 제품마다 다르므로, 가져온 스킬에 실행 코드가 있다면 내용을 먼저 살펴보세요.
공식 자료 확인일: 2026년 10월 23일.