에이전트 스킬(Agent Skills) 완전 정리: MCP·함수 호출과의 차이와 작성법

핵심 메시지

• 에이전트 스킬은 특정 작업에 필요한 지시문·스크립트·참고자료·에셋을 한 디렉터리로 묶어, 파일시스템 기반 에이전트가 스스로 찾아 쓰게 하는 형식이다.
• 필수 구성은 디렉터리 이름과 일치하는 name, 그리고 description을 담은 프런트매터가 붙은 마크다운 파일 하나뿐이다. 나머지 스크립트·참고자료·에셋 폴더는 모두 선택이다.
• 함수 호출과 MCP, 스킬은 경쟁 관계가 아니라 층위가 다르다. 도구를 호출하는 방식, 그 호출을 표준화하는 서버, 그리고 워크플로 전체를 묶는 포장 단위로 서로 얹혀 있다.
• 핵심 작동 원리는 점진적 공개다. 항상 로드되는 것은 이름과 설명뿐이고 본문은 모델이 필요하다고 판단할 때 읽어 들이므로 컨텍스트를 아낄 수 있다.
• 발표자는 애플 노트를 다루는 스킬을 직접 만들어 보이며, 복잡한 동작을 스크립트로 묶어 두면 모델이 생소한 스크립팅 언어를 매번 짜낼 필요가 없다고 설명한다.

쉽게 이해하기

에이전트 스킬은 앤트로픽이 제안한 형식으로, 특정 작업에 필요한 지시문과 스크립트, 자료를 한 묶음으로 포장해 클로드 코드나 코덱스 같은 에이전트 하네스가 이를 발견해 따라 하도록 만든다. 매번 프롬프트로 같은 설명을 반복하지 않고도 도메인 지식이나 작업 절차를 주입할 수 있다는 점이 핵심이다. 발표자는 이를 함수 호출과 MCP에 이은 자연스러운 다음 단계로 본다.

이 방식이 성립하는 배경에는 이른바 파일시스템 기반 에이전트가 있다. 클로드 코드, 커서 에이전트, 코덱스, 오픈소스 계열 도구들은 대개 터미널 환경에서 동작하며, 좁게 정의된 함수 대신 배시 명령 실행이나 파이썬 실행, 디렉터리 탐색 같은 넓은 도구를 갖는다. 모델은 사전학습 단계에서 이미 코드 실행에 익숙하므로, 환경을 지나치게 규정하지 않고 열어 두는 편이 오히려 더 넓은 작업을 소화하게 만든다.

발표자가 특히 강조하는 것은 파일시스템이 일종의 기억 장치가 된다는 점이다. 코딩 에이전트가 거대한 저장소를 다룰 때 필요한 부분만 찾아 읽듯, 파일을 만드는 행위는 무언가를 적어 두는 일이고 그 내용은 컨텍스트에서 내려놓아도 사라지지 않는다. 이미 AGENTS.md 같은 관행이 이 아이디어를 쓰고 있는데, 에이전트를 위한 리드미처럼 저장소 최상단에 두면 호환되는 도구가 알아서 읽어 들인다.

혼동하기 쉬운 세 개념도 정리된다. 함수 호출은 모델에게 도구의 스키마를 알려 주고 모델이 호출 의사와 인자를 생성하게 하는 방식이며, 실행은 애플리케이션의 몫이다. MCP는 그 실행과 결과 전달 방식이 구현마다 제각각이던 문제를 서버 표준으로 정리한 것이다. 에이전트 스킬은 여기서 한 층 위로 올라가, 워크플로에 필요한 맥락과 자료와 스크립트를 하나로 묶는다. 세 가지는 서로를 대체하지 않고 쌓인다.

작성 요령도 구체적이다. 모델이 이미 유능하다고 가정하고 과잉 설명을 피하며, head 명령으로 앞부분만 읽을 수 있으니 중요한 내용은 위쪽에 배치한다. 이름은 'PDF 처리'처럼 동작을 드러내는 동명사형으로 짓고 3인칭으로 서술하며, 마크다운 한 파일은 500줄 이내로 유지하고 나머지는 하위 파일로 분리한다. 프런트매터는 항상 컨텍스트에 올라가므로 100토큰 이하로 밀도 있게 쓰는 것이 좋다. 발표자가 만든 애플 노트 스킬은 이 원칙대로 짧은 본문과 네 개의 스크립트, 지원되는 HTML 태그 표, 그리고 프로그래밍 방식으로는 다룰 수 없는 기능의 한계를 함께 담았다.

주요 인사이트

• 스킬의 진짜 비용은 형식이 아니라 워크플로를 정의하는 작업에 있다. 발표자는 절차를 문서로 정리하는 과정 자체가 자동화의 필수 사전작업이라며, 스킬이 결과물로 남지 않더라도 그 정리는 남는다고 말한다.
• 프런트매터의 이름과 설명은 항상 모델의 컨텍스트에 올라간다. 짧으면서도 언제 써야 하는지를 분명히 알려 주는 설명이 스킬이 실제로 쓰이느냐를 가른다.
• 복잡한 동작은 문장으로 설명하기보다 스크립트로 묶는 편이 안전하다. 애플 노트 예시에서 발표자는 모델이 생소한 시스템 스크립팅 언어를 직접 생성하는 대신, 플래그만 넘기면 되는 단일 기능 스크립트를 제공했다.
• 할 수 없는 일을 명시하는 것도 스킬의 일부다. 체크리스트나 이미지처럼 프로그래밍 방식으로는 다룰 수 없는 기능을 미리 적어 두면 모델이 헛수고하지 않는다.
• 실제 구현을 읽어 보는 것이 가장 빠른 학습법이라는 조언도 나온다. 발표자는 공개된 스킬 가운데 허깅페이스 생태계를 다루는 스킬을 특히 잘 만들어진 사례로 꼽았다.

자주 묻는 질문

관련 AI 소식