Claude Code, Codex, Cursor에 Claude Skills 설치하는 방법

짧은 답변

1에이전트를 이미 열어 두었나요? 설치 프롬프트 복사를 사용하세요. 터미널에서 작업 중인가요? CLI를 사용하세요. GitHub에서 폴더를 받았나요? 복사해 넣으세요.
2Claude Code는 --agent claude-code가 필요합니다. Codex와 Cursor는 기본 폴더 ~/.agents/skills/를 사용합니다.
3SKILL.md가 Skill 폴더 바로 안에 있고 에이전트가 목록에 표시하면 완료입니다.

바로 가기:어떤 방법?설치 프로젝트 하나만 확인

어떤 방법을 써야 할까요?

지금 있는 곳을 기준으로 고르세요. 세 방법 모두 결과는 같습니다. Skill 폴더가 에이전트가 찾을 수 있는 곳에 놓이게 됩니다.

에이전트가 열려 있음

Skill 페이지에서 설치 프롬프트 복사를 누르고 에이전트에 붙여 넣기

터미널 작업을 좋아함

Skillry CLI (macOS 또는 Windows, Node.js 22+)

Linux를 쓰거나 파일을 먼저 읽고 싶음

ZIP 다운로드 후 폴더를 직접 복사

Skill이 GitHub에 있음

저장소를 클론하거나 다운로드한 뒤 폴더를 직접 복사

Skillry Skill page for Notion Style OG Image with the Copy install prompt and Download ZIP buttons — 두 버튼은 모든 Skill 페이지에 있습니다. 무료 Skill도 먼저 로그인해야 합니다.

에이전트는 어디에서 Skills를 찾나요?

각 에이전트는 자체 폴더에서 Skills를 읽고, CLI가 폴더를 대신 골라 줍니다. Codex와 Cursor는 둘 다 ~/.agents/skills/를 읽으므로 한 번 설치하면 둘 다 사용할 수 있습니다.

에이전트	Skillry CLI	설치 위치
Claude Code	`--agent claude-code`	`~/.claude/skills/<slug>/`
Codex	기본값, 플래그 없음	`~/.agents/skills/<slug>/`
Cursor	기본값, 플래그 없음	`~/.agents/skills/<slug>/`

The Runs in row on a Skill page, with agent logos that link to install guides — Skill 페이지의 “실행 환경”에는 지원하는 에이전트가 나와 있고, 해당 설치 가이드로 연결됩니다.

Claude Code, Codex, Cursor에 Skills 추가하는 방법

고른 방법의 탭을 여세요. 처음 두 방법은 끝나면 버전과 폴더를 알려 주고, 직접 복사하는 경우에는 폴더를 스스로 확인해야 합니다.

에이전트가 이미 열려 있을 때 가장 좋음

1
Skill 페이지에서 설치 프롬프트 복사를 선택한 다음, 대화 상자에서 복사를 누르세요.
2
에이전트에 붙여 넣으세요. 에이전트가 Skillry의 설치 안내를 읽고 자신에게 맞는 명령어를 실행합니다.
설치 프롬프트
```
Read https://skillry.dev/skills/<slug>/install.md and follow the instructions to install the skill.
```
3
요청이 오면 브라우저에서 기기 코드를 승인하세요.
다음이 보여야 합니다: 에이전트가 설치한 버전과 사용한 폴더를 알려 주는 메시지.

명령어를 직접 실행하고 싶을 때 가장 좋음

1
한 번 로그인하세요. 브라우저 창이 열리고 기기 코드 승인을 요청합니다.
터미널
```
npx --yes skillry-cli@latest login
```
2
Skill을 설치하세요. Claude Code라면 --agent claude-code를 추가하세요.
터미널
```
npx --yes skillry-cli@latest install <slug>
```
다음이 보여야 합니다: Installed <slug> <version> to ~/.agents/skills/<slug>
3
나중에 다시 설치하나요? --force를 추가하세요. 플래그가 없으면 CLI는 기존 사본을 덮어쓰지 않고 멈춥니다.

Skillry는 API key를 붙여 넣으라고 요구하지 않습니다. 로그인 정보는 macOS Keychain이나 Windows Credential Manager에 저장됩니다.

Linux를 쓰거나 파일을 먼저 읽고 싶을 때 가장 좋음

SKILL.md만이 아니라 폴더 전체를 복사하세요. 지침이 옆에 있는 파일을 가리키는 경우가 많습니다.

Claude Code, 모든 프로젝트

mkdir -p ~/.claude/skills
mv ~/Downloads/my-skill ~/.claude/skills/

올바름

한 단계 깊이

~/.claude/skills/my-skill/SKILL.md

잘못됨

ZIP 때문에 한 단계 더 생김

~/.claude/skills/my-skill/my-skill/SKILL.md
또는 SKILL.md가 skills/에 따로 놓여 있음

프로젝트 하나에만 Skill을 설치하려면?

--target으로 프로젝트의 Skills 폴더를 지정하세요. CLI에 별도의 프로젝트 옵션은 없지만 --target은 어떤 Skills 폴더든 받으므로, 저장소 안에서 다음을 실행하세요.

Claude Code, 이 저장소만

npx --yes skillry-cli@latest install <slug> --target .claude/skills

그 폴더를 커밋하면 저장소를 클론하는 모든 사람이 같은 Skill을 받습니다.

--agent와 --target 중 하나만 사용하세요. CLI는 둘을 함께 쓰면 거부합니다.

설치가 잘 되었는지 확인하는 방법

실제 작업에 Skill이 필요해지기 전에, 지금 30초만 들여 확인하세요.

1폴더를 열고 SKILL.md가 한 단계 아래가 아니라 바로 그 안에 있는지 확인하세요.
2Skill 목록을 보세요. Claude Code와 Codex는 /skills, Cursor는 Customize → Skills입니다.
3이름으로 한 번 실행하세요.

목록에 없나요? 문제 해결에서 모든 원인을 차례로 살펴봅니다.

자주 묻는 질문

npx로 Skill을 설치하려면 어떻게 하나요?

npx --yes skillry-cli@latest install <slug>를 실행하고, Claude Code라면 --agent claude-code를 추가하세요. 브라우저로 로그인한 뒤 Skill을 설치한 위치를 출력합니다.

GitHub에서 Claude Skills를 설치하려면 어떻게 하나요?

저장소를 다운로드하거나 클론한 다음, SKILL.md가 바로 안에 있는 Skill 폴더를 ~/.claude/skills/나 프로젝트의 .claude/skills/로 옮기세요.

무료 버전 Claude에도 Skills를 추가할 수 있나요?

Claude Code, Codex, Cursor에서 Skill은 직접 설치하는 폴더입니다. claude.ai 앱에서 Skills를 쓸 수 있는지는 Claude 요금제와 설정에 따라 다릅니다.

출처

이 가이드가 도움이 되었나요?

이전시작하기 다음Claude Code

Agent Skills 설치 방법