Claude Code, Codex, Cursor, OpenCode에 스킬을 동기화하는 방법

도구별로 찾는 위치

각 도구의 문서 기준, 2026년 11월 4일 확인. 각 폴더에는 스킬마다 하위 폴더가 하나씩 있고, 그 안에 SKILL.md가 있어요.

폴더 두 개면 네 도구를 모두 다뤄요. ~/.claude/skills(Claude Code, Cursor, OpenCode)와 ~/.agents/skills(Codex, Cursor, OpenCode)예요.

내 컴퓨터에 사본 하나: 심볼릭 링크

실제 파일은 폴더 하나에 두고, 두 위치가 그 폴더를 가리키게 하세요. macOS나 Linux에서는 다음과 같아요.

mkdir -p ~/skills
# move existing skills in first, then:
ln -s ~/skills ~/.claude/skills
ln -s ~/skills ~/.agents/skills

둘 중 한 폴더라도 이미 있다면, 링크하기 전에 그 안의 내용을 ~/skills로 옮기고 빈 폴더를 지우세요. Cursor와 OpenCode는 두 위치를 모두 읽으므로 같은 파일에 두 경로로 닿아요. 어느 쪽에서 스킬이 두 번 보여도 파일은 하나이니, ~/skills에서 한 번만 고치면 돼요.

저장소에서도 .claude/skills와 .agents/skills로 같은 작업을 하고 실제 폴더를 커밋하면, 저장소를 클론하는 모두가 스킬을 받아요.

팀을 위한 사본 하나: MCP 서버

심볼릭 링크와 저장소는 개발자에게는 잘 맞아요. 하지만 브라우저에서 Claude나 ChatGPT로 일하는 팀원에게는 닿지 않고, 업데이트하려면 git pull이 필요해요. 네 코딩 에이전트는 모두 원격 MCP 서버에도 연결돼요.

• Claude Code: claude mcp add --transport http <name> <url>
• Codex: 설정 파일에 url = "…"가 든 서버 항목(Streamable HTTP).
• Cursor: MCP 설정에 추가한 Streamable HTTP 서버.
• OpenCode: 설정 파일에 "type": "remote"가 든 서버.

팀의 스킬을 담은 서버가 있으면 코딩 에이전트, Claude, ChatGPT가 모두 같은 최신 사본을 쓰고, pull하거나 다시 링크할 일이 없어요. OpenAI는 ChatGPT Plus에서 커스텀 MCP 커넥터를 안내하지 않아요. Plus에는 Codex가 포함되니, Plus 사용자는 같은 링크를 Codex CLI나 IDE 확장에 추가하면 돼요.

도구가 스킬을 보는지 확인하기

1. 구조를 확인해요: <folder>/<skill-name>/SKILL.md 형태이고, 폴더 이름이 name 항목과 같아야 해요.
2. 프런트매터를 확인해요: name은 영문 소문자, 숫자, 하이픈으로 64자까지, description은 비어 있지 않아야 해요. SKILL.md 변환기가 둘 다 써 줘요.
3. 새 세션을 시작하고 에이전트에게 어떤 스킬이 있는지 묻거나, 설명에 적힌 작업을 요청해 보세요.

자주 묻는 질문

Claude Code 스킬을 Claude 데스크톱 앱, claude.ai와 동기화하려면 어떻게 하나요?

Claude Code는 디스크의 폴더를 읽고, Claude 데스크톱 앱과 claude.ai는 업로드한 스킬을 계정에 보관해요. 같은 폴더를 ZIP으로 ‘사용자 정의’의 스킬(Skills)에 업로드하거나, 스킬을 제공하는 MCP 서버 하나에 둘 다 연결하세요.

Claude Code가 .agents/skills 폴더를 못 보는 이유는 무엇인가요?

Claude Code는 .agents/skills가 아니라 ~/.claude/skills와 .claude/skills를 읽어요. 위의 심볼릭 링크 단계처럼 폴더를 ~/.claude/skills에 연결하세요.