명령줄 없이 설치하기
여기서 설치란 한 가지입니다. 일반 텍스트 파일로 된 폴더 여섯 개를, 쓰고 계신 AI 도구가 이미 읽는 폴더 하나에 넣는 일입니다. 작업은 Finder나 파일 탐색기에서 합니다. 터미널은 쓰지 않으며, 이 페이지는 터미널을 열라고 요청하지 않습니다.
시작하기 전에
- zip 파일 여섯 개를 가지고 있습니다.
- 이 페이지에서 설치할 수 있는 도구 가운데 하나를 쓰고 있습니다. Claude Code, Codex, Cursor 중 하나입니다.
Claude Code
가장 쉬운 방법 — 추천처음부터 끝까지 클릭만으로 되는 방법입니다. 데스크톱 앱에 대한 Anthropic의 안내 문서는 터미널이 필요하지 않다고 명시하고 있습니다.
- 브라우저에서 claude.com/download를 열고 macOS 또는 Windows용 Claude 데스크톱 앱을 내려받습니다.
- 다른 앱을 설치하듯 설치한 뒤 실행하고 로그인합니다. Code 탭은 유료 Claude 요금제(Pro, Max, Team, Enterprise)가 있어야 합니다.
- Code 탭을 클릭합니다. 그래픽 화면이 있는 Claude Code이며, 앱에 이미 포함되어 있으므로 먼저 따로 설치할 명령줄 도구가 없습니다.
- 내려받은 zip 파일 여섯 개의 압축을 풉니다. 각각 스킬 이름을 딴 폴더 하나로 풀립니다. lesson-workflow, worksheet-workflow, ppt-workflow, word-workflow, audio-workflow, report-workflow입니다.
- Finder(macOS)나 파일 탐색기(Windows)에서 홈 폴더를 엽니다. macOS에서는 .claude 폴더가 숨겨져 있으므로 Cmd + Shift + .를 눌러 숨긴 항목을 표시합니다. 이곳은 터미널이 아니라 Finder입니다.
- .claude 폴더를 열고 그 안의 skills 폴더를 엽니다. skills 폴더가 없으면 새로 만듭니다. 마우스 오른쪽 버튼을 누르고 새 폴더를 골라 이름을 skills로 정하면 됩니다.
- 스킬 폴더 여섯 개를 그 skills 폴더 안으로 복사합니다. 스킬마다 폴더 하나씩이고, 각 폴더 안에는 자기 SKILL.md가 그대로 들어 있어야 합니다. 완성된 모습은 ~/.claude/skills/lesson-workflow/SKILL.md이며, 나머지 다섯도 같은 방식입니다.
- 더 할 일은 없습니다. Claude Code는 이 폴더를 지켜보며, Anthropic 문서에 따르면 스킬 편집은 곧바로 반영됩니다. 다시 실행할 필요가 없습니다.
알아 두실 점 두 가지입니다. 첫째, ~/.claude/skills/는 로컬 Code 탭이 읽는 위치입니다. Cowork과 클라우드 세션은 claude.ai 계정에서 동기화한 스킬을 쓰므로 이 폴더를 보지 않습니다. 둘째, 스킬 폴더 이름을 synced로 짓지 마세요. 그 이름은 예약되어 있습니다.
Codex
▸
Codex는 같은 SKILL.md 폴더를 읽습니다. 다만 솔직히 말씀드릴 점이 있습니다. Codex에는 내려받은 스킬 폴더를 올리는 버튼이 없습니다. 폴더를 직접 복사해 넣는 것이 지원되는 방법이며, OpenAI 문서도 이를 수동 작업으로 설명합니다.
- 아직 하지 않았다면 zip 파일 여섯 개의 압축을 풉니다. 각각 스킬 이름을 딴 폴더 하나로 풀립니다.
- Finder(macOS)나 파일 탐색기(Windows)에서 홈 폴더를 엽니다. macOS에서는 .agents 폴더가 숨겨져 있으므로 Cmd + Shift + .를 눌러 숨긴 항목을 표시합니다.
- .agents 폴더를 열고 그 안의 skills 폴더를 엽니다. skills 폴더가 없으면 새로 만들어 이름을 skills로 정합니다.
- 스킬 폴더 여섯 개를 그 안으로 복사합니다. 스킬마다 폴더 하나씩입니다. 완성된 모습은 ~/.agents/skills/lesson-workflow/SKILL.md이며, 나머지 다섯도 같은 방식입니다.
- Codex는 보통 새 스킬을 스스로 알아차립니다. 그래도 나타나지 않으면 Codex를 완전히 종료했다가 다시 실행합니다.
스킬을 쓰려면 Codex의 채팅 입력창에 $를 입력하고 목록에서 고릅니다. $는 터미널이 아니라 채팅 입력창에 넣습니다.
Google Gemini
▸
Gemini CLI는 같은 스킬 폴더를 지원합니다. 다만 Google이 안내하는 설치 방법은 모두 직접 입력하는 명령입니다. 폴더를 끌어다 놓을 창은 없습니다.
gemini.google.com의 Gemini 앱은 스킬 폴더를 아예 읽지 않습니다. 그 앱의 사용자 설정 기능은 Gems이며, 스킬과는 다른 것입니다.
그래서 솔직한 답은 이렇습니다. 클릭만으로 설치하고 싶다면 Claude Code를 쓰세요. 이미 Gemini CLI를 쓰고 있고 한 줄 입력이 괜찮다면, 명령은 사용 안내 페이지에 있습니다.
Cursor
▸
Cursor는 Claude의 폴더에서도 스킬을 불러옵니다. 따라서 Cursor를 쓰신다면 같은 ~/.claude/skills/ 설치로 스킬 여섯 개를 그대로 쓸 수 있습니다. 이 호환성은 Cursor 자체 문서에 적혀 있습니다.
제대로 됐는지 확인하기
폴더 이름이 곧 명령 이름입니다. 도구를 열고 목록에 여섯 이름이 있는지 확인합니다.
-
Claude Code
입력창에 /를 입력합니다. 목록에 여섯 이름이 나타나야 합니다.
-
Codex
채팅 입력창에 $를 입력하고 목록에서 고릅니다.
안 됐을 때 확인할 것
- 폴더가 숨겨져 있는 경우입니다. macOS에서는 Finder에서 Cmd + Shift + .를 눌러 숨긴 항목을 표시합니다. Finder의 이동 메뉴에서 폴더로 이동을 고르고 ~/.claude/skills를 입력해도 됩니다. 그 입력창은 터미널이 아니라 Finder의 것입니다.
- 압축이 폴더 안에 또 폴더가 생기게 풀려서 SKILL.md가 한 단계 더 깊이 들어간 경우입니다. 스킬 폴더를 열어 SKILL.md가 그 안에 바로 있는지 확인합니다. 다른 폴더 안에 들어가 있으면 한 단계 위로 옮깁니다.
- 폴더 이름을 바꾼 경우입니다. 폴더 이름이 곧 명령 이름이므로 이름을 바꾸면 입력할 이름도 달라집니다. 또한 폴더 이름을 synced로 짓지 마세요. 그 이름은 예약되어 있습니다.