Claude Code、Codex、OpenCode は、どれも同じ形式でスキルを読み込みます。SKILL.md ファイルを入れたフォルダという形式です。これはオープンな Agent Skills 標準で、Anthropic が作成し、2026年11月4日に Linux Foundation のプロジェクトになりました。つまり、1つのスキルを3つのツールすべてで使えます。ただし、ツールごとに探すフォルダが違い、Claude Code にしか通じないフィールドもあります。このガイドでは、各ツールがどこを探すか、3つすべてが読み込むコピーを1つだけ持つ方法、引き継がれないもの、そして 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 Code | Codex | OpenCode |
|---|---|---|---|
~/.agents/skills | いいえ | はい | はい |
プロジェクト内の .agents/skills | いいえ | はい | はい |
~/.claude/skills | はい | いいえ | はい |
プロジェクト内の .claude/skills | はい | いいえ | はい |
~/.codex/skills | いいえ | はい(非推奨) | いいえ |
~/.config/opencode/skills、.opencode/skills | いいえ | いいえ | はい |
| スキルの呼び出し方 | /skill-name | $skill-name または /skills | @skill-name |
3つとも、リクエストがスキルの説明と合えば、そのスキルを自分で選んで使います。プロジェクトのフォルダについては、各ツールは起動したフォルダと、そこからリポジトリのルートまでのすべての親フォルダを確認します。
- 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 系でも同じです。
共有フォルダを1つ用意する
実体のコピーは ~/.agents/skills の1つだけにします。Codex と OpenCode は何も設定しなくてもここを読み、npx skills も Codex のインポーターもここに書き込みます。そのうえで Claude Code には各スキルへのリンクを用意します。
- スキルを
~/.agents/skillsに移します。~/.claude/skillsや~/.codex/skillsに自分で書いたスキルは、それぞれフォルダごと移動します。例:mv ~/.claude/skills/release-notes ~/.agents/skills/。~/.claude/skills/syncedはそのままにしてください。Claude Code は claude.ai アカウントのスキルをそこに置いています。 - 各スキルを 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- 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 }
}- 各ツールで確認します。新しいセッションを始めます。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 は各スキルを2回見つけ、1つだけ残します。
~/.claude/skillsのリンクと~/.agents/skillsのフォルダの両方を読むためです。バージョン 2.2 は何も表示せずにまとめます。バージョン 1.19 は重複の警告をログに出します。OpenCode に Claude のフォルダを読ませたくない場合はOPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1を設定してください。
3つすべてで読めるスキルを書く
次の 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 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 がスキルを読む前に実行される | 文字列のまま | 文字列のまま |
${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) | 元のフォルダを1つ持ち、それを各ツールのフォルダにリンクします。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 に書き込みますが、3つのツールのどれもそこを読みません。 |
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 を1つのチャットの中でエージェントとして動かすデスクトップアプリです。パソコンにインストール済みの各ツールと、あなた自身のサインインをそのまま使います。スキルがこれらのエージェントに届く仕組みは次のとおりです。
- 共有フォルダはそのまま使えます。Orkas が起動しても、各 CLI は自分のスキルフォルダを読むので、上の設定は変更なしで動きます。Orkas は既存の MCP サーバーを置き換えず、その隣に自分の MCP サーバーを追加します。
- Orkas で追加したスキルはすべての CLI に届きます。Orkas が起動するすべての CLI には、
orkasという名前の MCP サーバーが渡されます。このサーバーは Orkas のスキルを一覧し、タスクに合うものを読み込み、スキルに付属するスクリプトを実行します。Claude Code にスキル名を指定して使わせることも、適切なスキルを自分で見つけさせることもできます。 - Orkas は Claude Code と Codex のスキルも読みます。
~/.claude/skillsと~/.codex/skillsにあるスキルは スキル ▸ グローバルフォルダ に表示され、Commander が自分のタスクで使うこともできます。Orkas はこれらのフォルダを読むだけで、変更することはありません。~/.agents/skillsは直接読まないため、上の設定では~/.claude/skillsのリンクを通じてスキルを見つけます。
GitHub からスキルパックを追加するには、Commander とのチャットにリポジトリのリンクを貼り、パックのインストールを頼みます。パックが依存関係をインストールする必要がある場合、Orkas は先にあなたに確認します。スキルは スキル ▸ 外部パッケージ に表示されます。それ以降は、Orkas から実行する Claude Code、Codex、OpenCode のどれもがそのスキルを使え、3つのフォルダに何かをコピーする必要はありません。始めるには、サイドバーで エージェントを接続 を選び、インストール済みの CLI を選びます。2つを並べて動かす手順の詳細は、Claude Code と Codex を一緒に使う方法をご覧ください。
どの構成を選ぶべきか
| 状況 | やること |
|---|---|
| 1台のパソコンでこのうち2〜3個のツールを使っている | スキルを ~/.agents/skills に置き、それぞれを ~/.claude/skills にリンクする |
| チームがリポジトリでスキルを共有している | .agents/skills をコミットし、.claude/skills のリンクはセットアップスクリプトで作る |
| GitHub からよくスキルをインストールする | npx skills add。同じリンクを自動で作ってくれる |
| Claude Code と OpenCode しか使わない | ~/.claude/skills をそのまま使う。OpenCode はすでにここを読む |
| CLI を Orkas から実行している | スキルパックを Orkas に一度インストールする。Orkas が起動するすべての CLI で使える |
よくある質問
Claude のスキルは Codex で使えますか?
はい。Codex は同じ SKILL.md 形式を読みますが、探すのは ~/.agents/skills と .agents/skills で、~/.claude/skills は見ません。スキルフォルダをそちらに移して Claude Code 用にリンクを張るか、Codex で /import を実行してコピーします。allowed-tools などのフィールドや $ARGUMENTS などの機能は、Claude Code でしか動きません。
OpenCode は Claude Code のスキルを読みますか?
はい。OpenCode は ~/.claude/skills と .claude/skills に加えて、~/.agents/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 ファイル自体がリンクの場合は無視します。代わりにフォルダごとリンクしてください。相対リンクはリンクが置かれたフォルダを基準に解決されるので、そこから見てパスが正しいか確認してください。
スキルが2つ表示されるのはなぜですか?
たいていは、ツールが読むフォルダにコピーが2つあるためです。Codex は ~/.agents/skills に加えて古い ~/.codex/skills フォルダもまだ読み、同じ名前のスキルを両方とも一覧に出します。~/.agents/skills にコピーを1つ残し、もう一方は削除してください。
スキル以外の点も含めて3つのツールを比べるには、Claude Code vs Codex vs OpenCode をご覧ください。