2026年7月22日

Codexスキル完全ガイド:基本概念からチーム活用まで

Codexスキルとは?従来のプロンプトとの違い

公式画面

通常のプロンプト vs Codexスキル
通常のプロンプト
  • 毎回ゼロから書く
  • 指示を手渡す感覚
  • 品質に揺れが出る
Codexスキル
  • 再利用可能なブロック(指示・リソース・スクリプト)
  • エージェントに役割を委譲
  • 再現性が高い
  • フォルダ単位で管理(.codex/skills/)
  • AGENTS.mdにパスを明示

スキルと通常のプロンプトの違い

テキトー教師テキトー教師DotAI 認定講師
最初に「Codexスキルって、結局ただのプロンプトのテンプレートですよね?」って聞かれるんです。誤解されてる部分なんですけど、実は構造が全然違うんですよ。
室谷室谷代表取締役
そうなんですよね。通常のプロンプトは毎回ゼロから書くものですが、スキルは指示・リソース・スクリプトをひとまとめにした再利用可能なブロック。

Agents SDKでいうツールのワークフロー版ですね。
テキトー教師テキトー教師DotAI 認定講師
だから「また同じ説明を書かなくて済む」という以上に、Codexが自動的にスキルを選んで使ってくれる点が大きい。プロンプトを手渡すのではなく、エージェントに役割を委譲する感覚です。

スキルのフォルダ構成とSKILL.md

テキトー教師テキトー教師DotAI 認定講師
スキルは .codex/skills/ の下にフォルダを作って、その中に SKILL.md を置くんです。最初は「どこに置けばいいんだ?」って迷う人が多いですね。
室谷室谷代表取締役
フォルダ単位で管理できるのがポイント。チームで使う場合、この構造が効くんですよ。

リポジトリごとにスキルを整理すれば、プロジェクトのルールやナレッジがそのままCodexに反映される。
テキトー教師テキトー教師DotAI 認定講師
ただ、AGENTS.mdにスキルのパスを明示しないとCodexが自動で拾ってくれないケースがあるみたいです。コミュニティの投稿でもそこが話題になってました。
室谷室谷代表取締役
そこは運用次第ですね。私はルートのAGENTS.mdに一覧を書くようにしています。

手間は一瞬ですが、発見性が格段に上がる。

スキルがもたらす再現性と効率

テキトー教師テキトー教師DotAI 認定講師
スキルの真価は再現性だと思います。同じ品質のコードレビューやデプロイ手順を、何度でも正確にエージェントに任せられる。

プロンプトを毎回手書きすると、どうしても揺れが出ますから。
室谷室谷代表取締役
時給換算すると、スキル一つ作るコストはせいぜい30分。でもそのスキルが100回使われれば、毎回の指示書きが省略できる。

ROIで考えたらバカにならないです。
テキトー教師テキトー教師DotAI 認定講師
しかもスキルはコード生成以外にも使える。情報収集やドキュメント作成にも応用できるので、開発チーム以外のメンバーも恩恵を受けられますね。

スキルの作り方と使い方:初心者でもできる設定手順

スキル呼び出し方法の比較
明示的な呼び出し
  • プロンプトでスキル名を指定(例:「reviewスキルを使って」)
  • 確実にそのスキルが使われる
  • 手動で指示する必要がある
自動選択
  • タスクの文脈からCodexが自動判断
  • 使ってほしいスキルがスルーされる可能性あり
  • AGENTS.mdに記載すると優先的に選択されやすくなる

スキル作成の基本テンプレート

テキトー教師テキトー教師DotAI 認定講師
スキルって、プロンプトよりもう少し構造化されたやつですよね。指示とリソースとスクリプトをひとまとめにできるとか。
室谷室谷代表取締役
そうです。.codex/skills/ 配下に SKILL.md を置くだけ。

これが基本テンプレートですね。中に「あなたは〇〇エキスパートです」とか呼び出し条件を書く。
テキトー教師テキトー教師DotAI 認定講師
最初に戸惑うのが「何を書けばいいか」なんですよ。僕が作るなら「レビュアーとしての視点」と「チェックリスト」を書きます。
室谷室谷代表取締役
その感覚でいい。ROIで考えると、10分で作ったスキルが毎回のレビュー品質を一定に保つ。

