짧은 답변
- 1모든 프로젝트에서 쓰려면 Skill 폴더를
~/.claude/skills/에, 저장소 하나에서만 쓰려면.claude/skills/에 두세요. - 2Skillry CLI로 설치하나요?
--agent claude-code를 추가하세요. 빠뜨리면 Skill이 Claude Code가 읽지 않는~/.agents/skills/에 설치됩니다. - 3
/skills를 입력해 있는지 확인한 다음,/skill-name과 요청을 입력해 실행하세요. - 4바로 쓸 수 있는 Skill이 필요한가요? 명령어 하나로 설치할 수 있는 Claude Code Skills를 둘러보세요.
Claude Code에 Skills를 추가하는 방법
설치 프롬프트를 Claude Code에 붙여 넣거나, Skillry CLI를 직접 실행하거나, 폴더를 직접 복사할 수 있습니다. 어떤 방법이든 결과는 같습니다. Skill 폴더가 ~/.claude/skills/ 안에 놓이게 됩니다.
많이들 놓치는 플래그 하나
Skillry CLI는 Codex와 Cursor가 모두 읽는 ~/.agents/skills/에 기본으로 설치합니다. Claude Code는 자체 폴더인 ~/.claude/skills/를 읽습니다. --agent claude-code를 빠뜨려도 설치는 성공했다고 나오지만, Claude Code는 그 Skill을 볼 수 없습니다.
- 1
Skillry에서 Skill을 열고 설치 프롬프트 복사를 선택한 다음, 대화 상자에서 복사를 선택하세요.
- 2
Claude Code에 붙여 넣고 보내세요. 에이전트가 Skillry의 설치 안내를 읽고 알맞은 명령어를 직접 실행합니다.
설치 프롬프트 Read https://skillry.dev/skills/<slug>/install.md and follow the instructions to install the skill. - 3
브라우저에서 기기 코드 승인을 요청하면 승인하세요.
다음이 보여야 합니다: Claude Code에서 설치한 버전과 사용한 폴더(
~/.claude/skills/아래)를 알려 주는 메시지.
- 1
한 번 로그인하세요. 브라우저 창이 열리고 승인할 기기 코드가 표시됩니다.
터미널 npx --yes skillry-cli@latest login - 2
끝에
--agent claude-code를 붙여 설치하세요.터미널 npx --yes skillry-cli@latest install <slug> --agent claude-code다음이 보여야 합니다:
Installed <slug> <version> to ~/.claude/skills/<slug>
Skill 페이지에서 ZIP 다운로드를 선택하거나, 다른 곳에서 받은 Skill 폴더를 사용하세요. 에이전트는 그 지침을 따르고 스크립트를 실행할 수 있으므로, 설치하기 전에 SKILL.md와 scripts/의 내용을 읽어 보세요. 그런 다음 폴더 전체를 옮기세요.
mkdir -p ~/.claude/skills
mv ~/Downloads/my-skill ~/.claude/skills/ZIP을 풀면 my-skill/my-skill/SKILL.md처럼 폴더가 한 단계 더 생기는 경우가 많습니다. SKILL.md는 Skill 폴더 바로 안에 있어야 에이전트가 찾을 수 있습니다.
Claude Code가 인식하는지 확인하기
/skills를 입력하세요. 목록에는 내 Skill과 /code-review처럼 Claude Code에 기본 포함된 몇 가지가 표시됩니다. t를 누르면 각 Skill이 차지하는 컨텍스트 크기순으로 정렬됩니다.
다시 시작할 필요는 없습니다. Claude Code는 현재 세션에서 새로 추가하거나 수정한 Skill을 인식합니다. 단 하나의 예외는 세션이 시작될 때 ~/.claude/skills/가 없었던 경우로, 이때는 /reload-skills를 한 번 실행하세요.
Claude Code 슬래시 명령어로 Skill 실행하기
설치한 모든 Skill은 Skill 이름의 슬래시 명령어로 나타납니다. 명령어를 입력하고 같은 줄에 원하는 것을 말하세요.
/launch-page Parcelo, a parcel-tracking dashboard for small online shops이름 뒤의 모든 내용은 $ARGUMENTS로 Skill에 전달됩니다. 작동하는 걸 한 번 확인했다면, 보통은 명령어 없이 작업을 평소 말로 설명해도 됩니다. 요청이 Skill의 description과 일치하면 Claude가 알아서 Skill을 로드합니다. 좋은 결과를 얻는 방법은 Skills 사용법에서 더 자세히 다룹니다.
Claude Code가 Skills를 찾는 위치와 우선순위
Claude Code는 다섯 곳에서 Skills를 모읍니다. 대부분은 개인 폴더와 프로젝트 폴더만 사용하고, 나머지는 팀에서 쓰거나 플러그인을 설치할 때 등장합니다.
| 출처 | 위치 | 명령어 |
|---|---|---|
| Enterprise | 관리 설정 | /skill-name |
| 개인 | ~/.claude/skills/<name>/ | /skill-name |
| 프로젝트 | .claude/skills/<name>/ | /skill-name |
| 플러그인 | <plugin>/skills/<name>/ | /plugin-name:skill-name |
| claude.ai 계정 | ~/.claude/skills/synced/에 동기화 | /name 또는 /anthropic-skills:name |
같은 이름이 두 곳에 있으면 Enterprise가 개인보다, 개인이 프로젝트보다 우선합니다. 하위 폴더의 .claude/skills/에 있는 Skill은 Claude가 그 하위 폴더의 파일을 처음 다룰 때 로드되므로, 큰 저장소에서 특정 패키지용 Skill은 필요할 때까지 방해가 되지 않습니다.
실행 시점을 제어하는 SKILL.md 설정
이 필드는 SKILL.md 맨 위의 frontmatter에 들어갑니다. Skill이 너무 자주 실행되거나, 충분히 실행되지 않거나, 단계마다 멈춰서 권한을 물을 때만 필요합니다.
| SKILL.md 필드 | 하는 일 |
|---|---|
description | Claude가 Skill을 쓸지 판단할 때 읽는 내용입니다. when_to_use와 합쳐 Skill 목록에서 1,536자에서 잘립니다. |
allowed-tools | Skill을 호출한 턴 동안 Claude가 묻지 않고 사용할 수 있는 도구입니다. |
paths | 파일 패턴입니다. Claude가 일치하는 파일을 다룰 때만 Skill을 자동으로 로드합니다. |
Claude Code Skill이 작동하지 않나요? 먼저 확인할 것
위에서부터 차례로 확인하세요. 첫 줄인 Skill이 잘못된 폴더에 있는 경우가 가장 흔한 원인입니다.
/skills에 없음
폴더가 잘못되었거나 ZIP 때문에 한 단계 더 생겼습니다. 경로가 ~/.claude/skills/<name>/SKILL.md가 되도록 옮기거나, --agent claude-code로 다시 설치하세요.
폴더를 방금 만들었음
/reload-skills를 실행하세요.
클라우드 세션에서 보이지 않음
저장소의 .claude/skills/에 커밋하거나 claude.ai에서 켜세요.
Cowork에서 보이지 않음
claude.ai 계정에서 켜세요.
목록에는 있지만 선택되지 않음
/name으로 호출해 작동하는지 확인한 다음, description을 더 구체적으로 쓰세요. 트리거를 참고하세요.
그 밖의 문제는 문제 해결에서 다룹니다.
자주 묻는 질문
Claude Code에서 Skills가 작동하나요?
네. Claude Code는 공개 Agent Skills 표준을 따르며, 개인 폴더, 현재 프로젝트, 플러그인, 조직, claude.ai 계정에서 Skills를 로드합니다.
Claude Code Skills는 어디에 저장되나요?
내 Skill은 ~/.claude/skills/<name>/SKILL.md에 둡니다. 특정 프로젝트용 Skill은 해당 저장소 안의 .claude/skills/<name>/SKILL.md에 둡니다.
커스텀 슬래시 명령어는 어떻게 되었나요?
계속 작동합니다. .claude/commands/deploy.md 파일과 deploy라는 Skill 모두 /deploy를 만들어 줍니다. 둘 다 있으면 Skill이 우선합니다.
Skillry CLI에 --agent claude-code가 필요한 이유는 무엇인가요?
CLI의 기본 폴더는 Codex와 Cursor가 함께 쓰는 ~/.agents/skills/입니다. Claude Code는 대신 ~/.claude/skills/를 읽으며, 이 플래그가 설치 위치를 그곳으로 지정합니다.
출처
이 가이드가 도움이 되었나요?