Orkas Orkas
홈 블로그 Claude 스킬을 Codex·OpenCode에서
제품

Claude Code, Codex, OpenCode에서 같은 스킬을 함께 쓰는 방법

세 도구 모두 같은 SKILL.md 형식을 불러오지만, 찾는 폴더는 저마다 다릅니다. 각 도구가 어디를 찾는지, 세 도구가 모두 불러오는 사본 하나를 유지하는 방법, Claude Code에서 옮겨지지 않는 것, 그리고 Orkas가 실행하는 모든 CLI에 같은 스킬을 제공하는 방식을 설명합니다.

Claude Code, Codex, OpenCode는 모두 같은 형식으로 스킬을 불러옵니다. SKILL.md 파일이 들어 있는 폴더입니다. 이 형식은 개방형 Agent Skills 표준으로, Anthropic이 만들었고 2026년 11월 4일 Linux Foundation 프로젝트가 되었습니다. 그래서 스킬 하나를 세 도구 모두에서 쓸 수 있습니다. 문제는 도구마다 찾는 폴더가 다르고, Claude Code만 이해하는 필드도 있다는 점입니다. 이 가이드에서는 각 도구가 어디를 찾는지, 세 도구가 모두 불러오는 사본 하나를 유지하는 방법, 그대로 옮겨지지 않는 것, 그리고 Orkas가 실행하는 모든 코딩 에이전트에 같은 스킬을 제공하는 방식을 설명합니다.

요약: 각 스킬 폴더는 ~/.agents/skills에 둡니다. Codex와 OpenCode는 이미 이 폴더를 읽습니다. Claude Code는 읽지 않으므로 ~/.claude/skills에 스킬마다 링크를 추가합니다. 프론트매터는 name과 description만 남기고, 스킬 이름은 폴더 이름과 같게 합니다. 2026년 11월 8일에 Claude Code 2.1.319, Codex 0.167.0, OpenCode 2.2.6으로 확인했습니다.

Claude Code, Codex, OpenCode가 스킬을 찾는 위치

폴더Claude CodeCodexOpenCode
~/.agents/skills아니요예예
프로젝트 안의 .agents/skills아니요예예
~/.claude/skills예아니요예
프로젝트 안의 .claude/skills예아니요예
~/.codex/skills아니요예(사용 중단 예정)아니요
~/.config/opencode/skills, .opencode/skills아니요아니요예
스킬 호출 방법/skill-name$skill-name 또는 /skills@skill-name

세 도구 모두 요청이 스킬 설명과 맞으면 스스로 그 스킬을 고릅니다. 프로젝트 폴더의 경우, 각 도구는 실행한 폴더와 저장소 루트까지의 모든 상위 폴더를 확인합니다.

  • Claude Code만 .agents/skills를 찾지 못합니다. 스킬 문서에는 .claude 폴더만 나와 있고, 메모리 문서에는 ".agents/ 디렉터리 아래의 모든 것"을 읽지 않는다고 적혀 있습니다. 이를 바꿔 달라는 요청인 issue #31005는 추천을 450개 넘게 받았지만 아직 열려 있습니다.
  • Codex는 .agents/skills로 옮겨 갔습니다. 문서에는 프로젝트용 .agents/skills, 사용자용 ~/.agents/skills, 관리자용 /etc/codex/skills가 나와 있습니다. 예전 ~/.codex/skills 폴더는 소스 코드에서 사용 중단 예정으로 표시되어 있지만 여전히 로드됩니다. Codex는 .claude 폴더를 전혀 읽지 않습니다.
  • OpenCode는 모두 읽습니다. 문서에는 자체 폴더와 함께 .claude/skills와 .agents/skills가 사용자 수준과 프로젝트 수준 모두에 나와 있습니다. 2.2 버전대뿐 아니라 아직 릴리스가 이어지는 1.19 버전대도 마찬가지입니다.

공유 폴더 하나 설정하기

