1.1 Skills란 무엇인가
Skills는 AI에게 나만의 전문 능력을 추가해주는 플러그인이다. 반복 작업을 한 번 정의해두면 계속 재사용할 수 있다. 업데이트: 2026-03-08
핵심 요약
| 구분 | 내용 |
|---|---|
| 📖 정의 | AI가 특정 방식으로 특정 작업을 수행하도록 미리 설정해두는 재사용 가능한 모듈 |
| 💡 핵심 | 폴더 단위로 구성되며, SKILL.md 파일에 지시사항·메타데이터를 담는다 |
| 🎯 대상 | 반복 작업을 자동화하거나 팀 표준을 공유하려는 개발자 |
| ⚠️ 주의 | Claude Code · Gemini CLI · OpenAI Codex 세 플랫폼이 모두 SKILL.md 형식을 지원하지만, 고급 옵션은 Claude Code 전용이다 |
문서 탐색
목차
1. Skills가 무엇인지 한 줄로 설명하면?
💡 Skills = AI에게 나만의 전문 능력을 추가해주는 플러그인
AI 코딩 도구는 기본적으로 코딩을 지원하는 AI다. Skills를 활용하면 AI가 특정 방식으로 특정 작업을 수행하도록 미리 설정해둘 수 있다.
예를 들면:
- “이 프로젝트에서 커밋할 때는 항상 이 양식을 사용한다”
- “코드 리뷰할 때 보안 취약점도 함께 확인한다”
- “배포할 때는 이 순서대로 진행한다”
이런 반복적인 지시를 매번 타이핑하는 대신, 한 번 만들어두면 계속 사용할 수 있는 것이 Skills다.
2. Skills의 구조
Skills는 폴더 단위로 구성된다. 그 안에 SKILL.md 파일이 있고, 거기에 AI에게 내릴 지시사항이 담겨 있다.
my-skill/
├── SKILL.md ← 필수! 핵심 파일
├── scripts/ ← 선택 (스크립트 파일들)
└── templates/ ← 선택 (템플릿, 리소스 등)
SKILL.md는 두 부분으로 구성된다:
---
name: my-skill-name
description: "이 스킬이 어떤 역할을 하는지 설명"
---
## 지시사항
AI에게 내릴 상세한 지시를 여기에 마크다운으로 작성| 부분 | 역할 |
|---|---|
--- 안의 YAML 부분 | AI가 언제, 어떻게 이 스킬을 쓸지 메타정보 전달 |
| 그 아래 마크다운 | AI가 실제로 따를 구체적인 지시사항 |
3. Skills를 지원하는 AI 플랫폼
Claude Code만의 기능이 아니다. 주요 AI 코딩 도구 3개가 모두 Skills를 공식 지원한다. 세 플랫폼 모두 SKILL.md라는 동일한 파일명을 사용한다.
Claude Code (Anthropic)
Skills를 가장 먼저, 가장 풍부하게 지원하는 플랫폼이다. 저장 위치, 호출 방식, 권한 제어 모두 세밀하게 설정 가능하다.
| 항목 | 내용 |
|---|---|
| 저장 위치 (프로젝트) | .claude/skills/ |
| 저장 위치 (글로벌) | ~/.claude/skills/ |
| 수동 호출 | /skill-name |
| 자동 호출 | description 기반 자동 판단 |
| 주요 옵션 | disable-model-invocation, user-invocable |
| 내장 스킬 | /simplify |
Skills 2.0 지원 (Claude Code 전용)
Skills 2.0은 Claude Code 2.1.0부터 지원한다. Gemini CLI · OpenAI Codex에는 없는 기능이다.
| 기능 | 옵션 / 설명 |
|---|---|
| Context Fork | context: fork — 메인 세션과 격리된 독립 환경에서 스킬 실행 |
| Hot Reload | SKILL.md 저장 즉시 반영 — 재시작 불필요 |
| Agent-Scoped Hooks | hooks: — 스킬 실행 중에만 활성화되는 전용 훅 (PreToolUse / PostToolUse / Stop) |
| Evals + A/B 테스트 | skill-creator 스킬로 스킬 품질을 객관적으로 측정·비교 |
| 스킬 유형 분류 | Capability Uplift (기능 확장) / Workflow (반복 자동화) 공식 카테고리 |
| 커스텀 에이전트 | agent: — 역할에 최적화된 에이전트를 스킬에 지정 |
자세한 사용법 → 1.2 Skills 만들기 § 1.7 Skills 2.0
Gemini CLI (Google)
Google이 공식 지원하는 오픈소스 터미널 AI다. Claude Code와 거의 동일한 SKILL.md 구조를 사용한다. Claude Code에서 만든 스킬을 Gemini CLI에서 그대로 사용할 수 있다.
| 항목 | 내용 |
|---|---|
| 저장 위치 (프로젝트) | .gemini/skills/ |
| 저장 위치 (글로벌) | ~/.gemini/skills/ |
| 수동 호출 | 없음 (자동 호출만 지원) |
| 자동 호출 | description 기반 자동 판단 |
| 원격 설치 | gemini skill install [경로 또는 URL] |
| 무료 사용 | 1,000회/일 |
OpenAI Codex (OpenAI)
오픈소스 CLI + 클라우드 에이전트다.
달러 사인($)으로 스킬을 명시적으로 호출하는 것이 Claude Code와 다른 점이다.
| 항목 | 내용 |
|---|---|
| 저장 위치 (프로젝트) | .codex/skills/ |
| 저장 위치 (글로벌) | ~/.codex/skills/ |
| 수동 호출 | $skill-name |
| 자동 호출 | description 기반 자동 판단 |
| 내장 스킬 | $skill-creator, $skill-installer |
4. 플랫폼별 Skills 기능 비교
| 항목 | Claude Code | Gemini CLI | OpenAI Codex |
|---|---|---|---|
| 공식 지원 | O | O | O |
| SKILL.md 파일 | O | O | O |
| 저장 위치 (프로젝트) | .claude/skills/ | .gemini/skills/ | .codex/skills/ |
| 저장 위치 (글로벌) | ~/.claude/skills/ | ~/.gemini/skills/ | ~/.codex/skills/ |
| 수동 호출 | /skill-name | 없음 | $skill-name |
| 자동 호출 | O (description 기반) | O (description 기반) | O (description 기반) |
| 자동 호출 비활성화 | disable-model-invocation: true | 없음 | 없음 |
| 사용자 호출 비활성화 | user-invocable: false | 없음 | 없음 |
| 격리 실행 (2.0) | context: fork | 없음 | 없음 |
| 스킬별 훅 (2.0) | hooks: | 없음 | 없음 |
| Hot Reload (2.0) | O | 없음 | 없음 |
| Evals / A/B 테스트 (2.0) | O | 없음 | 없음 |
| 원격 설치 | 직접 복사 | gemini skill install URL | $skill-installer |
| 내장 스킬 | /simplify | 없음 | $skill-creator, $skill-installer |
| 타 플랫폼 스킬 호환 | — | Claude Code 스킬 호환 O | 제한적 |
| 무료 사용 | 없음 | 1,000회/일 | 제한적 |
5. Skills vs 다른 설정 방식
| 기능 | 역할 | 적용 범위 |
|---|---|---|
CLAUDE.md / GEMINI.md / AGENTS.md | 프로젝트 전반의 규칙·맥락 저장 | 항상 적용 |
| 슬래시/달러 커맨드 | 단순 프롬프트 템플릿을 불러오는 명령어 | 호출 시 적용 |
| Skills | 지시사항 + 스크립트 + 파일을 묶은 모듈 | 선택적 적용 |
Skills는 스크립트나 템플릿 파일도 함께 묶을 수 있어서 단순 커맨드보다 강력하다.