에이전트 스킬
에이전트 스킬(agent skills)은 지시, 스크립트, 참고 파일을 담은 폴더로, 각각 SKILL.md 파일로 설명됩니다. AI 에이전트는 작업에 필요할 때만 이를 찾아 불러옵니다.
다른 이름: SKILL.md, Claude skills
작성 Divya Sharma · 2026년 11월 15일 확인 · 리뷰 방식
에이전트의 시스템 프롬프트에 팀이 쓰는 모든 절차를 담을 수는 없습니다. 스킬은 그런 노하우를 에이전트가 필요할 때 읽는 폴더로 묶습니다. 회사 양식을 채우는 법, 릴리스를 진행하는 법, 사내 스타일을 따르는 법 같은 것입니다.
작동 방식
각 스킬은 SKILL.md 파일이 있는 디렉터리입니다. 파일은 스킬의 이름과 설명을 담은 YAML front matter로 시작하고, 그 뒤에 Markdown으로 쓴 지시가 이어집니다. 폴더 안의 다른 파일과 스크립트를 가리킬 수도 있습니다.
불러오기는 단계적으로 이루어지며, Anthropic은 이를 점진적 공개(progressive disclosure)라고 부릅니다. 시작할 때 에이전트는 설치된 각 스킬의 이름과 설명만 봅니다. 작업이 맞으면 SKILL.md 전체를 읽습니다. 그 파일이 더 많은 자료를 가리키면 필요할 때만 읽습니다. 그래서 스킬을 많이 설치해도 컨텍스트 윈도가 차지 않습니다.
Anthropic은 Agent Skills를 개방형 표준으로 공개했으므로, 같은 폴더가 여러 에이전트에서 동작할 수 있습니다.
스킬과 MCP 서버
MCP 서버는 에이전트에 새 도구를 주며, 대개 외부 서비스에 연결합니다. 스킬은 주로 지시와 로컬 스크립트를 줍니다. 둘은 잘 어울립니다. 스킬이 특정 작업에서 서버의 도구를 어떻게 쓸지 설명할 수 있습니다. 스킬은 사용자가 이름으로 실행하는 슬래시 명령과도 가깝습니다.
예시는 스킬 디렉터리와 Anthropic의 스킬 저장소에서 볼 수 있습니다.
관련 용어
- MCP 서버(MCP server)
- MCP 서버(MCP server)는 Model Context Protocol을 통해 도구, 데이터 리소스, 프롬프트 템플릿을 AI 애플리케이션에 제공하는 프로그램입니다. MCP 호환 클라이언트라면 별도 통합 코드 없이 이를 쓸 수 있습니다.
- 코딩 에이전트
- 코딩 에이전트(coding agent)는 소프트웨어를 직접 다루는 AI 에이전트입니다. 사람이 붙여 넣을 코드를 제안하는 데 그치지 않고, 코드베이스를 읽고, 파일을 수정하고, 명령과 테스트를 실행하며, 변경이 동작할 때까지 반복합니다.
- 시스템 프롬프트(System prompt)
- 시스템 프롬프트(system prompt)는 애플리케이션이 사용자 메시지보다 먼저 언어 모델에 보내는 지시 블록입니다. 대화 전체에 걸쳐 모델의 역할, 규칙, 어조, 출력 형식을 정합니다.
- 슬래시 명령(Slash command)
- 슬래시 명령(slash command)은 /compact나 /review처럼 앞에 슬래시를 붙여 입력하는 지시로, AI 도구가 텍스트를 일반 메시지로 다루지 않고 내장 동작이나 저장된 프롬프트를 실행하게 합니다.
- 에이전트 지침 파일(AGENTS.md)
- 에이전트 지침 파일(agent instructions file)은 AGENTS.md나 CLAUDE.md처럼 코드 저장소 안에 두는 Markdown 파일로, 코딩 에이전트가 세션을 시작할 때 읽어 프로젝트의 명령, 관례, 규칙을 익힙니다.