짧은 답변
- 1폴더: Claude Code는
~/.claude/skills를 읽습니다. Codex는~/.agents/skills와 이전 경로~/.codex/skills를 읽습니다. Cursor는 자체 폴더와 함께 두 폴더를 모두 읽습니다. - 2이름으로 호출: Claude Code와 Cursor는
/skill-name, Codex는$skill-name. - 3필수 필드: Codex와 Cursor는
name과description이 필요하며, Cursor의name은 폴더와 같아야 합니다. Claude Code는 둘 다 필요 없습니다.
Claude Code vs Codex vs Cursor 한눈에 보기
세 에이전트 모두 같은 Agent Skills 형식을 따르므로, 올바르게 만든 Skill 폴더는 어디서든 실행됩니다. 다른 점은 각 에이전트가 찾는 위치, Skill을 호출하는 방법, frontmatter를 얼마나 엄격하게 따지는지입니다.
| Claude Code | Codex | Cursor | |
|---|---|---|---|
| 개인 폴더 | ~/.claude/skills/ | ~/.agents/skills/, 이전 경로 ~/.codex/skills/ | ~/.cursor/skills/ 또는 ~/.agents/skills/ |
| 프로젝트 폴더 | .claude/skills/ | .agents/skills/, 시작한 위치부터 저장소 루트까지 | .cursor/skills/ 또는 .agents/skills/ |
| 설치 목록 보기 | /skills | /skills(CLI, IDE), ChatGPT 데스크톱 앱 사이드바의 Skills | Customize → Skills |
| 이름으로 호출 | /skill-name | $skill-name | /skill-name 또는 @skill-name |
| 필수 필드 | 없음 | name, description | name(= 폴더), description |
| 같은 이름이 둘 | Enterprise, 개인, 프로젝트 순 | 둘 다 표시될 수 있음 | 문서화되지 않음 |
| 수정한 후 | 같은 세션에서 반영 | 반영됨, 안 되면 다시 시작 | 시작할 때 찾음, 새 채팅 또는 다시 불러오기 |

에이전트를 바꾸나요? Skills가 이미 있을 수도 있습니다
Claude Code에서 Cursor로 옮길 때
Cursor는 ~/.claude/skills/와 ~/.codex/skills/도 읽으므로, Claude Code용으로 설치한 Skills가 아무것도 복사하지 않아도 Cursor에 나타납니다. 주의할 점은 Cursor의 이름 규칙입니다. name이 폴더와 같아야 하죠. name이 아예 없어도 Claude Code에서는 잘 실행되는 Skill이 Cursor에서는 건너뛰어질 수 있습니다.
Skill이 닿아야 할 에이전트에 따라 폴더를 고르세요.
| Skill을 둘 위치 | 작동하는 곳 |
|---|---|
~/.claude/skills/ | Claude Code와 Cursor |
~/.agents/skills/ | Codex와 Cursor |
~/.cursor/skills/ | Cursor, 동기화하면 Cloud Agents 포함 |
클라우드, 웹, 팀에서 Skills 사용하기
개인 폴더의 Skill은 내 컴퓨터에 있습니다. 클라우드 세션, 웹 앱, 팀원은 내가 그들이 닿을 수 있는 곳에 두기 전까지 그 Skill을 볼 수 없습니다.
| 에이전트 | 개인 Skill이 닿지 않는 곳 | 해결 방법 |
|---|---|---|
| Claude Code | 클라우드 세션, 루틴, Cowork | claude.ai 계정에서 Skill을 켜세요. 클라우드 세션은 .claude/skills/에 커밋된 Skill도 로드합니다 |
| Codex | 웹과 모바일의 ChatGPT | 독립형 Skill은 ChatGPT 데스크톱 앱, CLI, IDE 확장에서 작동합니다. 웹과 모바일용으로는 플러그인으로 배포하세요 |
| Cursor | 동기화하지 않은 경우 Cloud Agents | ~/.cursor/skills/에 두고 Sync Skills for Cloud Agents를 켜세요 |
각 에이전트에 Skillry Skill 설치하기
설치 명령어는 세 에이전트 모두 같고, 차이는 하나뿐입니다.
| 에이전트 | 명령어 |
|---|---|
| Claude Code | npx --yes skillry-cli@latest install <slug> --agent claude-code |
| Codex, Cursor | npx --yes skillry-cli@latest install <slug> |
CLI의 기본 폴더 ~/.agents/skills/는 Codex와 Cursor가 함께 쓰는 폴더입니다. 그래서 Claude Code만 추가 플래그가 필요합니다. Claude Code, Codex, Cursor 가이드에서는 설치 프롬프트와 ZIP 방법도 다룹니다.
자주 묻는 질문
Cursor에서 Claude Skills를 쓸 수 있나요?
네. 각 Skill의 name이 폴더와 일치하기만 하면 Cursor는 호환성을 위해 ~/.claude/skills/와 .claude/skills/를 로드합니다.
Claude Code Skill을 Codex에서 쓸 수 있나요?
네. Codex가 요구하는 name과 description이 SKILL.md에 모두 있으면 됩니다. 폴더를 ~/.claude/skills/에서 ~/.agents/skills/로 복사하거나, --agent claude-code 없이 Skillry에서 다시 설치하세요.
Skills에 가장 좋은 에이전트는 무엇인가요?
세 에이전트 모두 같은 형식을 읽으므로, 이미 쓰고 있는 에이전트를 사용하세요. 이 페이지의 차이는 에이전트를 바꾸거나 팀과 Skills를 공유할 때만 중요합니다.
Codex Skills는 웹의 ChatGPT에서 작동하나요?
독립형 Skill은 작동하지 않습니다. ChatGPT 데스크톱 앱, Codex CLI, IDE 확장에서 작동합니다. 플러그인에 포함된 Skill은 웹, 데스크톱, 모바일의 ChatGPT에서 작동합니다.
출처
이 가이드가 도움이 되었나요?
