짧은 답변
- 1폴더:
~/.claude/skills·~/.agents/skills(+ 이전 경로~/.codex/skills) ·~/.cursor/skills - 2실행:
/name(Claude Code, Cursor) ·$name(Codex) · Cursor에서는@name으로 첨부 - 3설치 목록 보기:
/skills· Customize → Skills - 4설치:
npx --yes skillry-cli@latest install <slug>, Claude Code는--agent claude-code추가
에이전트별 Skills 폴더
개인 Skill은 여는 모든 프로젝트에서 작동합니다. 프로젝트 Skill은 저장소 안에 있으므로 저장소를 클론하는 모든 사람이 함께 받습니다.
| 에이전트 | 개인 | 프로젝트 |
|---|---|---|
| Claude Code | ~/.claude/skills/ | .claude/skills/ |
| Codex | ~/.agents/skills/ (이전 경로: ~/.codex/skills/) | .agents/skills/, 시작한 폴더부터 저장소 루트까지 |
| Cursor | ~/.cursor/skills/, ~/.agents/skills/ | .cursor/skills/, .agents/skills/ |
에이전트별로 읽는 모든 폴더와 이름이 같은 사본이 둘일 때 어느 쪽이 우선하는지는 Skill 위치에서 확인하세요.
Claude Code, Codex, Cursor의 Skill 명령어
Skill을 이름으로 호출하는 것이 설치 여부를 확인하는 가장 빠른 방법입니다. 실행된다면 에이전트가 인식하고 있는 것입니다.
| 작업 | Claude Code | Codex | Cursor |
|---|---|---|---|
| Skills 목록 | /skills | /skills | Customize → Skills |
| 실행 | /name | $name | /name, @name |
| 플러그인 Skill | /plugin:name | 플러그인으로 | 플러그인으로 |
| 계속 켜 두기 | — | — | Option/Alt+Enter (Custom Mode) |
| 수정한 후 | 실시간 반영, 새 폴더는 /reload-skills | 실시간 반영, 안 되면 다시 시작 | 새 채팅 또는 창 다시 불러오기 |
SKILL.md frontmatter 필드
모든 Skill에는 SKILL.md 파일이 있고, 설정은 맨 위의 두 --- 줄 사이에 있습니다. 아래는 에이전트가 Skill을 다루는 방식을 바꾸는 필드입니다.
| 필드 | 제한 / 효과 | Claude Code | Codex | Cursor |
|---|---|---|---|---|
name | 64자 이하, a–z·0–9·하이픈만 사용, 폴더 이름과 일치 | 선택 | 필수 | 필수 |
description | 1,024자 이하, 무엇을 하는지와 언제 쓰는지 작성 | 권장 | 필수 | 필수 |
allowed-tools | 묻지 않고 사용할 수 있는 도구(사양상 실험적 기능) | 지원 | — | — |
paths | 일치하는 파일 패턴에서만 자동 실행 | 지원 | — | 지원 |
Skillry CLI 명령어
Skillry CLI는 Skillry에서 Skill을 내려받아 사용하는 에이전트에 맞는 폴더에 넣어 줍니다.
| 명령어 | 하는 일 |
|---|---|
skillry-cli login | 기기 코드로 브라우저에서 로그인합니다 |
skillry-cli status | 어떤 계정으로 로그인했는지 보여 줍니다 |
skillry-cli install <slug> | ~/.agents/skills/<slug>/에 설치합니다 |
--agent claude-code | …대신 ~/.claude/skills/<slug>/에 설치합니다 |
--target <dir> | …원하는 Skills 폴더에 설치합니다. 예: .claude/skills |
--force | 기존 사본을 교체하고 백업을 남깁니다 |
skillry-cli logout | 로그아웃하고 세션을 폐기합니다 |
모든 명령어는 npx --yes skillry-cli@latest로 시작합니다. Node.js 22+가 설치된 macOS 또는 Windows에서 실행됩니다. --agent와 --target은 함께 사용할 수 없습니다.
자주 묻는 질문
Skills용 Claude Code 명령어는 무엇인가요?
/skills는 Skill 목록을 보여 주고, /skill-name은 Skill을 실행하며, /plugin-name:skill-name은 플러그인에 포함된 Skill을 실행하고, /reload-skills는 방금 만든 Skills 폴더를 인식시킵니다.
에이전트 간 차이는 어디에서 설명하나요?
에이전트 비교에서 같은 내용을 실제 예시와 함께 다룹니다.
출처
이 가이드가 도움이 되었나요?
