SKILL.md

SKILL.md는 AI 에이전트에게 특정 작업을 어떻게 처리해야 하는지 정리해 건네는 설명서 파일이다. 신입 직원에게 업무 매뉴얼을 한 장 쥐여주는 것과 비슷하다. 매뉴얼을 받은 직원이 매번 처음부터 배우지 않고 필요한 부분만 펼쳐보듯, 에이전트도 이 파일을 참고해 정해진 절차대로 작업을 조립한다.

중요한 점은 이게 특정 회사 한 곳만의 발명품이 아니라는 것이다. SKILL.md라는 이름과 형식은 여러 AI 코딩 도구가 공통으로 채택한 규격이라, 이 형식으로 한 번 만들어두면 서로 다른 도구에서도 같은 파일을 그대로 읽어 쓸 수 있다. 마치 여러 회사가 같은 양식의 계약서 서식을 공유해서 쓰는 것과 비슷하다.

기술서를 스킬로 바꿔주는 도구의 경우, 책 내용을 챕터별 파일로 쪼갠 뒤 SKILL.md 문서에 적힌 규칙에 따라 에이전트가 필요한 챕터만 골라 불러오도록 조립한다. 파일 자체는 사람이 읽어도 이해할 수 있는 평범한 문서 형태지만, 에이전트에게는 작업 순서와 참고 자료 위치를 알려주는 지도 역할을 한다.

기사에는 "생성기가 이 결과를 SKILL.md와 챕터별 파일로 조립해 호스트에 맞는 스킬 디렉터리에 저장해요"라는 설명이 나온다. 여기서 오해하기 쉬운 부분은 SKILL.md가 book-to-skill 같은 특정 프로그램의 이름이 아니라는 점이다. book-to-skill은 이 형식에 맞춰 문서를 자동으로 조립해주는 도구 중 하나이고, SKILL.md 자체는 깃허브 코파일럿·Amp·클로드 코드 등 여러 호스트가 함께 읽고 쓰는 공용 파일 형식의 이름이다.

1. 지금 쓰는 AI 코딩 도구가 '에이전트 스킬' 형식을 지원하는지 문서에서 확인한다.
2. 지원한다면 텍스트 편집기로 SKILL.md라는 이름의 파일을 하나 만들고, 반복적으로 시키고 싶은 작업의 절차를 순서대로 적어본다. 예를 들어 "이 프로젝트에서 새 API 엔드포인트를 추가할 때는 1) 라우터 파일 확인 2) 테스트 코드 작성 3) 문서 업데이트 순서로 진행하라" 같은 식이다.
3. 그 파일을 프로젝트 폴더의 스킬 전용 디렉터리에 넣고, 에이전트에게 관련 작업을 시켜본 뒤 매뉴얼을 참고해 답하는지 살펴본다.