스킬 설치 가이드

스킬이 무엇인가요

스킬은 클로드에게 주는 업무 매뉴얼입니다. 「보고서를 쓸 때는 결론을 맨 위에 두고, 수치에는 출처를 붙인다」 같은 규칙을 파일 하나에 적어 두면, 클로드가 필요할 때 그 파일을 읽고 그대로 따릅니다. 매번 같은 설명을 다시 할 필요가 없어집니다.

스킬 화면에서 「설치 프롬프트 복사」를 누르고, 복사된 글을 내 클로드에 그대로 붙여넣으세요. 클로드가 어디에 넣을지 물어본 뒤 직접 받아서 설치합니다. 제목을 누르면 그 스킬의 원본을 먼저 볼 수 있습니다.

스킬 하나는 폴더 하나입니다. 그 안에 SKILL.md 가 있고, 필요하면 참고 파일이 딸려 있습니다. 어느 도구든 이 폴더를 정해진 자리에 두면 그때부터 읽습니다.

어디에 설치되나요

도구마다 스킬 폴더를 읽는 자리가 정해져 있습니다. 전역은 내 모든 프로젝트에서, 이 프로젝트는 그 저장소 안에서만 쓰입니다.

윈도우에서 ~ 는 사용자 폴더(%USERPROFILE%)입니다. 「이 프로젝트」는 저장소 맨 위, 즉 .git 폴더가 있는 자리 기준입니다. 클로드 코드의 설정 폴더를 CLAUDE_CONFIG_DIR 로 옮겨 두었다면 전역 자리도 그 아래 skills 입니다.

클로드 코드(Claude Code)에 적용하기

1. 스킬 화면에서 「설치 프롬프트 복사」를 누릅니다. 원본 주소와 설치 방법이 함께 복사됩니다.
2. 클로드 코드를 열고 복사한 글을 그대로 붙여넣습니다. 모든 프로젝트에서 쓸지 지금 프로젝트에서만 쓸지 클로드가 물어보면 골라 주세요.
3. 설치가 끝나면 클로드 코드를 다시 열고 채팅창에 / 를 칩니다. 설치된 스킬이 목록에 나타납니다. /스킬이름 으로 직접 부를 수도 있고, 스킬 설명에 맞는 요청을 하면 클로드가 알아서 읽습니다.

직접 넣고 싶다면 원본 저장소에서 스킬 폴더를 받아 위 표의 자리에 그대로 옮기면 됩니다. RAISE LAB이 만든 스킬은 상세 화면에서 압축 파일로도 받을 수 있습니다.

코덱스(Codex)에 적용하기

복사한 프롬프트는 코덱스에 붙여넣어도 됩니다. 다만 프롬프트가 일러 주는 자리는 클로드 코드의 폴더이므로, 코덱스에는 아래 자리에 넣어 달라고 한 줄 덧붙이거나 직접 넣습니다.

폴더를 받아 넣으려면 원본 저장소에서 받은 폴더나 상세 화면의 압축 파일을 코덱스 스킬 폴더에 두세요.

# macOS / Linux
mkdir -p ~/.agents/skills
unzip -o report-writer-1.0.zip -d ~/.agents/skills/

# Windows PowerShell
New-Item -ItemType Directory -Force "$HOME\.agents\skills" | Out-Null
Expand-Archive -Force report-writer-1.0.zip -DestinationPath "$HOME\.agents\skills"

이미 클로드 코드에 설치했다면 같은 폴더를 링크해 두 도구가 함께 쓰게 합니다.

# macOS / Linux
mkdir -p ~/.agents/skills
ln -s ~/.claude/skills/report-writer ~/.agents/skills/report-writer

# Windows PowerShell (관리자 권한 또는 개발자 모드)
New-Item -ItemType SymbolicLink -Path "$HOME\.agents\skills\report-writer" -Target "$HOME\.claude\skills\report-writer"

프로젝트에서만 쓰려면 저장소 안 .agents/skills/ 에 같은 방법으로 넣습니다. 보통은 새 폴더를 바로 읽습니다. 목록에 안 보이면 코덱스를 다시 엽니다. 코덱스 안에서 $skill-installer 로 skills.sh 의 공개 스킬을 바로 설치할 수도 있습니다.

잘 안 될 때

• 폴더 바로 안에 SKILL.md 가 있어야 합니다. 압축을 풀었더니 폴더가 한 겹 더 생겼다면 안쪽 폴더를 꺼내 올립니다.
• 설치했는데 목록에 안 보이면 폴더가 어디에 들어갔는지 클로드에게 물어보세요. 위 표의 자리가 아니면 옮기면 됩니다.
• 같은 이름의 스킬이 둘 보이면 skills 폴더 안에 백업 폴더가 들어가 있는지 봅니다. 백업은 skills-backup 처럼 스킬 폴더 밖에 있어야 합니다.
• 새 판이 나오면 같은 프롬프트를 다시 붙여넣습니다. 원본 저장소에서 받으므로 늘 최신판이 들어옵니다.
• 공개 저장소에서 온 스킬은 그 저장소의 라이선스를 따릅니다. 상세 화면에 출처와 라이선스를 함께 적어 두었으니 받기 전에 한 번 보세요.