~/.agents/skills를 유일한 실제 사본으로 씁니다. Codex와 OpenCode는 별도 설정 없이 이 폴더를 읽고, npx skills와 Codex 가져오기 기능도 모두 여기에 씁니다. 그다음 Claude Code에는 스킬마다 링크를 만들어 줍니다.

  1. 스킬을 ~/.agents/skills로 옮깁니다. ~/.claude/skills나 ~/.codex/skills에 직접 작성한 스킬은 폴더째 옮깁니다. 예: mv ~/.claude/skills/release-notes ~/.agents/skills/. ~/.claude/skills/synced는 그대로 두세요. Claude Code가 claude.ai 계정의 스킬을 여기에 보관합니다.
  2. 각 스킬을 Claude Code 폴더에 링크합니다. macOS나 Linux에서는 다음을 실행합니다. 이미 폴더나 링크가 있는 스킬은 건너뜁니다.
mkdir -p ~/.agents/skills ~/.claude/skills
for d in ~/.agents/skills/*/; do
  n=$(basename "$d")
  [ -e ~/.claude/skills/"$n" ] || ln -s ~/.agents/skills/"$n" ~/.claude/skills/"$n"
done
  1. Windows에서는 정션을 사용합니다. 관리자 권한이 필요 없습니다. PowerShell에서 다음을 실행합니다.
New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null
Get-ChildItem "$HOME\.agents\skills" -Directory | ForEach-Object {
  $link = "$HOME\.claude\skills\$($_.Name)"
  if (-not (Test-Path $link)) { New-Item -ItemType Junction -Path $link -Target $_.FullName | Out-Null }
}
  1. 각 도구에서 확인합니다. 새 세션을 시작합니다. Claude Code에서는 /를 입력하고 스킬을 찾습니다. Codex에서는 /skills를 실행합니다. OpenCode에서는 @를 입력합니다.

팀이 공유하는 프로젝트라면 저장소 안에서 같은 작업을 합니다. 스킬은 .agents/skills에 두고, .claude/skills에서 각 스킬로 상대 링크를 만듭니다. 예: ln -s ../../.agents/skills/release-notes .claude/skills/release-notes

제대로 챙겨야 할 몇 가지:

  • 폴더 전체가 아니라 스킬마다 링크합니다. ~/.claude/skills 자체가 ~/.agents/skills를 가리키면 Claude Code의 synced와 .trash 폴더가 공유 폴더에 들어가고, Codex와 OpenCode가 동기화된 스킬까지 불러올 수 있습니다. 대신 스킬을 추가한 뒤에는 반복문을 다시 실행해야 합니다.
  • SKILL.md 파일이 아니라 폴더를 링크합니다. Codex는 링크된 스킬 폴더는 따라가지만, SKILL.md 자체가 링크이면 무시합니다. OpenAI는 이 요청을 계획 없음으로 닫았습니다.
  • Windows를 쓰는 팀원이 있다면 링크를 커밋하지 마세요. Git for Windows는 기본적으로 링크를 작은 텍스트 파일로 체크아웃합니다. 링크는 설정 스크립트로 만들거나, 실제 사본을 커밋하세요.
  • OpenCode는 각 스킬을 두 번 보고 하나만 남깁니다. ~/.claude/skills의 링크와 ~/.agents/skills의 폴더를 모두 읽기 때문입니다. 2.2 버전은 조용히 합칩니다. 1.19 버전은 중복 경고를 로그에 남깁니다. OpenCode가 Claude 폴더를 읽지 않게 하려면 OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1을 설정하세요.

세 도구 모두 불러오는 스킬 작성하기

이 SKILL.md는 Claude Code, Codex, OpenCode에서 똑같이 로드됩니다. 위치는 ~/.agents/skills/release-notes/SKILL.md이고, 옆에 references 폴더와 scripts 폴더가 있습니다.

---
name: release-notes
description: "Drafts release notes from git commits since the last tag. Use when the user asks for a changelog, release notes, or what changed since the last release."
license: MIT
---

# 릴리스 노트

1. 마지막 태그 찾기: git describe --tags --abbrev=0
2. 그 태그 이후의 커밋 나열: git log <tag>..HEAD --oneline --no-merges
3. 이 스킬 폴더의 references/format.md에 따라 커밋을 Added, Changed, Fixed로 묶는다.
4. 파일로 저장하려면 이 스킬 폴더에서 scripts/write_notes.sh를 실행한다.
  • 스킬 이름을 폴더 이름과 같게 합니다. 영문 소문자, 숫자, 하이픈만 쓰고 64자까지입니다. Codex는 name을, OpenCode 2.2는 폴더 이름을 기준으로 하며, Claude Code는 둘 다 받아들입니다. 둘이 다르면 같은 스킬을 도구마다 다른 이름으로 부르게 됩니다. Codex는 이름이 64자를 넘는 스킬을 건너뜁니다.
  • description은 1,024자 미만으로 쓰고 사람들이 실제로 쓸 단어를 앞에 둡니다. 이것이 표준의 한도이며, Codex는 스킬 목록에서 더 긴 description을 이 길이로 자릅니다.
  • 콜론 뒤에 공백이 오는 값은 따옴표로 감쌉니다. 그렇지 않으면 프론트매터가 파싱되지 않을 수 있습니다. Codex는 이런 경우 대부분을 바로잡지만, Claude Code는 프론트매터가 없는 것처럼 스킬을 불러오고, OpenCode는 오류 없이 스킬을 건너뛸 수 있습니다.
  • 스크립트가 자기 폴더를 찾게 합니다. 도구는 스킬 폴더가 아니라 프로젝트 폴더에서 명령을 실행합니다. cd "$(dirname "$0")"로 시작하는 스크립트는 어디서든 동작합니다.
  • 이름에서 "claude"를 빼세요. 스킬을 claude.ai나 Claude API에 올릴 가능성이 있는 경우입니다. 둘 다 "claude"나 "anthropic"이 들어간 이름을 거부합니다.

Claude Code에서 옮겨지지 않는 것

Codex는 name, description, 그리고 metadata 아래의 짧은 설명만 읽습니다. OpenCode 2.2는 metadata와 disable-model-invocation도 읽습니다. 둘 다 그 밖의 필드는 오류 없이 무시하므로, Claude Code 스킬은 로드되지만 다르게 동작합니다.

Claude Code 스킬의 항목Claude CodeCodexOpenCode 2.2
allowed-tools작동무시됨무시됨
disable-model-invocation: true작동무시됨. agents/openai.yaml 사용작동
context: fork, agent, model, hooks, argument-hint작동무시됨무시됨
본문의 $ARGUMENTS와 $1입력한 인수로 바뀜텍스트 그대로텍스트 그대로
본문의 !`command`Claude가 스킬을 읽기 전에 실행됨텍스트 그대로텍스트 그대로
${CLAUDE_SKILL_DIR}스킬 폴더로 바뀜텍스트 그대로텍스트 그대로
  • 이런 기능 없이도 동작하는 단계를 씁니다. ${CLAUDE_SKILL_DIR}를 쓰는 대신 "이 스킬 폴더에서 scripts/check.sh를 실행한다"라고 쓰고, $ARGUMENTS를 쓰는 대신 빠진 정보는 평범한 말로 물어보게 합니다. Claude Code도 같은 지시를 문제없이 따릅니다.
  • Codex가 스킬을 알아서 호출하지 않게 하려면 스킬 폴더에 agents/openai.yaml을 추가하고 allow_implicit_invocation: false를 policy 아래에 넣습니다. 그래도 $skill-name으로는 호출할 수 있습니다.
  • allowed-tools는 Codex나 OpenCode가 할 수 있는 일을 제한하지 않습니다. npx skills 호환성 표에는 둘 다 지원한다고 나와 있지만, 어느 도구의 스킬 로더도 이 필드를 읽지 않습니다. 제한은 각 도구의 권한 설정에서 하세요.

여러 에이전트에 스킬을 설치해 주는 도구

도구스킬 공유 방식주의할 점
npx skills (Vercel, 스타 38,500개)스킬을 .agents/skills에 복사하고 각 에이전트 폴더에서 그곳으로 링크합니다. Windows에서는 정션을 씁니다. --copy를 쓰면 따로 복사합니다.이 가이드와 같은 구조입니다. npx skills add owner/repo를 실행하고, 사용자 폴더에 설치하려면 -g를 붙입니다.
skillshare (스타 2,900개)원본 폴더 하나를 두고 각 도구 폴더에 링크합니다. Windows에서는 정션을 씁니다.2026년 11월 6일 업데이트. Homebrew나 셸 스크립트로 설치합니다.
Codex /import.claude/skills의 스킬을 .agents/skills로 복사합니다.복사본은 원본과 점점 달라집니다. 또 본문의 "claude"를 "Codex"로 바꾸는데, 파일 경로 안까지 바꿉니다(열려 있는 issue #40147).
openskills (스타 10,800개)스킬을 .claude/skills에 복사하고 AGENTS.md에 목록을 적습니다.2026년 1월 이후 릴리스가 없습니다. --universal 옵션은 .agent/skills에 쓰는데, 세 도구 중 어느 것도 이 폴더를 읽지 않습니다.

CLAUDE.md와 AGENTS.md는 어떻게 하나요?

Codex와 OpenCode는 AGENTS.md를 읽고, OpenCode는 프로젝트에 AGENTS.md가 없으면 CLAUDE.md를 대신 읽습니다. Claude Code도 2.1.277 버전부터 AGENTS.md를 읽지만, CLAUDE.md나 CLAUDE.local.md가 없는 프로젝트에서만 읽습니다. 두 파일을 모두 둔다면 Claude Code에서 /config를 열고 Project instructions를 둘 다 불러오도록 설정합니다. 모든 에이전트가 따라야 할 규칙은 AGENTS.md에 두고, Claude Code만 필요한 내용은 CLAUDE.md에 둡니다.

Orkas에서 같은 스킬 쓰기

Orkas는 Claude Code, Codex, OpenCode, OpenClaw, Hermes를 하나의 채팅에서 에이전트로 실행하는 데스크톱 앱입니다. 컴퓨터에 설치된 사본과 본인의 로그인을 그대로 사용합니다. 스킬이 이 에이전트들에 전달되는 방식은 다음과 같습니다.

  • 공유 폴더는 그대로 동작합니다. Orkas가 실행해도 각 CLI는 자기 스킬 폴더를 읽으므로, 위의 설정은 바꾸지 않아도 동작합니다. Orkas는 기존 MCP 서버를 대체하지 않고 그 옆에 자체 MCP 서버를 추가합니다.
  • Orkas에서 추가한 스킬은 모든 CLI에 전달됩니다. Orkas가 실행하는 모든 CLI는 orkas라는 MCP 서버를 받습니다. 이 서버는 Orkas 스킬 목록을 보여 주고, 작업에 맞는 스킬을 불러오며, 스킬에 딸린 스크립트를 실행합니다. Claude Code에 스킬 이름을 대고 쓰게 하거나, 알맞은 스킬을 스스로 찾게 할 수 있습니다.
  • Orkas는 Claude Code와 Codex의 스킬도 읽습니다. ~/.claude/skills와 ~/.codex/skills의 스킬은 스킬 ▸ 전역 폴더에 표시되고, 지휘 에이전트가 자기 작업에서 쓸 수 있습니다. Orkas는 이 폴더들을 읽기만 하고 절대 바꾸지 않습니다. ~/.agents/skills는 직접 읽지 않으므로, 위의 설정에서는 ~/.claude/skills의 링크를 통해 스킬을 찾습니다.

GitHub의 스킬 팩을 추가하려면 지휘 에이전트와의 채팅에 저장소 링크를 붙여 넣고 팩을 설치해 달라고 요청합니다. 팩이 의존성을 설치해야 하면 Orkas가 먼저 물어봅니다. 스킬은 스킬 ▸ 외부 패키지에 나타납니다. 그 후로는 Orkas에서 실행하는 Claude Code, Codex, OpenCode 모두 이 스킬을 쓸 수 있고, 세 폴더에 따로 복사할 필요가 없습니다. 시작하려면 사이드바에서 에이전트 연결을 선택하고 설치된 CLI를 고릅니다. 두 도구를 나란히 실행하는 전체 과정은 Claude Code와 Codex를 함께 실행하는 방법을 참고하세요.

Orkas에서 실행하기 앱 하나로 Claude Code, Codex, OpenCode에 같은 스킬을 제공합니다. Orkas는 macOS와 Windows에서 무료입니다. 이미 설치된 CLI를 본인의 로그인으로 실행합니다.
Orkas 다운로드 — 무료

어떤 설정을 선택해야 하나요?

상황할 일
한 컴퓨터에서 이 도구 중 두세 개를 쓴다스킬을 ~/.agents/skills에 두고 각각 ~/.claude/skills에 링크
팀이 저장소에서 스킬을 공유한다.agents/skills를 커밋하고, .claude/skills 링크는 설정 스크립트로 생성
GitHub에서 스킬을 자주 설치한다npx skills add. 같은 링크를 대신 만들어 줌
Claude Code와 OpenCode만 쓴다~/.claude/skills를 계속 사용. OpenCode가 이미 읽음
CLI를 Orkas에서 실행한다스킬 팩을 Orkas에 한 번 설치. Orkas가 실행하는 모든 CLI에서 사용 가능

자주 묻는 질문

Codex에서 Claude 스킬을 쓸 수 있나요?

네. Codex는 같은 SKILL.md 형식을 읽지만, ~/.claude/skills가 아니라 ~/.agents/skills와 .agents/skills에서 찾습니다. 스킬 폴더를 그곳으로 옮기고 Claude Code용으로 다시 링크하거나, Codex에서 /import를 실행해 복사합니다. allowed-tools 같은 필드나 $ARGUMENTS 같은 기능은 Claude Code에서만 동작합니다.

OpenCode는 Claude Code 스킬을 읽나요?

네. OpenCode는 ~/.agents/skills와 자체 폴더뿐 아니라 ~/.claude/skills와 .claude/skills도 읽으므로, Claude Code 스킬이 별도 설정 없이 나타납니다. 이를 끄려면 OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1을 설정합니다.

Claude Code는 .agents/skills를 읽나요?

아니요. 2026년 11월 현재 Claude Code는 .claude 폴더에서만 스킬을 읽으며, 문서에는 .agents 디렉터리 아래의 모든 것을 무시한다고 나와 있습니다. 이를 추가해 달라는 요청인 issue #31005는 아직 열려 있습니다. 그때까지는 ~/.claude/skills에서 각 스킬을 링크하세요.

Codex가 링크한 스킬을 인식하지 못하는 이유는 무엇인가요?

Codex는 링크된 스킬 폴더는 따라가지만, SKILL.md 파일 자체가 링크이면 무시합니다. 대신 폴더 전체를 링크하세요. 상대 링크는 링크가 있는 폴더를 기준으로 해석되므로, 그 위치에서 경로가 맞는지 확인하세요.

스킬이 두 번 표시되는 이유는 무엇인가요?

대개 도구가 읽는 폴더에 사본이 두 개 있기 때문입니다. Codex는 ~/.agents/skills뿐 아니라 예전 ~/.codex/skills 폴더도 여전히 읽어서, 같은 이름의 스킬 사본을 둘 다 목록에 보여 줍니다. ~/.agents/skills에 사본 하나만 두고 나머지는 지우세요.

스킬 외의 측면까지 세 도구를 비교하려면 Claude Code, Codex, OpenCode 비교를 참고하세요.