時給換算すればすぐペイします。

明示的な呼び出しと自動選択の仕組み

テキトー教師テキトー教師DotAI 認定講師
スキルをどうやってCodexに使わせるかが次の疑問ですね。呼び出し方は2通りあると。
室谷室谷代表取締役
明示的か自動か。明示的ならプロンプトで「reviewスキルを使って」と言えばいい。

自動選択はコードレビュー時に「これはreviewスキルが使えるな」とCodexが判断する。
テキトー教師テキトー教師DotAI 認定講師
自動選択、最初は「ちゃんと動くのかな」って不安になります。でも実際はタスクの文脈を見て結構賢く選んでくれます。
室谷室谷代表取締役
ただ、自動選択に任せすぎると使ってほしいスキルがスルーされることもある。その場合は後述のAGENTS.mdで制御するのが定石ですね。

AGENTS.mdへの記載とスコープ設定

テキトー教師テキトー教師DotAI 認定講師
AGENTS.mdって、プロジェクトルートに置くあのファイルですよね。あそこにスキル一覧を書くと優先的に使われるとか?
室谷室谷代表取締役
そうです。コミュニティの情報だと、AGENTS.mdのAvailable skillsリストにスキル名を書いておくと、Codexが自動選択しやすくなる。

必須ではないけど絶対使わせたいなら書いておくのが無難。
テキトー教師テキトー教師DotAI 認定講師
スコープ設定も大事ですよね。プロジェクト全体向けのスキルか、特定ディレクトリだけか。
室谷室谷代表取締役
そこはAGENTS.mdの置き場所で調整できる。ルートに置けば全体、サブディレクトリに置けばその範囲だけ。

現場だと、チームごとにAGENTS.mdを分けて運用してるケースが多いですね。

スキルを活用した業務自動化の実践例

コードレビュースキルによる品質向上

室谷室谷代表取締役
コードレビューにスキルを使うと、レビュー漏れが減るんですよね。シリコンバレーのチームだとレビュー時間が半分になったって話もあります。
テキトー教師テキトー教師DotAI 認定講師
実はレビュースキルを作っても、Codexが自動で使ってくれないケースがあるんですよ。AGENTS.mdに記載する必要がある、みたいな議論がコミュニティでありました。
室谷室谷代表取締役
そこは設定の工夫次第ですね。チームで統一すれば効果は大きい。

MYUUUでもレビュースキルを導入して、品質が安定しました。
テキトー教師テキトー教師DotAI 認定講師
最初は手動で指定しても、徐々に習慣化します。スキルの再利用性が高いから、一度作ればチーム全体で使えます。

ゲーム開発自動化の大規模事例

テキトー教師テキトー教師DotAI 認定講師
OpenAIが公開したレーシングゲームの事例、すごかったですよね。一つのプロンプトから700万トークン使ってゲームを生成したとか。
室谷室谷代表取締役
あの規模になると、スキルとエージェントの連携が鍵です。画像生成スキルやWebゲーム開発スキルを組み合わせて、完全に自律開発してる。
テキトー教師テキトー教師DotAI 認定講師
しかも自分でテストまでやるんです。QAエージェントとしても動く。

開発ライフサイクル全体をスキルでカバーできる。
室谷室谷代表取締役
まさにエージェントに「デザイナー、開発者、テスター」の役割を全部任せる時代になりましたね。

非エンジニア向けスキル(メール、会議)

テキトー教師テキトー教師DotAI 認定講師
スキルはコードだけじゃないんですよ。メールの下書きや会議の議事録作成にも使える。

非エンジニアが使いやすいのがポイント。
室谷室谷代表取締役
経営視点だと、そういう定型業務をスキル化すると時給換算で大きな効率化になります。毎回プロンプトを考える手間が省ける。
テキトー教師テキトー教師DotAI 認定講師
そうです。テンプレートをスキルにしておけば、ワンクリックで適用できる。

