Claude Code、Codex 和 OpenCode 都用同一種格式載入 skill:一個裡面放著 SKILL.md 檔案的資料夾。這個格式是開放的 Agent Skills 標準,由 Anthropic 建立,並在 2026 年 11 月 4 日成為 Linux Foundation 旗下的專案。所以同一個 skill 可以在三個工具中通用。問題在於每個工具找的資料夾不同,而且有些欄位只有 Claude Code 看得懂。本指南說明每個工具到哪裡找、如何只保留一份讓三者都能載入、哪些東西帶不過去,以及 Orkas 如何把同一套 skill 提供給它執行的每個 coding agent。
簡短答案:把每個 skill 資料夾放在 ~/.agents/skills。Codex 和 OpenCode 本來就會讀這個資料夾。Claude Code 不會,所以要在 ~/.claude/skills 中為每個 skill 加一個連結。frontmatter 只保留 name 和 description,並讓每個 skill 的名稱和它的資料夾名稱相同。已於 2026 年 11 月 8 日以 Claude Code 2.1.319、Codex 0.167.0 和 OpenCode 2.2.6 驗證。
Claude Code、Codex 和 OpenCode 到哪裡找 skill
| 資料夾 | Claude Code | Codex | OpenCode |
|---|---|---|---|
~/.agents/skills | 否 | 是 | 是 |
專案中的 .agents/skills | 否 | 是 | 是 |
~/.claude/skills | 是 | 否 | 是 |
專案中的 .claude/skills | 是 | 否 | 是 |
~/.codex/skills | 否 | 是(已棄用) | 否 |
~/.config/opencode/skills、.opencode/skills | 否 | 否 | 是 |
| 呼叫 skill 的方式 | /skill-name | $skill-name 或 /skills | @skill-name |
當你的要求符合某個 skill 的描述時,三者也都會自行選用該 skill。至於專案資料夾,每個工具都會檢查你啟動它的資料夾,以及一路往上到儲存庫根目錄的每一層上層資料夾。
- 找不到
.agents/skills的是 Claude Code。它的 skill 文件只列出.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 建立指向每個 skill 的連結。
- 把 skill 搬到
~/.agents/skills。你在~/.claude/skills或~/.codex/skills中自己寫的每個 skill,都把整個資料夾搬過去,例如mv ~/.claude/skills/release-notes ~/.agents/skills/。~/.claude/skills/synced請留在原處:Claude Code 會把你 claude.ai 帳號中的 skill 放在那裡。 - 把每個 skill 連結到 Claude Code 的資料夾。在 macOS 或 Linux 上執行下面的指令。那裡已經有資料夾或連結的 skill 會被略過。
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- 在 Windows 上使用 junction。不需要系統管理員權限。在 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 }
}- 在每個工具中確認。開一個新的工作階段。在 Claude Code 中輸入
/並找找該 skill。在 Codex 中執行/skills。在 OpenCode 中輸入@。
如果是團隊共用的專案,就在儲存庫中做同樣的事:把 skill 放在 .agents/skills,再從 .claude/skills 用相對連結指向每個 skill,例如 ln -s ../../.agents/skills/release-notes .claude/skills/release-notes。
有幾點要做對:
- 逐一連結每個 skill,而不是整個資料夾。如果
~/.claude/skills本身指向~/.agents/skills,Claude Code 的synced和.trash資料夾就會跑進共用資料夾,Codex 和 OpenCode 也可能載入那些同步過來的 skill。代價是每次新增 skill 後都要再跑一次迴圈。 - 連結資料夾,不要連結 SKILL.md 檔案。Codex 會跟隨被連結的 skill 資料夾,但會忽略本身就是連結的 SKILL.md。OpenAI 已將這項請求標為不在計畫中並關閉。
- 有使用 Windows 的隊友時,不要提交連結。Git for Windows 預設會把連結簽出成小型文字檔。請用設定腳本建立連結,或直接提交實際的副本。
- OpenCode 會看到每個 skill 兩次,並只保留一個。它會同時讀到
~/.claude/skills裡的連結和~/.agents/skills裡的資料夾。2.2 版會默默合併。1.19 版會記錄一則重複警告;設定OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1就能讓 OpenCode 不再讀 Claude 的資料夾。
寫一個三者都能載入的 skill
這個 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. 找出最後一個 tag:git describe --tags --abbrev=0
2. 列出那之後的 commit:git log <tag>..HEAD --oneline --no-merges
3. 依照這個 skill 資料夾中的 references/format.md,把 commit 分成 Added、Changed 和 Fixed。
4. 若要存成檔案,從這個 skill 的資料夾執行 scripts/write_notes.sh。- 讓 skill 名稱和資料夾名稱相同。只用小寫英文字母、數字和連字號,最多 64 個字元。Codex 以
name為準,OpenCode 2.2 以資料夾名稱為準,Claude Code 兩者都接受。如果兩者不同,同一個 skill 在各個工具中的呼叫名稱就會不一樣。名稱超過 64 個字元的 skill,Codex 會直接略過。 - description 要少於 1,024 個字元,並把使用者會用到的詞放在前面。這是標準規定的上限,Codex 在 skill 清單中也會把更長的 description 截到這個長度。
- 含有「冒號加空格」的值要加上引號。否則 frontmatter 可能無法解析。Codex 會修正大部分這類情況,Claude Code 會當成沒有 frontmatter 來載入 skill,OpenCode 則可能不報錯就略過這個 skill。
- 讓腳本自己找到所在的資料夾。這些工具是從你的專案資料夾執行指令,而不是從 skill 的資料夾。以
cd "$(dirname "$0")"開頭的腳本在任何位置都能正常執行。 - 名稱裡別放「claude」,如果你可能會把這個 skill 上傳到 claude.ai 或 Claude API 的話。兩者都會拒絕含有「claude」或「anthropic」的名稱。
哪些東西無法從 Claude Code 帶過去
Codex 只讀 name、description,以及 metadata 底下的一段簡短描述。OpenCode 2.2 另外也讀 metadata 和 disable-model-invocation。兩者都會忽略其他所有欄位而且不報錯,所以 Claude Code 的 skill 能載入,行為卻不一樣。
| Claude Code skill 中的寫法 | Claude Code | Codex | OpenCode 2.2 |
|---|---|---|---|
allowed-tools | 有效 | 忽略 | 忽略 |
disable-model-invocation: true | 有效 | 忽略;改用 agents/openai.yaml | 有效 |
context: fork、agent、model、hooks、argument-hint | 有效 | 忽略 | 忽略 |
內文中的 $ARGUMENTS 和 $1 | 替換成你的參數 | 保留為文字 | 保留為文字 |
內文中的 !`command` | 在 Claude 讀取 skill 前執行 | 保留為文字 | 保留為文字 |
${CLAUDE_SKILL_DIR} | 替換成 skill 的資料夾 | 保留為文字 | 保留為文字 |
- 寫出不靠這些功能也能運作的步驟。不用
${CLAUDE_SKILL_DIR},改寫成「從這個 skill 的資料夾執行 scripts/check.sh」;不用$ARGUMENTS,改成用一般的話詢問缺少的資訊。Claude Code 一樣能照著這些指示做。 - 要讓 Codex 不自行呼叫某個 skill,請在 skill 資料夾中加入
agents/openai.yaml,並把allow_implicit_invocation: false寫在policy底下。你仍然可以用$skill-name呼叫它。 allowed-tools無法限制 Codex 或 OpenCode 能做的事。npx skills的相容性表格把它列為兩者都支援,但這兩個工具的 skill 載入器都不讀這個欄位。請在各工具自己的權限設定中設下限制。
可替多個 agent 安裝 skill 的工具
| 工具 | 如何共用 skill | 注意事項 |
|---|---|---|
npx skills(Vercel,38,500 顆星) | 把 skill 複製到 .agents/skills,再把每個 agent 的資料夾連結到那裡。在 Windows 上使用 junction。--copy 會建立各自獨立的副本。 | 和本指南的配置相同。執行 npx skills add owner/repo,加上 -g 則安裝到你的使用者資料夾。 |
| skillshare(2,900 顆星) | 保留一個來源資料夾,並把它連結到每個工具的資料夾;在 Windows 上使用 junction。 | 2026 年 11 月 6 日更新。可用 Homebrew 或 shell 腳本安裝。 |
Codex /import | 把 skill 從 .claude/skills 複製到 .agents/skills。 | 副本會和原本的 skill 逐漸不一致。它還會把內文中的「claude」改成「Codex」,連檔案路徑裡的也會改(尚未解決的 issue #40147)。 |
| openskills(10,800 顆星) | 把 skill 複製到 .claude/skills,並在 AGENTS.md 中列出。 | 自 2026 年 1 月以來沒有新版本。它的 --universal 選項會寫入 .agent/skills,而這三個工具都不讀這個資料夾。 |
那 CLAUDE.md 和 AGENTS.md 呢?
Codex 和 OpenCode 會讀 AGENTS.md,而專案中沒有 AGENTS.md 時,OpenCode 會改讀 CLAUDE.md。從 2.1.277 版開始,Claude Code 也會讀 AGENTS.md,但僅限於沒有 CLAUDE.md 或 CLAUDE.local.md 的專案。如果兩個檔案都要保留,請在 Claude Code 中開啟 /config,把 Project instructions 設成兩者都載入。所有 agent 都該遵守的規則寫在 AGENTS.md,只有 Claude Code 需要的內容則留在 CLAUDE.md。
在 Orkas 中使用同一套 skill
Orkas 是一款桌面應用程式,能在同一個對話中把 Claude Code、Codex、OpenCode、OpenClaw 和 Hermes 當作 agent 來執行。它使用你電腦上已安裝的版本,以及你自己的登入。以下是你的 skill 傳到這些 agent 的方式。
- 共用資料夾照常運作。Orkas 啟動各個 CLI 時,它們仍會讀自己的 skill 資料夾,所以上面的設定不必修改就能用。Orkas 會在你的 MCP 伺服器旁邊加上自己的 MCP 伺服器,而不是取代它們。
- 在 Orkas 中新增的 skill 會傳到每個 CLI。Orkas 啟動的每個 CLI 都會拿到一個名為
orkas的 MCP 伺服器。它會列出你的 Orkas skill,在任務相符時載入其中一個,並執行該 skill 附帶的腳本。你可以指名要 Claude Code 使用某個 skill,也可以讓它自己找出合適的那一個。 - Orkas 也會讀你的 Claude Code 和 Codex skill。
~/.claude/skills和~/.codex/skills中的 skill 會出現在 技能庫 ▸ 全域資料夾 底下,指揮官也能在自己的任務中使用它們。Orkas 只讀取這些資料夾,從不修改。它不會直接讀~/.agents/skills,所以在上面的設定下,它是透過~/.claude/skills裡的連結找到你的 skill。
要從 GitHub 加入 skill 套件,把儲存庫連結貼到和指揮官的對話中,請它安裝這個套件。如果套件需要安裝相依套件,Orkas 會先詢問你。這些 skill 會出現在 技能庫 ▸ 外部套件 底下。之後從 Orkas 執行 Claude Code、Codex 和 OpenCode 時,三者都能使用它們,不必把任何東西複製到三個資料夾。要開始使用,請在側邊欄選擇 接入智慧代理,再挑選你已安裝的 CLI。想看並排執行其中兩個的完整步驟,請參考如何讓 Claude Code 和 Codex 一起用。
該選哪種設定?
| 你的情況 | 該怎麼做 |
|---|---|
| 你在同一台電腦上用其中兩到三個工具 | 把 skill 放在 ~/.agents/skills,並逐一連結到 ~/.claude/skills |
| 團隊在儲存庫中共用 skill | 提交 .agents/skills;用設定腳本建立 .claude/skills 的連結 |
| 你常從 GitHub 安裝 skill | npx skills add,它會幫你建立同樣的連結 |
| 你只用 Claude Code 和 OpenCode | 繼續用 ~/.claude/skills;OpenCode 本來就會讀它 |
| 你從 Orkas 執行這些 CLI | 在 Orkas 中安裝一次 skill 套件;它啟動的每個 CLI 都能用 |
常見問題
Codex 能用 Claude 的 skill 嗎?
可以。Codex 讀取相同的 SKILL.md 格式,但它找的是 ~/.agents/skills 和 .agents/skills,而不是 ~/.claude/skills。把 skill 資料夾搬過去,再為 Claude Code 連結回來;或在 Codex 中執行 /import 把它們複製過去。allowed-tools 等欄位和 $ARGUMENTS 等功能只在 Claude Code 中有效。
OpenCode 會讀 Claude Code 的 skill 嗎?
會。OpenCode 會讀 ~/.claude/skills 和 .claude/skills,也會讀 ~/.agents/skills 和它自己的資料夾,所以 Claude Code 的 skill 不需任何設定就會出現。要關閉這項行為,請設定 OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1。
Claude Code 會讀 .agents/skills 嗎?
不會。截至 2026 年 11 月,Claude Code 只從 .claude 資料夾讀取 skill,它的文件也說會忽略 .agents 目錄下的所有內容。要求加入這項支援的 issue #31005 仍未關閉。在那之前,請從 ~/.claude/skills 逐一連結每個 skill。
為什麼 Codex 看不到我連結的 skill?
Codex 會跟隨被連結的 skill 資料夾,但會忽略本身就是連結的 SKILL.md 檔案。請改為連結整個資料夾。相對連結是以連結所在的資料夾為基準來解析,所以請確認從那裡看過去的路徑是正確的。
為什麼某個 skill 會出現兩次?
通常是因為工具會讀的資料夾裡有兩份副本。Codex 除了 ~/.agents/skills,仍會讀舊的 ~/.codex/skills 資料夾,並把同名 skill 的兩份副本都列出來。在 ~/.agents/skills 保留一份,刪除另一份。
若要比較這三個工具在 skill 以外的差異,請參考 Claude Code vs Codex vs OpenCode。