Claude Skills는 어디에 저장되나요? 에이전트별 Skill 폴더

짧은 답변

1Claude Code: ~/.claude/skills/<name>/SKILL.md, 프로젝트에서는 .claude/skills/
2Codex: ~/.agents/skills/, 저장소에서는 .agents/skills/. 이전 경로 ~/.codex/skills/도 계속 읽습니다
3Cursor: ~/.cursor/skills/ 또는 ~/.agents/skills/, 그리고 프로젝트 폴더와 Claude Code·Codex 폴더

Claude Code, Codex, Cursor의 Skills 폴더 위치

각 에이전트에는 홈 디렉터리의 개인 폴더와 저장소 안의 프로젝트 폴더가 있습니다. 일부는 다른 에이전트의 폴더도 읽기 때문에 사본 하나가 여러 도구에 나타날 수 있습니다.

에이전트	개인	프로젝트	추가로 읽는 위치
Claude Code	`~/.claude/skills/`	`.claude/skills/`, Claude가 하위 폴더에서 작업할 때는 그 안의 폴더도	Enterprise 관리 설정, 플러그인, claude.ai 계정(`~/.claude/skills/synced/`에 동기화)
Codex	`~/.agents/skills/`	`.agents/skills/`, 시작한 폴더부터 저장소 루트까지	`~/.codex/skills/` (이전 경로), `/etc/codex/skills/`, 시스템 Skill
Cursor	`~/.cursor/skills/`, `~/.agents/skills/`	`.cursor/skills/`, `.agents/skills/`, 저장소 어디든	`.claude/skills/`, `.codex/skills/`, 그리고 `~` 아래의 두 폴더

Windows에서 ~는 사용자 폴더입니다. 예: C:\Users\you\.claude\skills.

Claude Code Skills 폴더의 올바른 구조

Skill마다 자체 폴더가 있고, SKILL.md는 그 폴더 바로 안에 있습니다. 보조 파일은 옆의 하위 폴더에 둡니다.

모든 에이전트가 이해하는 구조

~/.claude/skills/
└── launch-page/
    ├── SKILL.md
    ├── references/
    └── scripts/

ZIP 함정

압축을 풀면 폴더가 한 단계 더 생겨 launch-page/launch-page/SKILL.md가 되는 경우가 많습니다. Claude Code는 skills/<name>/SKILL.md만 확인하므로 이 Skill을 목록에 표시하지 않습니다. Cursor와 Codex는 더 깊이 검색해서 찾아낼 수도 있는데, 이것이 “Cursor에서는 되는데 Claude Code에는 없어요”라는 문의가 생기는 이유입니다. 안쪽 폴더를 한 단계 위로 옮기면 어디서나 작동합니다.

이름이 같은 Skill이 둘일 때 우선순위

순서를 문서화한 곳은 Claude Code뿐입니다. Codex는 두 사본을 모두 표시할 수 있고, Cursor는 명시하지 않습니다.

에이전트	두 곳에 같은 이름이 있을 때
Claude Code	Enterprise, 개인, 프로젝트 순입니다. 플러그인 Skill은 플러그인 이름이 붙기 때문에 충돌하지 않습니다.
Codex	합치지 않으며, 둘 다 표시될 수 있습니다.
Cursor	Skills에 대해서는 문서화되어 있지 않습니다.

순서에 의존하지 마세요. 사본을 하나만 남기거나 하나의 이름을 바꾸세요.

Cursor Cloud Agents의 Skills

Cursor Cloud Agents에는 ~/.cursor/skills/만 동기화되며, Sync Skills for Cloud Agents가 켜져 있을 때만 동기화됩니다. ~/.agents/skills/에 있는 Skill은 내 컴퓨터에서는 작동해도 클라우드에서는 없을 수 있습니다.

Skill을 옮긴 후

대부분은 에이전트가 알아서 인식합니다. 그래도 Skill이 보이지 않으면 다음을 하세요.

에이전트	변경 사항을 반영하려면
Claude Code	할 일 없음. Skills 폴더가 새로 생겼다면 `/reload-skills` 실행
Codex	보통 할 일 없음. 보이지 않으면 다시 시작
Cursor	새 채팅을 열거나 창 다시 불러오기

자주 묻는 질문

Claude Skills는 어디에 저장되나요?

개인 Skill은 ~/.claude/skills/<name>/SKILL.md에 둡니다. 프로젝트 Skill은 저장소 안의 .claude/skills/<name>/SKILL.md에 둡니다.

Codex Skills 폴더는 어디에 있나요?

개인 Skill은 ~/.agents/skills/, 저장소에서는 .agents/skills/입니다. Codex는 이전 경로인 ~/.codex/skills/도 계속 읽으며, OpenAI의 $skill-installer가 Skill을 설치하는 위치이기도 합니다.