Codexスキルとは？従来のプロンプトとの違い
通常のプロンプト
- 毎回ゼロから書く
- 指示を手渡す感覚
- 品質に揺れが出る
Codexスキル
- 再利用可能なブロック（指示・リソース・スクリプト）
- エージェントに役割を委譲
- 再現性が高い
- フォルダ単位で管理（.codex/skills/）
- AGENTS.mdにパスを明示
スキルと通常のプロンプトの違い
テキトー教師.AI認定講師最初に「Codexスキルって、結局ただのプロンプトのテンプレートですよね？」って聞かれるんです。誤解されてる部分なんですけど、実は構造が全然違うんですよ。
室谷代表取締役そうなんですよね。通常のプロンプトは毎回ゼロから書くものですが、スキルは指示・リソース・スクリプトをひとまとめにした再利用可能なブロック。
Agents SDKでいうツールのワークフロー版ですね。
Agents SDKでいうツールのワークフロー版ですね。
テキトー教師.AI認定講師だから「また同じ説明を書かなくて済む」という以上に、Codexが自動的にスキルを選んで使ってくれる点が大きい。プロンプトを手渡すのではなく、エージェントに役割を委譲する感覚です。
スキルのフォルダ構成とSKILL.md
テキトー教師.AI認定講師スキルは
.codex/skills/ の下にフォルダを作って、その中に SKILL.md を置くんです。最初は「どこに置けばいいんだ？」って迷う人が多いですね。室谷代表取締役フォルダ単位で管理できるのがポイント。チームで使う場合、この構造が効くんですよ。
リポジトリごとにスキルを整理すれば、プロジェクトのルールやナレッジがそのままCodexに反映される。
リポジトリごとにスキルを整理すれば、プロジェクトのルールやナレッジがそのままCodexに反映される。
テキトー教師.AI認定講師ただ、
AGENTS.mdにスキルのパスを明示しないとCodexが自動で拾ってくれないケースがあるみたいです。コミュニティの投稿でもそこが話題になってました。室谷代表取締役そこは運用次第ですね。私はルートの
手間は一瞬ですが、発見性が格段に上がる。
AGENTS.mdに一覧を書くようにしています。手間は一瞬ですが、発見性が格段に上がる。
スキルがもたらす再現性と効率
テキトー教師.AI認定講師スキルの真価は再現性だと思います。同じ品質のコードレビューやデプロイ手順を、何度でも正確にエージェントに任せられる。
プロンプトを毎回手書きすると、どうしても揺れが出ますから。
プロンプトを毎回手書きすると、どうしても揺れが出ますから。
室谷代表取締役時給換算すると、スキル一つ作るコストはせいぜい30分。でもそのスキルが100回使われれば、毎回の指示書きが省略できる。
ROIで考えたらバカにならないです。
ROIで考えたらバカにならないです。
テキトー教師.AI認定講師しかもスキルはコード生成以外にも使える。情報収集やドキュメント作成にも応用できるので、開発チーム以外のメンバーも恩恵を受けられますね。
スキルの作り方と使い方：初心者でもできる設定手順
明示的な呼び出し
- プロンプトでスキル名を指定（例：「reviewスキルを使って」）
- 確実にそのスキルが使われる
- 手動で指示する必要がある
自動選択
- タスクの文脈からCodexが自動判断
- 使ってほしいスキルがスルーされる可能性あり
- AGENTS.mdに記載すると優先的に選択されやすくなる
スキル作成の基本テンプレート
テキトー教師.AI認定講師スキルって、プロンプトよりもう少し構造化されたやつですよね。指示とリソースとスクリプトをひとまとめにできるとか。
室谷代表取締役そうです。
これが基本テンプレートですね。中に「あなたは〇〇エキスパートです」とか呼び出し条件を書く。
.codex/skills/ 配下に SKILL.md を置くだけ。これが基本テンプレートですね。中に「あなたは〇〇エキスパートです」とか呼び出し条件を書く。
テキトー教師.AI認定講師最初に戸惑うのが「何を書けばいいか」なんですよ。僕が作るなら「レビュアーとしての視点」と「チェックリスト」を書きます。
室谷代表取締役その感覚でいい。ROIで考えると、10分で作ったスキルが毎回のレビュー品質を一定に保つ。
時給換算すればすぐペイします。
時給換算すればすぐペイします。
明示的な呼び出しと自動選択の仕組み
テキトー教師.AI認定講師スキルをどうやってCodexに使わせるかが次の疑問ですね。呼び出し方は2通りあると。
室谷代表取締役明示的か自動か。明示的ならプロンプトで「reviewスキルを使って」と言えばいい。
自動選択はコードレビュー時に「これはreviewスキルが使えるな」とCodexが判断する。
自動選択はコードレビュー時に「これはreviewスキルが使えるな」とCodexが判断する。
テキトー教師.AI認定講師自動選択、最初は「ちゃんと動くのかな」って不安になります。でも実際はタスクの文脈を見て結構賢く選んでくれます。
室谷代表取締役ただ、自動選択に任せすぎると使ってほしいスキルがスルーされることもある。その場合は後述のAGENTS.mdで制御するのが定石ですね。
AGENTS.mdへの記載とスコープ設定
テキトー教師.AI認定講師AGENTS.mdって、プロジェクトルートに置くあのファイルですよね。あそこにスキル一覧を書くと優先的に使われるとか？
室谷代表取締役そうです。コミュニティの情報だと、AGENTS.mdのAvailable skillsリストにスキル名を書いておくと、Codexが自動選択しやすくなる。
必須ではないけど絶対使わせたいなら書いておくのが無難。
必須ではないけど絶対使わせたいなら書いておくのが無難。
テキトー教師.AI認定講師スコープ設定も大事ですよね。プロジェクト全体向けのスキルか、特定ディレクトリだけか。
室谷代表取締役そこはAGENTS.mdの置き場所で調整できる。ルートに置けば全体、サブディレクトリに置けばその範囲だけ。
現場だと、チームごとにAGENTS.mdを分けて運用してるケースが多いですね。
現場だと、チームごとにAGENTS.mdを分けて運用してるケースが多いですね。
スキルを活用した業務自動化の実践例
コードレビュースキルによる品質向上
室谷代表取締役コードレビューにスキルを使うと、レビュー漏れが減るんですよね。シリコンバレーのチームだとレビュー時間が半分になったって話もあります。
テキトー教師.AI認定講師実はレビュースキルを作っても、Codexが自動で使ってくれないケースがあるんですよ。AGENTS.mdに記載する必要がある、みたいな議論がコミュニティでありました。
室谷代表取締役そこは設定の工夫次第ですね。チームで統一すれば効果は大きい。
MYUUUでもレビュースキルを導入して、品質が安定しました。
MYUUUでもレビュースキルを導入して、品質が安定しました。
テキトー教師.AI認定講師最初は手動で指定しても、徐々に習慣化します。スキルの再利用性が高いから、一度作ればチーム全体で使えます。
ゲーム開発自動化の大規模事例
テキトー教師.AI認定講師OpenAIが公開したレーシングゲームの事例、すごかったですよね。一つのプロンプトから700万トークン使ってゲームを生成したとか。
室谷代表取締役あの規模になると、スキルとエージェントの連携が鍵です。画像生成スキルやWebゲーム開発スキルを組み合わせて、完全に自律開発してる。
テキトー教師.AI認定講師しかも自分でテストまでやるんです。QAエージェントとしても動く。
開発ライフサイクル全体をスキルでカバーできる。
開発ライフサイクル全体をスキルでカバーできる。
室谷代表取締役まさにエージェントに「デザイナー、開発者、テスター」の役割を全部任せる時代になりましたね。
非エンジニア向けスキル（メール、会議）
テキトー教師.AI認定講師スキルはコードだけじゃないんですよ。メールの下書きや会議の議事録作成にも使える。
非エンジニアが使いやすいのがポイント。
非エンジニアが使いやすいのがポイント。
室谷代表取締役経営視点だと、そういう定型業務をスキル化すると時給換算で大きな効率化になります。毎回プロンプトを考える手間が省ける。
テキトー教師.AI認定講師そうです。テンプレートをスキルにしておけば、ワンクリックで適用できる。
最初に戸惑うのは「スキルってどう使うの？」ってところですが、一度覚えれば簡単です。
最初に戸惑うのは「スキルってどう使うの？」ってところですが、一度覚えれば簡単です。
スキル導入で変わるチーム開発の現場
複数エージェントとの並行作業とワークツリー
室谷代表取締役Codex アプリ、複数のエージェントを同時に走らせられる設計なんですよね。ワークツリーで各エージェントが分離されたコードコピーで作業するから、競合を気にせず並行して試せる。
テキトー教師.AI認定講師たしかに。従来だと一人の開発者がエージェントとやり取りしてるときに、別のタスクを頼むとコンテキストが混ざりがちでした。
それがスレッド単位で整理されるので、切り替えもスムーズです。
それがスレッド単位で整理されるので、切り替えもスムーズです。
室谷代表取締役MYUUU でも似たような仕組みを導入しようとしてて、コスト対効果が気になってたんですが、この構造だと時短以上に品質の検証を並列で回せるメリットが大きい。
スキルによるチームの生産性向上
テキトー教師.AI認定講師スキルをチームで共有すると、コードレビューのような定型作業を標準化できますね。レビュアーごとのばらつきが減る。
室谷代表取締役そう。US のチームだと、スキルをリポジトリにコミットして、コードレビューやテスト生成をエージェントに任せきりにするケースが増えてる。
時給換算すると、月額のサブスク代なんてすぐ回収できる。
時給換算すると、月額のサブスク代なんてすぐ回収できる。
テキトー教師.AI認定講師ただ、スキルを自動で使わせるには AGENTS.md に明示的にリストする必要がある、というのをコミュニティで見かけました。設定をチーム内で統一しないと、エージェントがスキルを認識しないケースがあるんですよ。
室谷代表取締役そこが現場の落とし穴ですね。導入時にドキュメントを整備しないと、せっかく作ったスキルが使われないままになる。
導入時の組織的準備と教育
テキトー教師.AI認定講師チームでスキルを導入するなら、まずは小さなタスクから始めるのがいいです。例えばコードレビュースキル一つから。
室谷代表取締役そうですね。ROI を測りやすいところから。
あと、スキルは単なるプロンプトじゃなくて、スクリプトやリソースをまとめたパッケージなので、管理対象として Git でバージョン管理するのがおすすめです。
あと、スキルは単なるプロンプトじゃなくて、スクリプトやリソースをまとめたパッケージなので、管理対象として Git でバージョン管理するのがおすすめです。
テキトー教師.AI認定講師最初に戸惑うのは「スキルが使われない」問題で、AGENTS.md に書かないと自動認識されないケースがあること。そこをチームの標準手順として決めておくとスムーズです。
室谷代表取締役結局、ツールを入れるだけじゃなくて、どう使うかのルール作りが一番のコストなんですよね。そこをクリアできれば、チーム全体の生産性は確実に上がる。
スキル作成のベストプラクティスと落とし穴
ベストプラクティス
- 機能が一目で分かる名前（例：analyst-reviewer）
- 説明文は1行でシンプルに
- AGENTS.mdにスキルパスを明示
- パス指定は絶対パスか相対パスに統一
- スキルを汎用的に書き、他ツールでも使える設計に
落とし穴
- 名前が分かりにくく使われない
- 説明文にキーワードを詰め込みすぎる
- AGENTS.mdに書かず、Codexがスキルを使用しない
- パス指定が統一されずエージェントが混乱
- 作ったのに使われずリソースの無駄になる
名前と説明の付け方の工夫
室谷代表取締役スキルの名前って、後で見返したときに「これ何だっけ」ってなりやすいんですよね。チームで共有するなら、機能が一目で分かる名前にしておかないと、使われる頻度がガクッと落ちます。
テキトー教師.AI認定講師たしかに。現場でよく聞くのは「review-code」だけじゃなくて「analyst-reviewer」みたいに役割を入れると、説明なしでも伝わるって話です。
説明も1行で「コードレビューを実施し、改善案を提案する」と明確にすると、エージェントが自動選択しやすくなります。
説明も1行で「コードレビューを実施し、改善案を提案する」と明確にすると、エージェントが自動選択しやすくなります。
室谷代表取締役あと、説明文にキーワードを詰め込みすぎると、逆にエージェントが迷うんですよね。シンプルに「このスキルはこういう時に使う」と書くだけで、精度が上がる。
失敗例から学ぶ回避方法
テキトー教師.AI認定講師スキルを作っても、Codexが自動で使ってくれないって相談、結構あります。原因の一つが、スキルをAGENTS.mdに書いていないことなんですよ。
室谷代表取締役そうそう。コミュニティの事例で、skllを.codex/skillsに置いただけでは参照されず、AGENTS.mdのAvailable skillsに明示しないと拾ってもらえなかった、って話がありました。
これ、ROIで考えると痛い失敗ですよね。作ったのに使われないリソースの無駄。
これ、ROIで考えると痛い失敗ですよね。作ったのに使われないリソースの無駄。
テキトー教師.AI認定講師対策としては、プロジェクトのルートにAGENTS.mdを置いて、そこに使いたいスキルのパスを全て列挙しておくこと。それだけで発見率がグッと上がります。
室谷代表取締役あと、スキル自体のパス指定も間違えやすい。絶対パスか相対パスか、統一しておかないとエージェントが混乱します。
他のAIツール（Claudeなど）とのスキル比較
室谷代表取締役Codexのスキルって、Claude Codeのカスタム指示と似ているようで、少し違うんですよね。ClaudeにはAGENTS.mdに相当するルールファイルがありますが、Codexはスキルを独立したモジュールとして管理できるのが強みです。
テキトー教師.AI認定講師そう。Claude Codeでもカスタムスクリプトを仕込めますが、Codexのスキルは指示・リソース・スクリプトをパッケージ化して、複数のエージェントで共有できる設計なんです。
室谷代表取締役実際、Codex Plugin for Claude Codeってのも出ていて、Claude CodeからCodexのスキルを呼び出せるようになってます。相互運用性を考えると、スキルの設計はツールをまたいでも通用する形にしておくのが得策です。
テキトー教師.AI認定講師スキルの中身をできるだけ汎用的に書いておけば、後で別のエージェントに移植する時も楽ですからね。最初からそのつもりで作ると、結局効率がいいんです。
よくある質問
Q1. Codexスキルは他のAIアシスタントでも使えますか？
室谷代表取締役基本的には各プラットフォーム専用です。GitHub CopilotのCodexスキルはCopilot環境でしか動かない。
でも考え方自体は汎用的で、AnthropicのClaudeでも似たような仕組みが出てきています。
でも考え方自体は汎用的で、AnthropicのClaudeでも似たような仕組みが出てきています。
テキトー教師.AI認定講師そうなんです。仕組みを理解しておけば、他のツールに応用しやすい。
特に「振る舞いを定義する」という概念は共通なので、最初はCodexで慣れるのが近道です。
特に「振る舞いを定義する」という概念は共通なので、最初はCodexで慣れるのが近道です。
Q2. スキルが意図通り動かない場合、どうデバッグすればいいですか？
テキトー教師.AI認定講師現場でよく聞かれるのが「思った返事が返ってこない」ケース。まずはスキルの説明文をもう一度見直す。
具体性が足りないと解釈がブレます。
具体性が足りないと解釈がブレます。
室谷代表取締役あと、インストラクションが長すぎても逆効果。MYUUUの現場だと、1スキルあたり5行以内に収めた方が精度が安定する。
テキトー教師.AI認定講師たしかにそうですね。短く、かつ例示を入れるとグッと良くなります。
Q3. チーム全体でスキルを共有するにはどうすればいいですか？
室谷代表取締役GitHub Copilotの場合は組織設定で一括配布が可能です。ただしバージョン管理は各自が意識しないと、誰かが古いのを使って事故る。
テキトー教師.AI認定講師そこはgitで管理するのがベター。スキル定義をリポジトリに入れておけば、変更履歴も追えるし、Pull Requestでレビューもできる。
Q4. スキルの文字数制限ってありますか？
テキトー教師.AI認定講師公式には説明文に上限があります。長く書きたい気持ちはわかるんですが、簡潔にまとめるのがコツです。
室谷代表取締役上限を気にするより、本当に必要な指示だけを書く練習をした方がいい。ROIで考えると、スキル1行で数分の作業が減るなら十分。
Q5. スキルを使うとセキュリティ的に問題はありますか？
テキトー教師.AI認定講師スキル自体は単なる指示文なので、コードを外部に送信するわけではありません。ただし、機密情報をスキル内に直接書くのは避けた方が無難です。
室谷代表取締役その点、Copilotはエンタープライズ向けのコンプライアンス対応が進んでいます。とはいえ、チームでルールを決めてから使うのが安心ですね。
まとめ
室谷代表取締役Codexスキル、結局は「繰り返しの作業を定型化する」ための仕組みです。シリコンバレーではもう当たり前になりつつあって、日本でも導入スピードが上がってきている。
テキトー教師.AI認定講師最初は小さなタスクから試すのがいいですね。コードレビューのチェックリストとか、よく使うリファクタリングパターンとか。
室谷代表取締役そう。時給換算すると、一度作ったスキルが毎日数分節約できれば、数日でペイする計算になる。
テキトー教師.AI認定講師あとは、チームで共有していくことで知見が貯まる。最初は「こんなことも自動化できるんだ」という発見が増えて、自然と生産性が上がっていく。
室谷代表取締役まずは自分が一番面倒だと思う作業からスキル化してみてください。それがチーム全体のボトルネック解消につながるかもしれません。
