Codex でスキルを使う方法：スキルの置き場所と呼び出し方

Codex がスキルを探す場所

OpenAI の Codex のドキュメント（英語版）から、2026 年 11 月 6 日に確認。シンボリックリンクのフォルダーもたどります。同じ名前のスキルが 2 つあっても Codex はまとめず、両方が一覧に出ることがあります。

Mac と Windows でスキルを入れる

ダウンロードのフォルダーに、すぐ下に SKILL.md がある crash-triage というフォルダーがあるとします。

Mac・Linux はターミナルで：

mkdir -p ~/.agents/skills
cp -R ~/Downloads/crash-triage ~/.agents/skills/

Windows は PowerShell で。OpenAI が示すパスは $HOME/.agents/skills の 1 つだけで Windows 用の別のパスはなく、PowerShell の $HOME は自分のユーザーフォルダー、つまり %USERPROFILE% の値です（Microsoft のドキュメント）。

New-Item -ItemType Directory -Path "$HOME\.agents\skills" -Force
Copy-Item -Path "$HOME\Downloads\crash-triage" -Destination "$HOME\.agents\skills" -Recurse -Force

-Path には、すぐ下に SKILL.md があるフォルダーを指定します。［すべて抽出］で Downloads\crash-triage\crash-triage のように 1 段深くなっていたら、内側のフォルダーをコピーします。コピー先を skills のフォルダーそのものにするとフォルダーの名前が保たれ、-Force があるので新しい版も同じコマンドで入れ直せます。

新しいスキルは Codex が自分で見つけます。出てこなければ Codex を再起動します。入れたら /skills で一覧に出ているかを確かめます。WSL の中で Codex を動かしているなら、そちらは Linux のホームを使うので、スキルもそこに入れます。

リポジトリにあるスキル（OpenAI がキュレーションしたものなど）は、組み込みのインストーラーに頼めます。たとえば $skill-installer linear。ほかのリポジトリからダウンロードするよう頼むこともできます。

スキルを呼び出す・Codex に選ばせる

名前を書かなくても、頼んだ内容がスキルの説明に合えば Codex がそのスキルを選びます。スキルがたくさんあると Codex は説明を短くして並べるので、説明の頭に主な使いどころと、実際に打ちそうな言葉を置きます。

スキルを消さずに止めるには、~/.codex/config.toml に次を書き、Codex を再起動します。

[[skills.config]]
path = "/path/to/skill/SKILL.md"
enabled = false

例：クラッシュ調査のスキルを、Codex と Claude Code で

架空の例です。3 人のスタジオがスマートフォンのアプリを出しています。玲奈さんは Mac の Codex CLI、颯太さんは Windows の Codex、外部の協力者の小野さんは Claude Code を使います。クラッシュの報告が届くたびに、玲奈さんはこう貼り付けます。

クラッシュのログです。ライブラリではなく、うちのコードで最初に出てくるスタックフレームを探して。ファイルと行、パンくずからわかるユーザーの操作、影響したユーザーの数とアプリのバージョンを出し、「[crash] <画面>: <エラー>」というタイトルで issue の下書きを作って。

このプロンプトと、先週手で書いた issue 2 件を、ほしい出力の見本として「プロンプトをスキルにする」スキルに渡すと、次のように始まる SKILL.md が返ってきます。

---
name: crash-triage
description: スマートフォンのアプリのクラッシュログを調べる。チームのコードで最初のスタックフレーム、ユーザーの操作、影響したユーザー数とアプリのバージョンを出し、issue を下書きする。クラッシュログやスタックトレースを貼られたとき、「なぜアプリが落ちる？」と聞かれたときに使う。
---

## 手順
1. ライブラリとシステムのフレームは飛ばす。うちのコードで最初の
   フレームを疑う。
2. パンくずから、ユーザーがしたことを 1 文で書く。
...

1. 玲奈さんは ~/.agents/skills/crash-triage/SKILL.md として保存し、次の報告で $crash-triage と呼び出します。
2. 颯太さんは上の PowerShell の 2 行を実行します。/skills に crash-triage が出ます。
3. 小野さんの Claude Code は .agents/skills を読みません。小野さんは ~/.claude/skills/ にもフォルダーをコピーします。これで 3 台のパソコンに 3 つのコピーができました。

玲奈さんが issue のタイトルの形を変えても、ほかの 2 つのコピーは古い形のままです。

次の一歩：Codex にも Claude Code にも、チームにも、1 つのコピーで

1 台のパソコンの中なら、1 つのフォルダーを ~/.agents/skills と ~/.claude/skills の両方にリンクすれば、Codex と Claude Code が同じファイルを読みます。リンクの張り方は Claude Code・Codex・Cursor・OpenCode にスキルを同期する方法にあります。ただ、人と人のあいだでは、コピーはやはりずれていきます。

AI Skill Pod（このサイトの製品）なら、AI スキルを、チームでかんたん共有。無料で始められます。チームのポッドを各自が 1 回だけ追加します。Codex では codex mcp add とポッドのリンクのあと codex mcp login を実行し、使っているほかの AI（Claude Code、Cursor、Claude、ChatGPT（Pro・Business・Enterprise））でも、それぞれ 1 回つなぎます。これで全員が同じスキルを使え、直した内容は、次にそれぞれの AI がスキルを取りにいったときに全員に届きます。ポッドのスキルは /skills には出ず、Codex は仕事が合ったとき、または名前で頼まれたときに、ポッドから取りにいきます。Free は 3 人・スキル 10 個までです。

よくある質問

Codex のスキルはどこに置く？

自分のスキルは $HOME/.agents/skills/<skill-name>/SKILL.md に置けば、どのリポジトリでも使えます。リポジトリのスキルは .agents/skills に置き、Codex は起動したフォルダーからリポジトリのルートまでを探します。ほかに、マシン全体で使う /etc/codex/skills と、Codex に最初から入っているシステムスキルがあります。

Codex でスキルを呼び出すには？

Codex CLI と IDE 拡張では、プロンプトに $ とスキル名を書くか、/skills を実行して一覧から選びます。頼んだ内容がスキルの説明に合えば、Codex が自分でスキルを選ぶこともあります。

Windows では Codex のスキルをどこに置く？

OpenAI が示すパスは $HOME/.agents/skills の 1 つだけで、Windows 用の別のパスはありません。PowerShell の $HOME は自分のユーザーフォルダー（%USERPROFILE% の値で、ふつうは C:\Users\<ユーザー名>）なので、このページのコマンドはそのまま使えます。入れたら /skills に出るかを確かめます。

~/.codex/skills と ~/.agents/skills、どちらが正しい？

OpenAI のドキュメントにあるのは .agents/skills で、$HOME の下とリポジトリの中です。~/.codex のフォルダーには Codex の設定ファイル config.toml があり、スキルを止めるときはそこに書きます。