한 문장으로 요약하면: 스킬 설치의 핵심은 딱 하나예요. 스킬 폴더를 AI 도구가 찾을 수 있는 위치에 두는 것. 정확한 위치는 클라이언트마다 다르고, 여기 가장 흔한 세 가지 방법을 소개해요.
설치 전에 알아 둘 것: 스킬은 그저 "파일 + 폴더"예요. 프로그램을 실행해 설치할 필요 없이 파일을 복사하거나(명령어를 실행하거나) 하면 끝나요.
방법 ①: Claude Code (명령줄, 가장 흔함)
개발자라면 Claude Code가 가장 흔한 스킬 설치 경로예요. 설치 방식은 두 가지예요:
A. 다른 사람의 컬렉션 설치 (명령 한 줄)
/plugin marketplace add obra/superpowers ← 스킬 마켓플레이스를 추가해요
/plugin install superpowers@workspace ← 현재 프로젝트에 설치해요(팀과 공유)
/plugin install superpowers@user ← 내 계정에 설치해요(모든 프로젝트에서 사용 가능)
Claude Code 입력창에 (슬래시 포함) 바로 입력하세요. 설치가 끝나면 자동으로 적용돼요.
B. 스킬 폴더를 직접 두기
# 프로젝트에 .claude/skills/ 폴더를 만들고 스킬 폴더를 넣으세요
my-project/
├── .claude/
│ └── skills/
│ └── my-skill/
│ ├── SKILL.md
│ └── scripts/
넣은 뒤에는 Claude Code를 재시작(또는 새 세션 열기)해야 스킬이 인식돼요.
방법 ②: Claude Desktop (그래픽 인터페이스)
- Claude Desktop 열기 → Settings(설정)
- Developer 영역으로 이동
- 스킬 디렉터리 설정을 찾아 로컬 스킬 폴더가 있는 경로를 지정 (예:
~/skills) - 스킬 폴더를 이 디렉터리에 복사 → Claude Desktop 재시작
화면은 버전에 따라 조금씩 달라요. 클라이언트의 "Skills(스킬)" 관련 설정을 참고하세요.
방법 ③: Cursor / VS Code 같은 에디터
- 프로젝트 루트에서 각 AI 플러그인의 스킬 폴더 관례를 사용해요 (예: Cursor의
.cursor/rules/또는 도구의 공식 스킬 경로) - 스킬 폴더를 그 디렉터리에 넣어요
- 창을 다시 로드하면(
Ctrl+Shift+P → Reload Window) 활성화돼요
각 IDE의 스킬 폴더 관례는 버전에 따라 빠르게 바뀌어요. 설치가 잘 안 되면 먼저 플러그인 공식 문서를 확인하세요.
자주 하는 문제 해결
| 문제 | 원인 | 해결 |
|---|---|---|
| 설치했는데 AI가 인식하지 못해요 | 재시작 / 새 세션을 열지 않음 | 재시작하세요. 재시작 전에 폴더 경로 철자를 확인해요 |
| 스킬이 활성화되지 않아요 | description의 트리거 범위가 너무 좁아요 | 흔한 표현을 모두 description에 넣으세요(작성 가이드 참고) |
| "Marketplace not found" 오류 | /plugin은 이 버전에서만 지원돼요 | 클라이언트를 업데이트하거나 "폴더 직접 두기" 방식을 사용하세요 |
| 스킬을 삭제하고 싶어요 | — | 폴더를 삭제하거나 /plugin uninstall을 실행하세요 |
제대로 설치됐는지 어떻게 확인할까요?
- AI 채팅에 트리거 시나리오를 직접 입력해 보세요. 예: "주간 보고서 쓰는 걸 도와줘"
- 출력이 스킬의 형식을 따르는지 확인해요 (예: 보고서가 "성과 / 문제 / 계획" 세 섹션을 사용)
- 활성화되지 않으면 폴더 경로와 description을 확인하세요 (가장 흔한 두 걸림돌이에요)
더 읽을거리
- 무엇을 설치할지: 가장 추천하는 스킬 10선
- 직접 작성하기: 만들기 튜토리얼 / 작성 가이드
- 스킬과 MCP 함께 쓰기: 비교 아티클