最初に戸惑うのは「スキルってどう使うの?」ってところですが、一度覚えれば簡単です。

スキル導入で変わるチーム開発の現場

まとめ
スキル導入で変わるチーム開発の現場
  • Codexアプリでは複数エージェントを同時実行可能。ワークツリーでコードコピーが分離され競合を回避。
  • スレッド単位でコンテキストが整理され、タスク切り替えがスムーズ。
  • 品質検証を並列で回せるため、時短以上に品質向上のメリットが大きい。
  • チームでスキルを共有するとコードレビューが標準化され、ばらつきが減少。
  • スキルをリポジトリにコミットし、レビューやテスト生成をエージェントに任せると月額コストをすぐ回収可能。
  • スキルを自動認識させるにはAGENTS.mdに明示的にリストする必要がある。設定の統一が重要。
  • 導入時にドキュメントを整備しないとスキルが使われないままになるリスク。
  • スキル導入は小さなタスク(例:コードレビュースキル)から始め、ROIを測定。
  • スキルはスクリプトやリソースを含むパッケージなのでGitでバージョン管理が推奨。
  • ツール導入だけでなく、使い方のルール作りが最大のコストだが、それをクリアすれば生産性向上が確実。

複数エージェントとの並行作業とワークツリー

室谷室谷代表取締役
Codex アプリ、複数のエージェントを同時に走らせられる設計なんですよね。ワークツリーで各エージェントが分離されたコードコピーで作業するから、競合を気にせず並行して試せる。
テキトー教師テキトー教師DotAI 認定講師
たしかに。従来だと一人の開発者がエージェントとやり取りしてるときに、別のタスクを頼むとコンテキストが混ざりがちでした。

それがスレッド単位で整理されるので、切り替えもスムーズです。
室谷室谷代表取締役
MYUUU でも似たような仕組みを導入しようとしてて、コスト対効果が気になってたんですが、この構造だと時短以上に品質の検証を並列で回せるメリットが大きい。

スキルによるチームの生産性向上

テキトー教師テキトー教師DotAI 認定講師
スキルをチームで共有すると、コードレビューのような定型作業を標準化できますね。レビュアーごとのばらつきが減る。
室谷室谷代表取締役
そう。US のチームだと、スキルをリポジトリにコミットして、コードレビューやテスト生成をエージェントに任せきりにするケースが増えてる。

時給換算すると、月額のサブスク代なんてすぐ回収できる。
テキトー教師テキトー教師DotAI 認定講師
ただ、スキルを自動で使わせるには AGENTS.md に明示的にリストする必要がある、というのをコミュニティで見かけました。設定をチーム内で統一しないと、エージェントがスキルを認識しないケースがあるんですよ。
室谷室谷代表取締役
そこが現場の落とし穴ですね。導入時にドキュメントを整備しないと、せっかく作ったスキルが使われないままになる。

導入時の組織的準備と教育

テキトー教師テキトー教師DotAI 認定講師
チームでスキルを導入するなら、まずは小さなタスクから始めるのがいいです。例えばコードレビュースキル一つから。
室谷室谷代表取締役
そうですね。ROI を測りやすいところから。

あと、スキルは単なるプロンプトじゃなくて、スクリプトやリソースをまとめたパッケージなので、管理対象として Git でバージョン管理するのがおすすめです。
テキトー教師テキトー教師DotAI 認定講師
最初に戸惑うのは「スキルが使われない」問題で、AGENTS.md に書かないと自動認識されないケースがあること。そこをチームの標準手順として決めておくとスムーズです。
室谷室谷代表取締役
結局、ツールを入れるだけじゃなくて、どう使うかのルール作りが一番のコストなんですよね。そこをクリアできれば、チーム全体の生産性は確実に上がる。

スキル作成のベストプラクティスと落とし穴

スキル作成のベストプラクティス vs 落とし穴
ベストプラクティス
  • 機能が一目で分かる名前(例:analyst-reviewer)
  • 説明文は1行でシンプルに
  • AGENTS.mdにスキルパスを明示
  • パス指定は絶対パスか相対パスに統一
  • スキルを汎用的に書き、他ツールでも使える設計に
