[Agent Skills 완전정복 #1] AI 에이전트 '스킬'이 뭐야? — 개념과 작동 원리

 

Agent Skills 공식 문서(agentskills.io)를 한 장(章)씩 따라가며 정리하는 시리즈입니다.
첫 편은 "스킬이 대체 뭐냐"를 개념부터 작동 원리까지 한 번에 짚어봅니다.

Claude Code, Cursor, GitHub Copilot, Gemini CLI… 요즘 거의 모든 코딩 에이전트가 "스킬(Skill)"을 지원하기 시작했어요. 대체 뭐길래 이렇게 다들 도입할까요?

---

📌 이 글 3줄 요약

• 스킬 = SKILL.md 파일이 든 폴더 하나. 에이전트에게 '전문 지식 + 절차'를 통째로 끼워주는 것.
• 핵심 원리는 점진적 로딩(Progressive Disclosure) — 필요할 때만 불러와 컨텍스트를 아낀다.
• Anthropic이 만든 오픈 표준이라, 한 번 만들면 호환되는 어떤 에이전트에서든 쓸 수 있다.

---

🤔 Agent Skills, 한마디로?

Agent Skills는 AI 에이전트에게 새로운 능력과 전문 지식을 추가하는 표준 방식입니다. 거창해 보이지만 실체는 단순해요. 그냥 폴더 하나입니다.

my-skill/
├── SKILL.md          # 필수: 메타데이터 + 지침
├── scripts/          # 선택: 실행 코드
├── references/       # 선택: 참고 문서
└── assets/           # 선택: 템플릿·리소스

이 중 필수는 SKILL.md 단 하나입니다. 이 파일 안에 "이 스킬이 뭘 하는지(이름·설명)"와 "어떻게 수행하는지(지침)"를 적어두면, 에이전트가 알아서 읽고 그대로 따라 합니다.

---

💡 왜 필요할까?

요즘 에이전트는 똑똑하지만, 정작 "우리 회사·우리 팀·이 작업만의 맥락"은 모릅니다. 스킬은 그 빈틈을 메워줘요. 절차적 지식과 맥락을 휴대 가능한 폴더로 묶어두는 거죠.

• 도메인 전문성 — 법률 검토 절차, 데이터 분석 파이프라인, 문서 서식 규칙 같은 특화 지식을 재사용 가능한 형태로 캡슐화
• 반복 가능한 워크플로우 — 여러 단계짜리 작업을 매번 똑같이, 추적 가능하게 수행
• 제품 간 재사용 — 한 번 만들면 스킬을 지원하는 어떤 에이전트에서든 그대로 사용

---

⚙️ 작동 원리 — 점진적 로딩(Progressive Disclosure)

스킬의 핵심 설계 철학입니다. 에이전트는 스킬을 한 번에 다 읽지 않고, 3단계로 나눠 필요한 만큼만 불러옵니다.

단계	불러오는 것	시점
① Discovery (발견)	스킬의 이름·설명만 (약 100토큰)	시작할 때 모든 스킬에 대해
② Activation (활성화)	SKILL.md 본문 전체	작업이 설명과 맞아떨어질 때
③ Execution (실행)	scripts·references·assets 등 리소스	실제로 필요해질 때만

덕분에 에이전트는 수십 개의 스킬을 손에 쥐고도 평소엔 이름·설명만 들고 있어 메모리 부담이 거의 없습니다. 작업이 들어오면 그때 딱 맞는 스킬의 본문을 펼쳐보는 식이죠.

---

🧰 어디서 쓸 수 있나?

이미 수십 개의 AI 도구가 Agent Skills를 지원합니다. 대표적으로 —

Claude Code · Claude · Cursor · GitHub Copilot · VS Code · OpenAI Codex · Gemini CLI · OpenCode · Goose · Amp · Roo Code · Kiro 등.

핵심은 "한 번 만들면 여기저기서 똑같이 동작한다"는 점입니다.

---

🏢 누가, 왜 만들었나?

Agent Skills는 Anthropic(Claude를 만든 회사)이 개발해 오픈 표준으로 공개했습니다. 코드는 Apache 2.0, 문서는 CC-BY-4.0 라이선스라 누구나 기여할 수 있죠.

업계에서는 이 움직임을 Anthropic의 또 다른 표준인 MCP(Model Context Protocol)에 빗댑니다. MCP가 "에이전트가 도구를 쓰는 방식"의 표준이 됐다면, Agent Skills는 "에이전트가 전문 지식을 갖추는 방식"의 표준을 노린다는 것. 실제로 Microsoft(VS Code·Copilot)를 비롯한 주요 도구들이 빠르게 채택 중입니다.

---

✍️ 마무리

정리하면, 스킬은 에이전트에게 끼워주는 '전문 지식 카트리지'이고, 그 본체는 SKILL.md 하나가 든 폴더입니다.

👉 다음 편 → [#2] SKILL.md 규격, 한 장으로 끝내기
필수 필드와 글자 수 제한 같은 구체적인 규칙을 한 장으로 정리합니다.

---

📎 출처: 이 글은 Agent Skills 공식 문서 — Overview (© Anthropic, CC BY 4.0)를 한국어로 번역·재구성한 것입니다.

---

#AgentSkills #에이전트스킬 #Claude #ClaudeCode #Anthropic #SKILLmd #AI에이전트 #MCP #개발생산성