Claude Code 스킬 & 플러그인 시스템 학습 — 스킬 종류, 저장 위치, 공식 플러그인 목록

학습 배경

오늘 프로젝트 폴더에서 /skills 슬래시 명령어를 실행했는데 아무 스킬도 안 보여서, 스킬 시스템의 구조와 설정 방법을 학습하게 됨.

---

1. 스킬의 3가지 종류

구분	설명	위치	예시
빌트인 스킬	Claude Code 자체에 내장. 설치 불필요, 어디서든 사용 가능	Claude Code 내부	simplify, loop, claude-api, keybindings-help
플러그인 스킬	마켓플레이스에서 설치한 플러그인에 포함된 스킬	~/.claude/plugins/	skill-creator, frontend-design, playground 등
사용자 스킬	직접 만들거나 복사해서 넣은 스킬	~/.claude/skills/ (글로벌) 또는 .claude/skills/ (프로젝트)	직접 작성한 SKILL.md

실사용에서는 구분을 외울 필요 없음. / 치고 보이면 쓰고, 안 보이면 추가하면 됨.

---

2. 스킬 저장 위치와 우선순위

Project (.claude/skills/) > Global (~/.claude/skills/) > Enterprise (관리자 고정 정책)

• 글로벌 스킬: ~/.claude/skills/<스킬이름>/SKILL.md (또는 ~/.config/claude/skills/) → 모든 프로젝트에서 사용 가능
• 프로젝트 스킬: .claude/skills/<스킬이름>/SKILL.md → 해당 프로젝트에서만 사용
• 같은 이름이면 프로젝트 레벨이 글로벌을 오버라이드. Enterprise는 관리자 정책이라 사용자가 오버라이드 불가

---

3. 오늘 해결한 문제

문제

플러그인으로 설치된 스킬이 프로젝트 폴더에서 /skills 목록에 안 보임

원인

~/.claude/skills/ 폴더 자체가 존재하지 않았음. 플러그인 스킬은 ~/.claude/plugins/ 안에만 있었고, 자동 탐색이 안 되는 상황이었음.

해결 (임시 우회)

플러그인 스킬들을 글로벌 스킬 폴더로 복사:

mkdir -p ~/.claude/skills/<스킬이름>
cp ~/.claude/plugins/marketplaces/claude-plugins-official/plugins/<플러그인>/skills/<스킬>/SKILL.md ~/.claude/skills/<스킬이름>/

⚠️ 참고: 이것은 당시 임시 우회였음. 정상적으로 플러그인 스킬은 자동 탐색되어야 하며, 당시 설정 문제 또는 버그였을 가능성이 높음.

---

4. 공식 플러그인 저장소 (claude-plugins-official)

GitHub: anthropics/claude-plugins-official

저장소 구조

claude-plugins-official/
├── plugins/            # Anthropic 개발 공식 플러그인
├── external_plugins/   # 승인된 서드파티 플러그인
└── README.md

각 플러그인 구조

plugin-name/
├── .claude-plugin/
│   └── plugin.json     # 메타데이터 (필수)
├── .mcp.json           # MCP 서버 설정 (선택)
├── commands/           # 슬래시 커맨드 (선택)
├── agents/             # 에이전트 정의 (선택)
├── skills/             # 스킬 정의 (선택)
└── README.md

설치 방법

• CLI: /plugin install {plugin-name}@claude-plugin-directory
• GUI: /plugin > Discover

포함된 플러그인 목록

플러그인	스킬
skill-creator	새 스킬 만들기
frontend-design	프론트엔드 디자인
playground	플레이그라운드
claude-md-management	CLAUDE.md 개선
claude-code-setup	자동화 추천
hookify	룰 작성
plugin-dev	agent, command, hook, mcp, plugin, skill 개발 (7개 스킬)
stripe (external)	Stripe 베스트 프랙티스

보안 주의

• 신뢰하는 플러그인만 설치할 것
• Anthropic은 플러그인 내 MCP 서버, 파일 등을 직접 제어하지 않음

---

5. 핵심 정리

1. 스킬 사용법: / 입력 → 목록에서 선택 → 실행
2. 안 보일 때: ~/.claude/skills/에 SKILL.md 복사하면 글로벌로 사용 가능
3. 프로젝트 전용 커스터마이즈: .claude/skills/에 같은 이름으로 오버라이드
4. 새 플러그인 설치: /plugin install 또는 /plugin > Discover
5. 공식 저장소: github.com/anthropics/claude-plugins-official

---

출처

• Claude Code Skills 공식 문서
• Claude Code Plugins 공식 문서
• Claude Code 설정 문서
• claude-plugins-official (GitHub)