落とし穴
  • 名前が分かりにくく使われない
  • 説明文にキーワードを詰め込みすぎる
  • AGENTS.mdに書かず、Codexがスキルを使用しない
  • パス指定が統一されずエージェントが混乱
  • 作ったのに使われずリソースの無駄になる

名前と説明の付け方の工夫

室谷室谷代表取締役
スキルの名前って、後で見返したときに「これ何だっけ」ってなりやすいんですよね。チームで共有するなら、機能が一目で分かる名前にしておかないと、使われる頻度がガクッと落ちます。
テキトー教師テキトー教師DotAI 認定講師
たしかに。現場でよく聞くのは「review-code」だけじゃなくて「analyst-reviewer」みたいに役割を入れると、説明なしでも伝わるって話です。

説明も1行で「コードレビューを実施し、改善案を提案する」と明確にすると、エージェントが自動選択しやすくなります。
室谷室谷代表取締役
あと、説明文にキーワードを詰め込みすぎると、逆にエージェントが迷うんですよね。シンプルに「このスキルはこういう時に使う」と書くだけで、精度が上がる。

失敗例から学ぶ回避方法

テキトー教師テキトー教師DotAI 認定講師
スキルを作っても、Codexが自動で使ってくれないって相談、結構あります。原因の一つが、スキルをAGENTS.mdに書いていないことなんですよ。
室谷室谷代表取締役
そうそう。コミュニティの事例で、skllを.codex/skillsに置いただけでは参照されず、AGENTS.mdのAvailable skillsに明示しないと拾ってもらえなかった、って話がありました。

これ、ROIで考えると痛い失敗ですよね。作ったのに使われないリソースの無駄。
テキトー教師テキトー教師DotAI 認定講師
対策としては、プロジェクトのルートにAGENTS.mdを置いて、そこに使いたいスキルのパスを全て列挙しておくこと。それだけで発見率がグッと上がります。
室谷室谷代表取締役
あと、スキル自体のパス指定も間違えやすい。絶対パスか相対パスか、統一しておかないとエージェントが混乱します。

他のAIツール(Claudeなど)とのスキル比較

室谷室谷代表取締役
Codexのスキルって、Claude Codeのカスタム指示と似ているようで、少し違うんですよね。ClaudeにはAGENTS.mdに相当するルールファイルがありますが、Codexはスキルを独立したモジュールとして管理できるのが強みです。
テキトー教師テキトー教師DotAI 認定講師
そう。Claude Codeでもカスタムスクリプトを仕込めますが、Codexのスキルは指示・リソース・スクリプトをパッケージ化して、複数のエージェントで共有できる設計なんです。
室谷室谷代表取締役
実際、Codex Plugin for Claude Codeってのも出ていて、Claude CodeからCodexのスキルを呼び出せるようになってます。相互運用性を考えると、スキルの設計はツールをまたいでも通用する形にしておくのが得策です。
テキトー教師テキトー教師DotAI 認定講師
スキルの中身をできるだけ汎用的に書いておけば、後で別のエージェントに移植する時も楽ですからね。最初からそのつもりで作ると、結局効率がいいんです。

よくある質問

Q1. Codexスキルは他のAIアシスタントでも使えますか?

室谷室谷代表取締役
基本的には各プラットフォーム専用です。GitHub CopilotのCodexスキルはCopilot環境でしか動かない。

でも考え方自体は汎用的で、AnthropicのClaudeでも似たような仕組みが出てきています。
テキトー教師テキトー教師DotAI 認定講師
そうなんです。仕組みを理解しておけば、他のツールに応用しやすい。

特に「振る舞いを定義する」という概念は共通なので、最初はCodexで慣れるのが近道です。

Q2. スキルが意図通り動かない場合、どうデバッグすればいいですか?

テキトー教師テキトー教師DotAI 認定講師
現場でよく聞かれるのが「思った返事が返ってこない」ケース。まずはスキルの説明文をもう一度見直す。

