SKILL.md — 에이전트 스킬 포맷

SKILL.md는 AI 코딩 에이전트가 필요에 따라 탐색하고 활성화할 수 있는 재사용 가능한 기능을 패키징하기 위한 오픈 표준입니다. Anthropic이 만들고 agentskills.io에서 표준화되었으며, Claude Code, Cursor, Codex, Gemini CLI, VS Code를 포함한 27개 이상의 AI 에이전트가 지원합니다.

어떤 문제를 해결하나요?

스킬이 없으면, 에이전트에 특정 작업을 시킬 때마다 동일한 복잡한 프롬프트를 반복해야 합니다 — PDF 생성, 디자인 시스템 구축, Playwright 테스트 작성 등. SKILL.md는 그 지침을 한 번만 패키징해서 호환되는 모든 에이전트가 자동으로 불러올 수 있게 합니다. 스킬은 필요할 때만 로드되므로 에이전트의 컨텍스트 윈도우를 비대하게 만들지 않습니다.

동작 원리

스킬은 YAML 프론트매터와 마크다운 지침이 포함된 SKILL.md 파일이 들어 있는 폴더입니다. 최소한 이름과 설명만 있으면 됩니다.

---

name: pdf-processing

description: Extract text and tables from PDF files,

merge documents, fill forms, and convert to images.

license: MIT

compatibility:

- Claude Code

- Cursor

allowed-tools: Bash(python:*) Read Write

---

# PDF Processing

When the user asks you to work with PDF files, follow

these instructions...

프론트매터 필드

필드	필수	설명
name	예	고유 식별자. 최대 64자, 소문자, 숫자, 하이픈 사용 가능.
description	예	스킬이 하는 일과 언제 활성화할지. 최대 1024자.
license	아니오	SPDX 라이선스 식별자 또는 라이선스 파일 참조.
compatibility	아니오	호환되는 에이전트 및 환경 요구사항 목록.
metadata	아니오	임의의 키-값 쌍 (저자, 버전, 태그).
allowed-tools	아니오	에이전트에 사전 승인된 도구의 공백 구분 목록.

점진적 공개

스킬은 컨텍스트 윈도우를 효율적으로 유지하기 위해 3단계 로딩 모델을 사용합니다:

탐색 — 에이전트가 이름과 설명만 읽음 (~100 토큰)
활성화 — 작업이 매칭되면 전체 SKILL.md를 로드 (<5000 토큰)
실행 — 에이전트가 지침을 따르며, 필요에 따라 참조 파일을 로드

지원하는 에이전트

SKILL.md 포맷은 Claude Code, Cursor, OpenAI Codex, Gemini CLI, VS Code, GitHub Copilot, Amp, Roo Code, Goose, Windsurf, Continue 등 다양한 에이전트에서 지원됩니다. 호환 에이전트의 전체 목록은 다음에서 관리됩니다: agentskills.io.