Codexを使っていると、毎回同じ前提や手順をプロンプトに書き直すのが面倒だと感じる場面があります。そこで役立つのがCodex Skillsです。
Codex Skillsは、作業の手順や知識をまとめてCodexに覚えさせ、必要なときだけ呼び出して使う機能です。コードレビューやテスト作成、ドキュメント整形といった作業を定型化し、毎回同じ指示を書く手間を減らせます。
この記事では、Codex Skillsとは何か、使い方、作り方、保存場所、おすすめのスキルまで、2026年6月時点の公式仕様をもとに整理します。あわせて、法人やチームで使うときの注意点も扱います。
前半で個人開発者の疑問を解消し、後半では社内で共有して定着させる進め方まで説明します。自分の業務のどこに使えるかが見えてくるはずです。
Codex Skillsとは？
Codex Skills（スキル）は、特定の作業に必要な手順・知識・スクリプトをまとめ、Codexに新しい能力を足す機能です。1つのスキルが1つのワークフローを表し、Codexがそれを読み込んで決まった流れで作業を進めます。
この見出しでは、スキルの基本的な仕組み、必要なときだけ読み込む「段階的開示」、そしてCLI・IDE拡張・Codex Appでの対応を順に説明します。まずは全体像を確認してください。
スキルは手順・知識・スクリプトをまとめた拡張機能
1つのスキルは、SKILL.md というファイルを中心にしたフォルダです。このファイルに作業の手順や知識を書いておくと、Codexがそれを参照して、決まった流れで作業を進められるようになります。
スキルは、Anthropicが2025年後半にClaude Codeで広めたAgent Skillsという共通形式に沿っています。そのため、CodexだけでなくClaude Codeなど他のAIコーディングツールでも、同じ形式のスキルを使えます。
毎回プロンプトに長い指示を書く代わりに、よく使う作業をスキルとしてまとめておくと、Codexに同じ品質の作業をくり返してもらいやすくなります。スキルは、再利用できるワークフローを作るための形式です。仕様の詳細はOpenAIのAgent Skills公式ドキュメントに記載があります。
エージェントという考え方そのものを整理したい場合は、AIエージェントの仕組みもあわせて確認してください。
必要なときだけ読み込む「段階的開示」で動く
Codex Skillsは、段階的開示（progressive disclosure）という考え方で動きます。Codexは最初、各スキルの名前・説明・ファイルの場所だけを把握しておき、実際に使うと判断したときに初めて SKILL.md の中身をすべて読み込みます。
この仕組みのメリットは、スキルを増やしてもコンテキスト（Codexが一度に扱う情報量）を圧迫しにくいことです。最初は1スキルあたり数十トークン程度の概要だけを持ち、必要になった分だけ詳しい手順を読み込みます。
つまり、たくさんのスキルを用意しておいても、使っていないスキルが毎回の処理を重くするわけではありません。よく使う作業を気軽にスキル化しておける作りになっています。
CLI・IDE拡張・Codex Appで使える
2026年6月時点では、Codex SkillsはCodex CLI、IDE拡張、Codex Appで使えます。普段の開発環境に合わせて、ターミナルでもエディタでも同じスキルを呼び出せます。
| 利用環境 | Codex Skillsの利用 |
|---|---|
| Codex CLI | 対応 |
| IDE拡張（VSCodeなど） | 対応 |
| Codex App | 対応 |
環境をまたいで同じスキルが使えるため、ターミナルで作ったスキルをエディタでもそのまま活用できます。なお、対応状況は今後変わる可能性があるため、運用前に公式ドキュメントで確認しておくと安心です。
Codex Skillsでできること・メリット
仕組みがわかったら、次に気になるのが「何が便利か」です。Codex Skillsは、毎回の指示を減らし、作業の品質をそろえ、よく使う作業を定型化するのに役立ちます。
この見出しでは、指示の手間を減らせる点、担当者ごとの作業のばらつきをそろえやすい点、コードレビューやテスト作成を定型化できる点を順に説明します。自分の業務のどこに効くかを考える材料になります。
毎回同じ指示を書く手間を減らせる
最も分かりやすいメリットは、毎回同じ前提や手順をプロンプトに書かなくて済むことです。レビューの観点や出力の形式など、いつも伝えている指示をスキルにまとめておけば、短い依頼でも同じ作業をしてもらえます。
たとえば「このコードをレビューして」と頼むだけで、スキルに書いた観点や出力形式に沿った結果が返ってきます。指示を毎回書き直す時間が減り、本来の作業に集中しやすくなります。
プロンプトの作り込みに時間をかけていた人ほど、この手間の削減を体感しやすいでしょう。まずは、自分がよくくり返している指示をスキルにする発想から始めてみてください。
担当者ごとの作業のばらつきをそろえやすい
スキルを使うと、誰が依頼しても同じ手順で作業を進めてもらえます。プロンプトの書き方が人によって違うと、出てくる結果の品質にも差が出ますが、スキルにまとめておけばその差を抑えやすくなります。
生成AI研修の受講企業では、同じツールを使っていても社員ごとに回答の品質がばらつくという相談がよくあります。レビュー観点やドキュメントの形式をスキルとして共有しておくと、チーム全体の作業の質をそろえやすくなります。
個人の使い方に頼らず、チームの共通の決まりごととしてスキルを持てるのが大きな利点です。属人化を防ぎたい場面で効果を発揮します。
コードレビューやテスト作成などを定型化できる
くり返し発生する作業ほど、スキルとの相性がよくなります。コードレビュー、テスト作成、ドキュメントの整形など、手順が決まっている作業を定型化できます。
定型化に向く作業の例としては、次のようなものがあります。
- 決まった観点でのコードレビュー
- 既存コードに合わせたテストの作成
- ドキュメントやリリースノートの整形
- 社内の決まったフォーマットへの変換
こうした作業をスキルにしておくと、毎回ゼロから指示する必要がなくなります。まずは1つ、頻度の高い作業をスキル化して効果を確かめてください。
Codex Skillsの使い方
ここからは、実際にスキルを使うイメージを持てるよう、呼び出し方を説明します。スキルの呼び出しには、明示的に指定する方法と、説明文に合わせて自動で呼ばれる方法の2つがあります。
この見出しでは、その2つの呼び出し方と、うまく動かないときの確認ポイントを順に紹介します。Codexそのものの基本はCodexの基本的な使い方でも解説しています。
明示的に呼び出す（/skillsや$で指定）
1つ目は、使うスキルを自分で指定する明示的な呼び出しです。プロンプトの中に使いたいスキルを直接書く方法で、確実に狙ったスキルを動かせます。
CLIやIDE拡張では、/skills コマンドを実行するか、$ を入力してスキルを指名できます。どのスキルがあるかを確認しながら選べるので、初めて使うときにも分かりやすい方法です。
まずは明示的な呼び出しで、スキルが意図どおりに動くかを確かめるのがおすすめです。動きを把握してから、次の自動呼び出しに進むとよいでしょう。
説明文に合わせて自動で呼び出される
2つ目は、Codexがタスクに合わせてスキルを選ぶ自動の呼び出しです。依頼の内容がスキルの説明文（description）と合致したときに、Codexが自動でそのスキルを使います。
この自動の呼び出しは、スキルのdescriptionの書き方しだいで精度が変わります。何をするスキルか、どんなときに使うかを具体的に書いておくほど、Codexが正しく選びやすくなります。
逆に説明文があいまいだと、使ってほしい場面で呼ばれなかったり、別のスキルが選ばれたりします。自動で使わせたいスキルほど、説明文の書き方に気をつけるとよいでしょう。
うまく動かないときに確認すること
スキルが思ったように動かないときは、いくつかの確認ポイントがあります。配置場所や説明文、必須項目のいずれかでつまずいていることが多いです。
確認したい項目は、次のとおりです。
SKILL.mdが所定のフォルダに置かれているか- frontmatterに
nameとdescriptionがあるか - 説明文に使う場面やトリガーとなる言葉が入っているか
- 自動で呼ばれない場合は明示的に指定して試したか
自動で呼ばれないときは、まず明示的に指定して動くかを確認すると、原因がスキル自体か説明文かを切り分けやすくなります。配置場所と必須項目から順に見直してください。
Codex Skillsの作り方
スキルは、自分で作って追加できます。基本は SKILL.md というファイルを用意し、名前と説明、そして手順を書くだけです。難しいプログラミングは必須ではありません。
この見出しでは、SKILL.md の基本構成、scripts・references・assetsで機能を足す方法、descriptionの書き方を順に説明します。最小構成から始められます。
SKILL.mdにname・descriptionと手順を書く
スキルの中心は SKILL.md というファイルです。ファイルの先頭にYAML形式のfrontmatterで name（名前）と description（説明）を書き、その下にMarkdownで手順を書きます。
最小構成は、たとえば次のような形です。
---
name: code-reviewer
description: コードをレビューするときに使う。観点はセキュリティ・バグ・テスト不足。
---
コードを次の観点でレビューしてください。
1. セキュリティ上のリスク
2. バグや競合
3. テストが足りない箇所必須項目は name と description の2つだけです。まずはこの最小構成で1つ作り、明示的に呼び出して動きを確認してください。作成手順の詳細はOpenAIのAgent Skills公式ドキュメントで確認できます。
scripts・references・assetsで機能を足せる
スキルは SKILL.md だけでも動きますが、フォルダの中に補助ファイルを足すと、できることを広げられます。手順だけのスキルが基本ですが、必要に応じてスクリプトや資料を組み込めます。
| フォルダ | 役割 |
|---|---|
scripts/ | 決まった処理を実行するスクリプトを置く |
references/ | 必要なときに読み込む参照資料を置く |
assets/ | 出力に使うテンプレートやアイコンなどを置く |
たとえば、長い社内ルールは references/ に置いておき、必要なときだけ読み込ませる使い方ができます。最初は手順だけのスキルで始め、足りない部分が出てきたらスクリプトや資料を追加していくと無理がありません。
descriptionは「いつ使うか」を具体的に書く
スキルを自動で正しく使わせるには、description の書き方が大切です。何をするスキルかだけでなく、どんなときに使い、どんなときに使わないかまで具体的に書きます。
説明文が短くまとめられても判断できるよう、よく使う場面やトリガーとなる言葉を前半に置くと、Codexが正しくスキルを選びやすくなります。検索キーワードのように、実際に使う言葉を入れるのがコツです。
社内で使うなら、説明文の書き方をそろえておくと、スキルが意図どおりに呼ばれる確率が上がります。説明文のテンプレートを決めておくだけでも、スキルの使われ方のばらつきを抑えやすくなります。
Codex Skillsの保存場所
作ったスキルは、決まったフォルダに置くことでCodexから使えるようになります。保存場所によって、個人用かプロジェクト用かが分かれます。
この見出しでは、保存場所の使い分けと、Claude Codeなど他ツールとの共通形式について説明します。チームで共有するときの考え方も整理しておくとよいでしょう。
個人用は~/.codex/skills/、プロジェクト用は.codex/skills/
スキルのフォルダは、用途に合わせて2か所に置けます。個人用は ~/.codex/skills/、プロジェクト用は .codex/skills/ です。1つのスキルが1つのフォルダになります。
| 保存場所 | 用途 |
|---|---|
~/.codex/skills/ | 個人用。どのプロジェクトでも使える |
.codex/skills/ | プロジェクト用。そのプロジェクト内で使える |
自分だけで常用するスキルは個人用に、チームで共有したいスキルはプロジェクト用に置くと使い分けられます。プロジェクト用のスキルはリポジトリに含めて共有できるため、チーム全体で同じスキルを使えるようになります。
Claude Codeなど他ツールとも共通形式で使える
Codex Skillsは、共通のAgent Skills形式に沿っています。そのため、同じ SKILL.md をClaude Codeなど他のツールでも使えます。
たとえばCodex用に作ったスキルのフォルダを、Claude Codeのスキル置き場にコピーすれば、そのまま使えるケースが多くあります。ツールを乗り換えても、作ったスキルをむだにしにくいのがメリットです。Claude Code自体の特徴はClaude Codeの特徴でも解説しています。
ただし、ツールによってスクリプトの動く環境や置き場所が異なる場合があります。スクリプトを含むスキルを別ツールで使うときは、動作を一度確認しておくと安全です。
おすすめのCodex Skills・活用例
スキルの作り方がわかったら、どんなスキルを用意すると便利かが気になります。ここでは、開発だけでなく業務改善にも役立つスキルの例を紹介します。
この見出しでは、コードレビュー・テスト作成、ドキュメント整形、社内の定型作業を覚えさせるスキルの3つを取り上げます。自社のどの作業に使えるかを考える材料になります。
コードレビュー・テスト作成スキル
開発で使いやすいのが、コードレビューとテスト作成のスキルです。レビュー観点やテストの方針をスキルにまとめておくと、毎回同じ基準で確認してもらえます。
レビュー用のスキルなら、セキュリティ・バグ・テスト不足・保守性といった観点を SKILL.md に書いておきます。テスト用のスキルなら、既存コードに合わせたテストのやり方や、確認してほしい範囲を指定しておくとよいでしょう。OpenAIが公開している公式のスキルリポジトリには、参考になるスキルの例があります。
レビューやテストは手順が決まっている作業のため、スキル化の効果を感じやすい分野です。最終的な確認は人が行う前提で、補助として使ってください。
ドキュメント作成・整形スキル
ドキュメントの作成や整形も、スキルにしやすい作業です。リリースノートの作成、READMEの更新、社内フォーマットへの変換などを定型化できます。
たとえば、社内で決まっているドキュメントの構成や書き方を references/ に入れておけば、その形式に合わせた文章を作ってもらえます。毎回フォーマットを説明する手間が減り、書き出しの作業が早くなります。
開発者以外でも、決まった形式の資料づくりにスキルを活用できます。文章の整形やフォーマット変換は、業務改善の効果が見えやすい使い方です。
社内の定型作業を覚えさせるスキル
スキルの活用は、開発チームの中だけにとどまりません。問い合わせの分類、データの整形、決まった手順のチェックなど、くり返し発生する社内の定型作業を覚えさせる使い方もできます。
企業のAI活用を支援していると、最初から大きな自動化を狙って手が止まる例をよく見かけます。まずは毎日くり返している小さな作業を1つスキルにして、効果を確かめてから対象を広げると無理がありません。
自社のどの業務にスキルや生成AIを使えるか迷う場合は、業種別・職種別にまとめた業務のAI活用事例集を確認し、自社に近い使い方を探すのが有効です。業務効率化の進め方はAIで業務効率化する方法とは？でも整理しています。
法人・チームでCodex Skillsを使うときの注意点
法人やチームでスキルを使うなら、管理のルールやセキュリティまで決めておく必要があります。便利な機能ほど、ルールなしに広げると確認の負荷や情報漏洩のリスクが増えやすいからです。
この見出しでは、スキルの管理ルールとレビュー体制、機密情報やスクリプトの扱い、社内で共有して定着させる進め方を順に説明します。社内ルールや運用定着まで考えたい場合は、生成AI導入ハンドブックもあわせて確認するとよいでしょう。
スキルの管理ルールとレビュー体制を決める
スキルを社内で使うなら、誰がスキルを作り、誰が確認するかを決めておく必要があります。スキルが自由に増えると、内容が重複したり、古い手順のまま使われたりすることがあります。
整えておきたいルールは、次のとおりです。
- スキルを追加・更新するときの承認の流れを決める
- 共有用スキルの置き場所と命名のルールを決める
- 使われなくなったスキルの削除の基準を決める
スキルの出力をそのまま使うのではなく、人が確認する範囲も決めておくと安心です。まずは少数の共有スキルから始め、運用しながらルールを整えてください。
機密情報やスクリプトの扱いに注意する
スキルには手順だけでなく、スクリプトや参照資料も含められます。便利な反面、機密情報を書き込んだり、安全でないスクリプトを混ぜたりすると、リスクにつながります。
確認しておきたい点は、次のとおりです。
- スキルに機密情報や認証情報を書き込んでいないか
- 共有するスクリプトの中身を確認しているか
- スキルが扱える権限を必要な範囲に絞っているか
外部から入手したスキルを使う場合は、中身のスクリプトや参照先を確認してから取り込んでください。社内で配る前に、機密情報が含まれていないかを点検すると安全です。
社内で共有して定着させる
スキルは作って終わりではなく、社内で共有して使われる状態にすることが大切です。便利なスキルがあっても、存在が知られていなければ使われないまま終わってしまいます。
AI活用支援の現場では、ツールやスキルを配るだけでは定着せず、使える人だけが使う状態になりやすい課題をよく見かけます。スキルの一覧や使い方の例をまとめ、部署単位で共有すると、利用の差を縮めやすくなります。
スキルを配るだけで終わらせず、社員が自分の業務改善に使える状態を目指すなら、実践型の研修を検討するのも一つの方法です。自社で使うツールに合わせて業務改善まで学びたい場合は、生成AI×業務改善研修 ベーシックプランのような研修も候補になります。
Codex Skillsに関するよくある質問
最後に、Codex Skillsについてよく寄せられる質問をまとめます。スラッシュコマンドやMCPとの違い、保存場所、自動利用の有無、他ツールとの互換性に絞って回答します。導入の判断材料にしてください。
- Codex Skillsとスラッシュコマンドの違いは？
-
スキルは手順・知識・スクリプトをまとめた拡張機能で、必要なときだけ読み込まれます。
/skillsはそのスキルを呼び出すためのコマンドです。スキルが中身、スラッシュコマンドが呼び出し方と考えると分かりやすくなります。 - SKILL.mdはどこに置く？
-
個人用は
~/.codex/skills/、プロジェクト用は.codex/skills/に、スキルごとのフォルダを作って置きます。各フォルダの中にSKILL.mdを入れ、nameとdescriptionを必ず書いてください。 - スキルは自動で使われる？
-
依頼の内容がスキルの説明文と合致すると、Codexが自動で選んで使います。確実に使いたいときは、
/skillsや$で明示的に指定してください。自動で呼ばれにくい場合は、説明文を見直すと改善します。 - Claude CodeのスキルはCodexで使える？
-
どちらも共通のAgent Skills形式に沿っているため、同じ
SKILL.mdを使えるケースが多くあります。ただしスクリプトの動く環境は異なる場合があるため、スクリプトを含むスキルは動作を確認してから使ってください。 - Codex SkillsとMCPの違いは？
-
スキルは作業の手順や知識をまとめてCodexに教える機能です。MCPは外部のツールやデータにつなぐ仕組みで、役割が異なります。手順を覚えさせたいならスキル、外部連携を足したいならMCP、と考えると整理しやすくなります。
まとめ
Codex Skillsは、作業の手順や知識をまとめてCodexに覚えさせ、必要なときだけ呼び出して使う機能です。要点を整理すると、次のとおりです。
- 毎回の指示を減らし、作業の品質をそろえやすくなる
- 作り方は
SKILL.mdにname・descriptionと手順を書くだけ - 保存場所は個人用
~/.codex/skills/、プロジェクト用.codex/skills/ - 共通形式のため、Claude Codeなど他ツールでも使える
個人で使うなら、まずよくくり返す作業を1つスキルにして、明示的に呼び出して動きを確かめてください。法人で使うなら、管理ルール・レビュー体制・社内共有までそろえることで、スキルが定着しやすくなります。
自社でどの業務にスキルや生成AIを使えるか整理したい場合は、業務のAI活用事例集で近い使い方を探すのが有効です。社内ルールや運用定着まで考えたい場合は、生成AI導入ハンドブックで必要なポイントを確認してください。自分の環境と目的に合わせて、Codex Skillsを使う範囲を決めていきましょう。
