Agent Skills – AI 에이전트의 능력을 확장하는 스킬 시스템

스킬이란?
누구에게 유용한가?
좋은 스킬 작성법 (8가지 팁)
1. 설명(Description)을 정확하게 작성하라
2. 지침(Instructions)을 작성하되 에세이는 쓰지 마라
3. 간결하게 유지하라
4. 자유도를 적절히 설정하라
5. 부정 케이스를 빠뜨리지 마라
6. 배포 전 테스트하라
7. 은퇴 시점을 알아라
어떤 에이전트 플랫폼에서 사용하는가?
스킬 마켓플레이스 & 디렉터리
관련 연구 논문
라이선스
관련 도구
관련 문서
관련 자료

Agent Skills는 AI 에이전트에게 특정 기능이나 워크플로우를 부여하는 플러그인 방식의 확장 메커니즘으로, SKILL.md 파일을 핵심으로 하는 폴더 구조로 구성되며 에이전트가 언제 어떤 방식으로 스킬을 사용할지를 정의한다.

스킬이란?

스킬은 에이전트가 기본적으로 할 수 없는 작업을 가능하게 하거나(기능 스킬), 특정 팀의 워크플로우 방식을 일관되게 따르도록(선호도 스킬) 하는 확장 단위다.

my-skill/
├── SKILL.md          ← 유일한 필수 파일
├── scripts/          ← 에이전트가 실행하는 재사용 가능한 코드
├── references/       ← 에이전트가 필요 시 읽는 문서
└── assets/           ← 템플릿, 이미지, 출력물

두 가지 유형:

기능 스킬 (Capability skills): 모델이 일관되게 할 수 없는 작업 처리 (예: PDF 양식 작성). 모델 성능 향상에 따라 필요 없어질 수 있음
선호도 스킬 (Preference skills): 팀 고유 워크플로우 인코딩 (예: 코드 리뷰 절차). 실제 프로세스와 동기화 필요

누구에게 유용한가?

AI 에이전트를 운영하는 개발자: 에이전트의 행동을 세밀하게 제어하고 싶을 때
팀 워크플로우를 자동화하려는 조직: 코드 리뷰, 배포, 문서화 등의 절차를 에이전트에 내재화할 때
Claude Code, Codex 등 코딩 에이전트 사용자: 반복 작업을 스킬로 캡슐화해 재사용할 때

좋은 스킬 작성법 (8가지 팁)

1. 설명(Description)을 정확하게 작성하라

SKILL.md의 description 필드가 트리거 메커니즘이다. 설명만 개선해도 성능이 50% 향상되는 경우가 있다.

모호한 예	구체적인 예
“문서 관련 도움”	“.docx 파일 생성·편집·분석, 추적 변경사항·댓글·서식·텍스트 추출 시 사용”
“API 도우미”	“Gemini API로 텍스트 생성, 멀티턴 채팅, 이미지 생성, 스트리밍 코드 작성 시 사용”

2. 지침(Instructions)을 작성하되 에세이는 쓰지 마라

지시문을 사용하라: “항상 interactions.create()를 사용하라”, “Interactions API가 권장 방식이다”가 아닌
예시를 먼저 제시하라: 5줄 코드 예제 > 5단락 설명
이유를 설명하라: 규칙의 이유를 알면 에이전트가 일반화 가능

3. 간결하게 유지하라

에이전트는 정보를 단계적으로 로드한다:

항상 로드: frontmatter (name + description)
스킬 트리거 시 로드: SKILL.md 본문 (500줄 이하 권장)
필요 시 로드: 참조 파일, 스크립트, assets

여러 주제가 있으면 별도 참조 파일로 분리하라.

4. 자유도를 적절히 설정하라

절차를 지시하지 말고 달성할 목표를 설명하라:

× “1단계: config 파일 읽기. 2단계: DB URL 찾기. 3단계: 포트 번호 업데이트.”
○ “사용자가 지정한 값으로 config 파일의 데이터베이스 포트를 업데이트하라.”

정확한 단계가 중요하다면 스킬이 아닌 스크립트를 작성하라.

5. 부정 케이스를 빠뜨리지 마라

스킬이 발동하지 않아야 할 경우를 명시하라:

