Claude Code 스킬 설치 방법 (Codex, Cursor 및 Gemini CLI용 스킬 포함)

Claude Code 스킬은 SKILL.md 파일이 있는 폴더입니다. 스킬을 설치한다는 것은 해당 폴더를 Claude Code가 찾는 위치에 넣고 새 세션을 시작하는 것을 의미합니다. 이 가이드에서는 스킬이 존재하는 세 가지 장소, 스킬을 설치하는 세 가지 방법(폴더 복사, 플러그인 설치 또는 SkillGild CLI 사용), 로드 확인 방법, 로드가 안 될 때의 대처 방법, 그리고 Codex, Cursor 및 Gemini CLI에 대한 동일한 단계를 다룹니다.

Claude Code가 스킬을 찾는 위치

옵션 1: GitHub에서 폴더 복사하기

대부분의 커뮤니티 스킬은 공개 리포지토리 내의 폴더입니다. 해당 리포지토리를 클론하고 폴더를 복사합니다:

git clone --depth 1 https://github.com/obra/superpowers /tmp/superpowers
cp -r /tmp/superpowers ~/.claude/skills/superpowers

skills/ 아래에 여러 스킬을 담고 있는 리포지토리의 경우, 원하는 것을 복사합니다:

git clone --depth 1 https://github.com/mattpocock/skills /tmp/mattpocock-skills
cp -r /tmp/mattpocock-skills/skills/grill-me ~/.claude/skills/grill-me

설치하기 전에 SKILL.md와 모든 스크립트를 읽어보세요. 스킬은 사용자의 장치에서 코드를 실행할 수 있으므로, 이름이 지정된 유지 관리자와 라이선스 파일이 있는 스킬을 선호하는 것이 좋습니다.

옵션 2: SkillGild CLI로 설치하기

SkillGild CLI는 나열된 모든 커뮤니티 스킬에 대해 클론 및 복사 작업을 수행하며, 각 스킬이 어느 폴더에 존재하는지 알고 있습니다:

curl -fsSL https://raw.githubusercontent.com/SkillGild/skillgild/main/scripts/install-cli.sh | sh
skillgild install grill-me --agent claude-code

저장소(repository)를 복제하고, 스킬 폴더를 ~/.claude/skills/grill-me/로 복사한 다음, 라이선스와 작성자를 출력합니다. 대신 현재 프로젝트에 설치하려면 --target .claude/skills를 추가하거나, 기존 사본을 덮어쓰려면 --force를 사용하세요. SkillGild의 모든 스킬 페이지에는 해당 슬러그(slug)와 함께 이 명령이 표시되며, 프로젝트가 플러그인이나 npx 명령으로 게시할 때 그 옆에 나타납니다.

옵션 3: 플러그인 설치하기

Claude Code 플러그인을 게시하는 프로젝트는 Claude Code 내부에서 설치할 수 있습니다:

/plugin marketplace add anthropics/claude-plugins-official
/plugin install frontend-design@claude-plugins-official

플러그인은 여러 스킬과 명령, 에이전트(agent), MCP 서버를 포함할 수 있습니다. 작동 방식 및 일반 폴더가 더 간단한 경우에 대해서는 Claude Code 플러그인을 참조하세요.

호스팅된 SkillGild 스킬 설치하기

호스팅된 스킬은 폴더에서 실행되는 것이 아니라 SkillGild를 통해 실행되므로, CLI에 로그인하고 MCP 서버를 한 번 등록해야 합니다:

skillgild login
claude mcp add --scope user skillgild -- $(command -v skillgild) mcp
skillgild install academic-plotting --agent claude-code

이 설치 과정은 ~/.claude/skills/academic-plotting/에 작은 래퍼(wrapper)를 작성하여 Claude에게 세션을 시작하는 방법을 알려줍니다. 스킬의 가이드와 서버 도구는 접근 권한 확인 후 SkillGild로부터 도착합니다. 무료 호스팅 스킬에는 월간 실행 횟수가 포함되어 있으니, 각 목록에서 약관을 확인하세요.

로드되었는지 확인하기

새 세션을 시작하고 스킬 이름을 언급하지 않고 자연어로 작업을 요청해 보세요:

Grill me on this plan before I start: migrate the auth service to the new token format.

Claude는 스킬을 사용할 때 말하거나, 행동(behaviour)에서 그 단계를 볼 수 있습니다. 최신 버전에서는 /grill-me를 입력하여 스킬을 직접 호출할 수도 있으며, 슬래시 메뉴에는 설치된 목록이 표시됩니다.

문제 해결

문제 해결

• 아무 일도 일어나지 않음. 경로를 확인하세요: ~/.claude/skills/<name>/SKILL.md 파일이 폴더의 최상위 레벨에 있어야 하며, 클론된 폴더 안의 하위 폴더에 중첩되어 있으면 안 됩니다.
• 스킬은 존재하지만 절대 트리거되지 않음. 스킬의 description이 사용자가 요청하는 방식과 일치하지 않습니다. SKILL.md를 열어 설명을 읽고 그 단어를 사용하거나, 이름으로 호출하세요.
• 프론트매터 오류. --- 블록은 파일의 맨 처음에 위치해야 하며, 그 안에 name:과 description:이 포함되어야 하고, name은 폴더 이름과 일치해야 합니다.
• 어제는 작동했는데 오늘 안 함. 세션은 시작 시 스킬을 로드합니다. 변경 사항이 있을 때마다 세션을 다시 시작하세요.
• CLI가 해당 폴더에 SKILL.md 파일이 없다고 함. 목록의 폴더 경로가 잘못되었거나 프로젝트가 이동시켰습니다. 스킬 페이지에서 수동 명령어를 사용하고, 그 페이지의 보고서 링크를 통해 알려주세요.
• 호스팅된 스킬이 로그인하라고 함. skillgild login을 실행하고 MCP 서버가 claude mcp list에 나열되어 있는지 확인하세요.

다른 에이전트들

폴더 형식은 open Agent Skills 표준을 따르므로, 동일한 스킬이 다른 곳에서도 작동합니다. 위치만 달라질 뿐입니다:

무엇을 먼저 설치해야 할까요

아직 아무것도 설치하지 않았다면: 플래닝 스킬(grill-me 또는 Superpowers) 하나, 라이팅 스킬(Humanizer) 하나, 그리고 최고의 Claude Code 스킬에서 당신의 주요 업무에 관련된 스킬을 설치하세요. 그런 다음 Claude 스킬 생성 방법을 따라 매주 하는 일에 대한 자신만의 스킬을 작성해 보세요.

Originally published at skillgild.dev.