具体性が足りないと解釈がブレます。
室谷室谷代表取締役
あと、インストラクションが長すぎても逆効果。MYUUUの現場だと、1スキルあたり5行以内に収めた方が精度が安定する。
テキトー教師テキトー教師DotAI 認定講師
たしかにそうですね。短く、かつ例示を入れるとグッと良くなります。

Q3. チーム全体でスキルを共有するにはどうすればいいですか?

室谷室谷代表取締役
GitHub Copilotの場合は組織設定で一括配布が可能です。ただしバージョン管理は各自が意識しないと、誰かが古いのを使って事故る。
テキトー教師テキトー教師DotAI 認定講師
そこはgitで管理するのがベター。スキル定義をリポジトリに入れておけば、変更履歴も追えるし、Pull Requestでレビューもできる。

Q4. スキルの文字数制限ってありますか?

テキトー教師テキトー教師DotAI 認定講師
公式には説明文に上限があります。長く書きたい気持ちはわかるんですが、簡潔にまとめるのがコツです。
室谷室谷代表取締役
上限を気にするより、本当に必要な指示だけを書く練習をした方がいい。ROIで考えると、スキル1行で数分の作業が減るなら十分。

Q5. スキルを使うとセキュリティ的に問題はありますか?

テキトー教師テキトー教師DotAI 認定講師
スキル自体は単なる指示文なので、コードを外部に送信するわけではありません。ただし、機密情報をスキル内に直接書くのは避けた方が無難です。
室谷室谷代表取締役
その点、Copilotはエンタープライズ向けのコンプライアンス対応が進んでいます。とはいえ、チームでルールを決めてから使うのが安心ですね。

まとめ

室谷室谷代表取締役
Codexスキル、結局は「繰り返しの作業を定型化する」ための仕組みです。シリコンバレーではもう当たり前になりつつあって、日本でも導入スピードが上がってきている。
テキトー教師テキトー教師DotAI 認定講師
最初は小さなタスクから試すのがいいですね。コードレビューのチェックリストとか、よく使うリファクタリングパターンとか。
室谷室谷代表取締役
そう。時給換算すると、一度作ったスキルが毎日数分節約できれば、数日でペイする計算になる。
テキトー教師テキトー教師DotAI 認定講師
あとは、チームで共有していくことで知見が貯まる。最初は「こんなことも自動化できるんだ」という発見が増えて、自然と生産性が上がっていく。
室谷室谷代表取締役
まずは自分が一番面倒だと思う作業からスキル化してみてください。それがチーム全体のボトルネック解消につながるかもしれません。

Related

関連記事

New Articles

新着記事

ガイド

Grokの読み方は「グロック」か「グロク」か?公式回答と会社名・料金の最新事情

2026年11月18日
室谷テキトー教師
ガイド

GoogleのAIモードとAIによる概要の消し方|公式オフ機能の有無とPC・スマホの回避策

2026年11月18日
室谷テキトー教師
ガイド

Azure OpenAI Serviceとは?料金・モデル一覧・データの扱いを最新情報で整理

2026年11月18日
室谷テキトー教師
ニュース

Perplexityの「Orchestrator API」とは?45以上のモデルを1つのAPIキーに統合

2026年11月18日
室谷テキトー教師
ニュース

Microsoftの「Copilot Workspaces」とは?人とエージェントが協働する新体験

2026年11月18日
室谷テキトー教師
ガイド

Geminiのファミリープランは何人まで?Google AI Proを家族で割る料金と設定の手順

2026年11月18日
室谷テキトー教師
ニュース

Microsoft MAIとは?Ignite 2026で発表の7モデルと料金

2026年11月18日
室谷テキトー教師
ニュース

Replit Missionsとは?エージェントスウォームで目標達成型の自律実行

2026年11月18日
室谷テキトー教師
ニュース

Copilot Fusion Maxとは?Terminal-Bench 4.1首位の自動モデル選択

2026年11月18日
室谷テキトー教師
ニュース

Googleの「Gemini Tasks」とは?日本でも無料開始、Gemini 4 Hydrogen搭載

2026年11月18日
室谷テキトー教師

Join

AIプレナーになる。

入会は審査制です。いまの事業と、AIで何を動かしたいのかを聞かせてください。

参加を申請する