“PDF 파일 작업 시 사용. 일반 문서 편집, 스프레드시트, 일반 텍스트 파일에는 사용하지 마라.”

6. 배포 전 테스트하라

다양한 프롬프트로 수동 실행 (3~5회 시도)
“성공”의 기준을 측정 가능하게 정의
10~20개 테스트 프롬프트 (처리/무시/엣지 케이스 혼합)
매 실행마다 격리된 환경 사용

7. 은퇴 시점을 알아라

스킬 없이 평가(eval)를 실행해 통과하면, 모델이 스킬의 가치를 흡수한 것이다. 스킬을 은퇴시켜라. 모델이 발전함에 따라 기능 스킬은 특히 이런 경향이 강하다.

어떤 에이전트 플랫폼에서 사용하는가?

agentskills.io가 Agent Skills 공식 허브로, 2026년 현재 37개 이상의 플랫폼이 스킬 시스템을 지원한다. 주요 플랫폼:

플랫폼	설명
Claude Code	`~/.claude/skills/` 폴더, Anthropic 공식 지원
Claude	claude.ai 웹 인터페이스, 스킬 지원
OpenAI Codex	OpenAI의 CLI 에이전트
Gemini CLI	터미널용 오픈소스 Gemini 에이전트
GitHub Copilot	VS Code 코파일럿 에이전트 스킬 지원
VS Code	GitHub Copilot 통해 에이전트 스킬 지원
Cursor	AI 코드 에디터, 네이티브 통합
Junie	JetBrains IntelliJ 플랫폼 기반 LLM 불가지론 코딩 에이전트
Amp	최신 모델 기반 프론티어 코딩 에이전트
Roo Code	VS Code 확장 및 클라우드 에이전트
Goose	Linux Foundation 산하 오픈소스 범용 에이전트
OpenCode	터미널·IDE·데스크탑 오픈소스 AI 코딩 에이전트
OpenHands	클라우드 코딩 에이전트 오픈 플랫폼, 모델 불가지론
Mux	병렬 코딩 에이전트 실행, 격리 워크트리 기반
Letta	장기 기억 기반 스테이트풀 에이전트 플랫폼
Firebender	Android 전용 코딩 에이전트, 에뮬레이터 테스트 자동화
Mistral Vibe	Mistral의 CLI 코딩 어시스턴트
TRAE	ByteDance의 적응형 AI IDE
Spring AI	Java Spring 기반 AI 앱 개발 프레임워크
Kiro	스펙 주도 개발(Spec-Driven Development) AI 코딩 에이전트
Snowflake Cortex Code	Snowflake 플랫폼 내장 데이터 엔지니어링 에이전트
Databricks Genie Code	Databricks 데이터 작업 전용 자율 AI 에이전트
Factory	IDE·CI/CD 통합 AI 네이티브 소프트웨어 개발 플랫폼
Qodo	코드 무결성 중심 리뷰·테스트·작성 에이전트 플랫폼
Laravel Boost	Laravel 모범 사례 지식을 에이전트에 주입하는 스킬셋
Emdash	병렬 에이전트 + 격리 git 워크트리, 로컬·원격 SSH 지원
fast-agent	코딩·평가·스킬 개발용 경량 LLM 상호작용 프레임워크
nanobot	터미널·Telegram·Discord 등 다채널 초경량 오픈소스 에이전트
Ona	백그라운드 에이전트 팀을 클라우드에서 운영하는 플랫폼

스킬 마켓플레이스 & 디렉터리

개인·팀이 만든 스킬을 검색·공유·배포하는 플랫폼:

agentskill.sh — 44,000개+ 스킬, 2단계 보안 스캔, /learn 인스톨러 내장
SkillsMP — 스킬 마켓플레이스
Skillstore — 큐레이션 마켓플레이스
skills.sh — 스킬 디렉터리 + 리더보드
SkillsDirectory — 인기 스킬 디렉터리

라이선스

스킬 시스템 자체는 각 플랫폼(Claude Code, Codex, Cursor 등)의 오픈 규격을 따른다. 개별 스킬의 라이선스는 제작자가 결정하며, VoltAgent/awesome-agent-skills에 수록된 대부분의 공식 스킬은 MIT 또는 Apache-2.0으로 공개된다.

AI Sparkup