도구·서비스
에이전트 스킬
Agent Skills
지시·스크립트·자료를 담은 폴더(SKILL.md 포함)를 에이전트가 필요할 때만 불러 능력을 확장하는 방식. "점진적 공개"로 컨텍스트를 가볍게 유지합니다.
2
에이전트 스킬(Agent Skills)은 지시·스크립트·자료를 담은 디렉터리(SKILL.md 파일 포함)로, 에이전트가 필요할 때만 불러 능력을 확장하는 방식입니다.
핵심 포인트
SKILL.md는 필수 메타데이터인 name과 description을 담은 YAML 프런트매터로 시작합니다.
"점진적 공개(progressive disclosure)"가 핵심입니다 — ① 시작 시 각 스킬의 name·description만 시스템 프롬프트에 미리 로드 → ② 관련되면 SKILL.md 본문을 읽고 → ③ 번들된 추가 파일(reference.md 등)은 정말 필요할 때만 열어, 핵심 컨텍스트를 가볍게 유지합니다.
텍스트 지시뿐 아니라 실행 가능한 스크립트와 자료도 함께 묶을 수 있습니다.
이식성: Claude.ai · Claude Code · Claude Agent SDK · Claude Developer Platform에서 지원되며, 플랫폼 간 이식을 위한 오픈 표준으로 공개됐습니다.
이렇게 쓰여요
폼을 채울 때만 forms.md를 읽어 들이는 PDF 스킬
브랜드 산출물을 만들 때만 회사 색상·폰트를 로드하는 브랜드 가이드 스킬
주의할 점
스킬은 description으로 트리거됩니다 — 설명이 모호하면 정작 필요할 때 Claude가 그 스킬을 안정적으로 불러오지 못합니다. 설명을 구체적으로 쓰세요.