Codex Skillsとは?使い方・作り方・保存場所とおすすめの始め方を解説

Codexで毎回同じような指示を打ち込んでいて、面倒だと感じていないでしょうか。「Skills(スキル)を使うと楽になる」と聞いても、世の解説の多くはエンジニア向けで、YAMLやフォルダ構成の話ばかりが並びがちです。
本記事では、Codex Skillsの意味から使い方・SKILL.mdの作り方・保存場所・何から始めればよいかまでを解説します。技術に詳しくない人にも分かる言葉でまとめました。
この記事を読めば、自社やチームにCodex Skillsを入れるべきか、入れると何が変わるかを判断できます。結論から言うと、Codex Skillsは「毎回口で教えていた作業手順をAIが読める1枚のマニュアルにして渡す」仕組みを指します。まずは用意済みのスキルを入れて試すのが近道です。
目次
- Codex Skillsとは【AIに定型作業を覚えさせる仕組み】
- Codex Skillsで何が変わるのか
- まずCodex Skillsを試す:用意されたスキルを入れて使う
- SKILL.mdの書き方とCodex Skillsを自分で作る手順
- Codex Skillsの保存場所【最新の正しいパス】
- Codex SkillsとClaude CodeのSkillsの関係
- Codex Skillsに関するよくある質問
- まとめ
- 参考リンク
Codex Skillsとは【AIに定型作業を覚えさせる仕組み】
Codex Skillsは、毎回口で教えていた作業手順を、AIが読めるマニュアルにまとめておく仕組みです。スキルの中身の作りや似た仕組みとの違いを先に知っておくと、どの作業をスキルにすべきかを判断しやすくなります。Codex Skillsの基本は、次の3点で押さえられます。
- 毎回の指示を1枚のマニュアルにまとめる仕組み
- スキルの正体は「手順書のフォルダ」
- スキルとプロンプト・AGENTS.md・MCPの違い
毎回の指示を1枚のマニュアルにまとめる仕組み
Codex Skillsは、AIに特定の作業のやり方を覚えさせ、必要なときに同じ手順で実行させる仕組みです。OpenAIの公式ドキュメントの定義は「指示・リソース・任意のスクリプトをまとめ、ChatGPTとCodexが決まったワークフローを確実にたどれるようにするパッケージ」です。
たとえば「議事録を決まった書式に整える」「PRの一次レビューをする」といった、毎回ほぼ同じ手順の作業があるとします。同じ作業を毎回言葉で指示する代わりに、手順を1つのマニュアルにして渡しておくのがスキルです。
OpenAIも、同じプロンプトを何度も使う作業や同じ修正を繰り返す作業は、スキルにすべきだと述べています。
スキルの正体は「手順書のフォルダ」
スキルの正体は、ファイルをまとめた1つのフォルダです。OpenAIの公式ドキュメントによると、中心になるのは「SKILL.md」という1つのファイルです。SKILL.mdには、いつ使うスキルかの説明と、実行してほしい手順を書きます。
フォルダには、必要に応じて補助のファイルも同梱できます。OpenAIが挙げているのは、実行するコードを入れる「scripts」・参照資料を入れる「references」・ひな形などを入れる「assets」といったフォルダです。とはいえ最小構成はSKILL.md 1枚だけでよいため、補助のファイルがなくても始められます。
スキルとプロンプト・AGENTS.md・MCPの違い
似た言葉と混同しやすいので、違いを整理しておきましょう。プロンプトは毎回入力する指示で、終われば残りません。一方スキルは、繰り返し使う手順を保存しておき、必要なときに呼び出せるのが違いです。
AGENTS.mdは、リポジトリ(コードの保管場所)全体に常に効く前提や規約を書くファイルです。OpenAIは、AGENTS.mdをプロジェクトの構成・ビルドやテストの方法・コード規約などを書く場所としています。
MCPは外部のサービスやツールとAIをつなぐ接続口です。CodexでMCPを設定する方法は、Codex MCPの記事で解説しています。
Codex MCPとは?mcp addとconfig.tomlの設定方法を解説
AGENTS.md・MCP・スキルの役割の分かれ方は、以下のとおりです。
- AGENTS.md:常時効かせる前提
- MCP:外部接続
- スキル:繰り返す特定作業の手順
なお、スキルとMCPサーバーをまとめて配布できる単位は、プラグインと呼ばれます。OpenAIはスキルとプラグインの使い分けを「集中した作業の再利用可能な指示ならスキル・接続先のサービスも含めて配布するならプラグイン」と示しています。
Codex自体の全体像は、Codexとは何かを解説した記事が詳しいです。
Codexとは?読み方や旧モデルとの違い・できることまで徹底解説!
Codex Skillsで何が変わるのか
Codex Skillsを入れるかどうかは、導入して何が変わるかで判断できます。変化は指示を書く人の手間だけでなく、スキルを使う現場やチーム全体にも及びます。Codex Skillsを導入すると変わることは、主に次の3つです。
- 毎回同じ指示を書く手間が消える
- 作る人と使う人を分けられる
- チームで品質と手順をそろえられる
毎回同じ指示を書く手間が消える
いちばん実感しやすい変化が、指示の手間の削減です。長い指示を毎回打ち込む代わりに、スキルを一度用意すれば、あとは短い言葉で同じ作業を呼び出せます。作業のたびに「あの書式で」「この順番で」と説明し直さずに済むのが利点です。
繰り返しの多い定型作業ほど、指示の手間が減る効果は大きくなります。日々の細かな指示から解放され、判断が必要な仕事に時間を回せるようになります。
作る人と使う人を分けられる
スキルの見落とされがちな価値が、作る人と使う人を分けられる点です。手順をよく分かっているエンジニアがスキルを1つ作れば、あとは非エンジニアが短い言葉で呼び出して使えます。中身の作り方を全員が覚える必要はありません。
作る人と使う人を分ける進め方は、社内にAIを広げたい組織にとって現実的です。詳しい人が型を用意し、現場は使うだけの分担にすれば、少人数でも全社に展開しやすくなります。
チームで品質と手順をそろえられる
スキルは、作業の品質を人によってぶれさせない土台にもなります。同じスキルを使えば、誰がやっても同じ手順・同じ出力になり、担当者による当たり外れが減るはずです。
さらにスキルはリポジトリに入れてチームで共有できるため、手順の更新も1か所を直すだけで全員に行き渡ります。属人化しがちな定型作業を、チームの共通の型に変えられるわけです。
まずCodex Skillsを試す:用意されたスキルを入れて使う
Codex Skillsは、自分で作る前に、まず用意されたスキルを試すのが近道です。最初から使えるスキルや後から入れられるスキルがあるため、自作しなくても効き目を確かめられます。Codexで用意されたスキルを使い始めるときは、以下の2点を押さえましょう。
- 最初から使えるスキルと入れられるスキル
- スキルの呼び出し方(自動と手動)
最初から使えるスキルと入れられるスキル
Codexには、最初から使えるスキルが用意されています。OpenAIの公式ドキュメントによると、スキルを作るための「skill-creator」と作業を計画する「plan」がすべての利用者に標準で提供されています。まずはskill-creatorとplanに触れると、スキルの感覚をつかめるはずです。
加えて、厳選されたスキルを後から入れることもできます。OpenAIは「skill-installer」というスキルを使ってローカルに導入できると案内しており、公式のスキル集(openai/skills)も参照先として挙げています。自作にこだわらず、まず用途に合うスキルを入れて使ってみるのがおすすめです。
スキルの呼び出し方(自動と手動)
スキルの呼び出し方は2通りです。1つは手動で、OpenAIの公式ドキュメントによるとCodexでは名前の前に「$」を付けるか、/skillsコマンドから選んで呼び出します(例:$skill-creator)。使いたいスキルを名前で指名するイメージです。
もう1つは自動で、スキルの説明文(description)に今の作業が合致すると、Codexが自動で該当するスキルを使います。だからこそ、説明文の書き方が使い勝手を大きく左右するのです。なおOpenAIの公式ドキュメントによると、スキルの変更は自動で反映されます。反映されないときは、Codexを再起動すれば認識されます。
SKILL.mdの書き方とCodex Skillsを自分で作る手順
Codex Skillsを自作するときは、SKILL.mdというファイルに説明と手順を書きます。書き方の決まりは少なく、skill-creatorに下書きを任せることもできます。Codex Skillsを自分で作るときは、次の4点を押さえましょう。
- スキルはSKILL.mdから作る
- nameとdescriptionの2つだけは必ず書く
- skill-creatorに作ってもらう
- 説明文(description)が使い勝手を決める
スキルはSKILL.mdから作る
自作の中心は、SKILL.mdというファイルです。ファイル名は小文字のskill.mdではなく、大文字のSKILL.mdである点に注意してください。OpenAIが示す最小の形は、ファイル冒頭の設定欄(フロントマター)に2項目を書き、設定欄の下に手順を書く形です。
OpenAIの公式テンプレートを平たく言うと、SKILL.mdは以下の順に書きます。
- ファイルの冒頭に「name(スキルの名前)」と「description(いつ使うかの説明)」を書く
- nameとdescriptionの下に、Codexにたどってほしい手順を文章で書く
nameとdescriptionと手順の本文を書くだけで、スキルは成立します。
nameとdescriptionの2つだけは必ず書く
必ず必要なのは、nameとdescriptionの2項目だけです。nameはスキルの識別名で、小文字とハイフンで付けるのが通例です。descriptionには、スキルをいつ使い、いつ使わないかを書きます。
nameとdescription以外の項目は、すべて任意です。手順が複雑なら補助のスクリプトや資料を足せますが、まずはnameとdescription、そして手順の本文があれば十分に動きます。難しく考えず、最小の形から始めましょう。
skill-creatorに作ってもらう
手書きが不安なら、標準で使えるskill-creatorに作ってもらう方法が簡単です。OpenAIの公式ドキュメントによると、Codexで「$skill-creator」と呼び出すと質問が返ってきます。何をするスキルか・どんなときに動かすか・スクリプトを含めるかを尋ねられ、下書きを組み立ててくれます。
skill-creatorで自分専用のスキルを仕上げる手順は、以下のとおりです。
- Codexで「$skill-creator」と呼び出す
- skill-creatorの質問に答えて、下書きを組み立ててもらう
- できた下書きを実際の作業で試す
- うまくいかない点を直す
skill-creatorを使えば、いきなり正しい書式を覚えなくても、対話しながらスキルの雛形を用意できます。
説明文(description)が使い勝手を決める
地味ですが最も大切なのが、descriptionの書き方です。Codexはdescriptionの説明文を見て、自動でスキルを使うか判断します。説明文が曖昧だと、狙ったときに動きません。OpenAIの推奨も、いつ使い・いつ使わないかを明確にし、主要な用途ときっかけになる言葉を前に置くことです。
たとえば「議事録を整えるスキル」なら「会議のメモを渡されたとき」という発動条件を、説明文の先頭に近い位置で書くと精度が上がります。手順の本文を作り込む前に、まずdescriptionの説明文を丁寧に書くのがコツです。
Codex Skillsの保存場所【最新の正しいパス】
Codex Skillsの保存場所は、解説によって食い違いがあり、混乱しやすい論点です。置き場所を間違えるとスキルが認識されない原因になり得るため、OpenAIの公式ドキュメントの最新情報で整理します。Codex Skillsの保存場所で押さえたい点は、以下のとおりです。
- 基準は「.agents/skills」フォルダ
- 個人用・リポジトリ用・全体用の使い分け
- 古い解説の「.codex/skills」に注意
基準は「.agents/skills」フォルダ
まず結論として、スキルの保存場所の基準は「.agents/skills」というフォルダです。OpenAIの公式ドキュメントの一覧表には、Codexが.agents/skillsを読み込むと明記されています。スキルのフォルダを.agents/skillsに置けば、Codexが見つけて使えるようになります。
なお、Windowsやリンクの扱いなど環境ごとの細かな差はありますが、覚えるべき基本は「.agents/skillsに置く」の一点です。まずは.agents/skillsという基準を押さえてください。
個人用・リポジトリ用・全体用の使い分け
同じ.agents/skillsでも、置く場所によって効く範囲が変わります。OpenAIの公式ドキュメントによると、置き場所の使い分けは大きく以下の3つです。
- 個人用:個人がどのプロジェクトでも使いたいスキルは、ホームフォルダ(自分のユーザー領域)の「.agents/skills」に置く
- リポジトリ用:特定のプロジェクトでチーム共有したいスキルは、リポジトリの中の「.agents/skills」に置いてコミットする
- 全体用:パソコンやコンテナ全体で共通に使うスキルは「/etc/codex/skills」に置く
目的に応じて、個人用・リポジトリ用・全体用の置き場所を選ぶのがコツです。
古い解説の「.codex/skills」に注意
Codex Skillsの保存場所で最も注意したいのが、古い解説の表記です。ネット上の解説記事の中には、保存場所を「.codex/skills」と書いているものが少なくありません。しかしOpenAIの最新の公式ドキュメントが示す基準は「.agents/skills」です。「.agents/skills」と「.codex/skills」は別のフォルダです。
古い情報のまま.codex/skillsに置くと、スキルが認識されない原因になり得ます。解説を読むときは、書かれているパスがOpenAIの公式ドキュメントの最新の表記と一致しているかを確かめてください。本記事の「.agents/skills」は、2026年9月13日時点のOpenAIの公式ドキュメントに基づく表記です。
Codex SkillsとClaude CodeのSkillsの関係
Claude Codeを併用している人向けに、Codex SkillsとClaude CodeのSkillsの関係を整理します。両者の共通点と注意点を知っておくと、スキルの作り方の考え方を両方のツールで生かせます。Codex SkillsとClaude CodeのSkillsの関係で押さえたい点は、以下のとおりです。
- 同じ形式なので資産を生かせる
- どちらで作るか迷ったら普段の作業で決める
同じ形式なので資産を生かせる
Codex SkillsとClaude CodeのSkillsは、同じ考え方のスキル形式です。どちらもSKILL.mdに、いつ使うかの説明と手順を書くという基本は共通しています。基本が共通しているため、一方で身につけた作り方の考え方は、もう一方でもそのまま生きます。
ただし、置き場所などツールごとの細かな違いには注意が必要です。スキルを移す際はフォルダの位置や環境の前提が変わる点に注意すれば、片方で作った型の考え方を無駄にせずに済みます。
どちらで作るか迷ったら普段の作業で決める
どちらのツールでスキルを作るか迷ったら、スキルにしたい作業を普段どちらで行っているかで決めるのが素直です。日常の開発をCodexで回しているならCodexで、Claude Codeが中心ならClaude Codeで作ると、呼び出しの流れが自然になります。
両方を使い分けている場合は、作業ごとに主に使うツール側へ寄せておくと、管理がすっきりします。CodexとClaude Codeの違い自体を詳しく知りたい人は、両者を比べた記事も参考にしてください。
CodexとClaude Codeの違いを徹底解説!料金比較と併用のコツも紹介
Codex Skillsに関するよくある質問
Codex Skillsを使い始める前に迷いやすい点を、非エンジニアでの利用・使えるプランと環境・機密情報の扱いの順にまとめました。Codex Skillsに関するよくある質問は、以下のとおりです。
- 非エンジニアでも使えますか?
- スキルはどのプラン・環境で使えますか?
- 機密情報を書いても大丈夫ですか?
非エンジニアでも使えますか?
非エンジニアでもCodex Skillsは使えます。とくに、用意されたスキルや誰かが作ったスキルを呼び出して使うだけなら、難しい知識は不要です。詳しい人がスキルを作り、現場は短い言葉で呼び出す分担にすれば、非エンジニアでも十分に使いこなせます。
一方で、スキルをゼロから作る作業には多少の慣れが要ります。まずは既存のスキルを使うところから始め、必要になったらskill-creatorに手伝ってもらうのがおすすめです。
スキルはどのプラン・環境で使えますか?
Codex Skillsを使える場所は、幅広く用意されています。OpenAIの公式ドキュメントによると、スキルを利用できる場所は以下の3つです。
- Codex CLI
- IDE拡張(VS Codeなどのエディタで使う拡張機能)
- ChatGPTデスクトップアプリ
普段使っている入口でそのまま使える、と考えて差し支えありません。また、プラグインに同梱されたスキルは、ChatGPTのウェブ版やスマートフォンのアプリでも使えるとOpenAIが案内しています。
なお、利用に必要なプランの階層や最低バージョンについては、OpenAIの公式ドキュメントに明確な記載が見当たりませんでした。スキル関連の更新は版ごとに続いているため、うまく使えない場合はCodexを最新版へ更新してから試してください。
機密情報を書いても大丈夫ですか?
スキルに機密情報を書くのは、避けるのが安全です。スキルはチームで共有したりリポジトリに入れたりするため、パスワードや顧客情報などの機密をSKILL.mdへ直接書き込むと、共有範囲に漏れる恐れがあります。手順は書いても、秘密の値は書かない、と切り分けてください。
また、スキルには実行されるスクリプトを同梱できるため、出所の分からないスキルをそのまま入れるのは避けましょう。Codexの安全な動かし方は、Codexのサンドボックスの記事で詳しく解説しています。
Codexのサンドボックスを徹底解説!自動承認を安全に使う設定も紹介
まとめ
Codex Skillsは、毎回口で教えていた作業手順を、AIが読める1枚のマニュアルにして渡す仕組みです。中心はSKILL.mdで、必須はnameとdescriptionの2項目です。保存場所の基準は、OpenAIの公式ドキュメントの最新表記で「.agents/skills」です。古い解説の「.codex/skills」とは別なので、注意してください。
Codex Skillsを導入すると、指示の手間が減ります。作る人と使う人を分けられ、チームで品質と手順をそろえられる点も利点です。
自作の前に、標準のskill-creatorやplan、OpenAIの公式のスキル集にあるスキルを入れて試すのが近道です。非エンジニアでも呼び出して使えるので、まずは用意済みのスキルを1つ動かし、自社の定型作業に効くかを確かめるところから始めましょう。



