LeanX

Skill 파일 (SKILL.md)

SKILL.md는 에이전트 스킬 하나를 정의하는 파일입니다. 맨 위에 이름(name)과 설명(description)을 적고 본문에 작업 지침을 쓰며, 필요하면 스크립트나 참고 자료를 같은 폴더에 둡니다. AI 모델은 이 설명을 보고 스킬을 쓸지 스스로 고릅니다.

쉽게 말하면

업무 매뉴얼 한 권의 표지와 본문이라고 보면 돼요. 표지(설명)에 '언제 쓰는 매뉴얼인지'를 적어 두면, AI가 표지만 훑어보고 필요한 매뉴얼을 꺼내 읽어요. 매뉴얼이라는 개념이 '에이전트 스킬'이고, 그 매뉴얼 한 권이 SKILL.md 파일이에요.

예시

.claude/skills/commit/SKILL.md에 name: commit, description: '변경 사항을 커밋할 때 사용'과 커밋 메시지 규칙을 적어 둠 → "이거 커밋해줘"라고 하면 AI가 설명을 보고 이 스킬을 골라 규칙대로 커밋 (도구에 따라 /commit처럼 직접 호출도 가능)

함께 보면 좋은 용어

에이전트 스킬, Rule 파일 (CLAUDE.md), Claude Code

더 배우기

관련 AX 가이드 강의 보기

다음 단계

이 개념을 우리 팀 업무에 어떻게 적용할지 고민된다면 아래에서 시작할 수 있습니다.