CodexのSkills機能とは？使い方や書き方、活用アイデアまで解説

Codexを使うたびに、同じ指示を何度も書いていないでしょうか。

CodexのSkills機能とは、自分の作業手順をAIに覚えさせて、必要な場面で自動的に呼び出させる仕組みです。

この機能を活用しなければ、毎回プロンプトを書き直す手間が続き、せっかくのノウハウも資産化できません。

本記事では、CodexのSkills機能の仕組みからSKILL.mdの書き方、Claude Code Skillsとの違いまでまとめて解説します。

はじめての1スキルを今日中に動かせる状態を目指して、最後まで読み進めてみてください。

SHIFT AIでは、ChatGPTやGeminiなどの生成AIを活用した「AI副業の始め方」や「収入を得るまでのロードマップ」を学べる無料セミナーを開催しています。

また、参加者限定で、「今日から使えるプロンプト100選」「新時代のAI×デザイン活用ガイド」「Nano Banana Pro 徹底解説」など、全12個の資料を無料で配布しています。

「これからAIを学び始めたい」「AIを使って副業収入を得たい」という方は、ぜひ以下のボタンからセミナーに参加してみてください。

CodexのSkills機能とは

CodexのSkills機能とは、特定のタスクに必要な手順や参考資料をひとつのフォルダにまとめて、Codexに「やり方」を覚えさせる仕組みです。

毎回同じプロンプトを書く必要がなくなり、PRレビュー・テスト作成・議事録整形といった繰り返し作業を、Codexが学習済みの手順どおりに実行します。

2026年に正式に追加された機能で、Anthropicが提唱した「Agent Skills」に準拠しています。

同じ規格をClaude CodeやGitHub Copilotも採用しているため、ツールをまたいでスキルを共有できる点も特徴です。

結果として、個人の作業ノウハウやチームの開発フローを「動くドキュメント」として蓄積でき、AIコーディングの再現性が一気に高まります。

そもそもCodexとは何かについては、以下の記事で詳しく解説しています。Codex自体をまだ触ったことがない方は、あわせて確認してみてください。

CodexのSkills機能の仕組み

CodexのSkills機能は、必要なときだけ詳細を読み込む「段階的開示」の設計で動いています。

仕組みを理解しておくと、SKILL.mdをどう書けば呼び出されやすいか、AGENTS.mdとどう使い分けるかの判断がスムーズになります。

SKILL.mdは2段構造になっている

SKILL.mdは、冒頭の「YAMLフロントマター（先頭の『—』で囲まれた設定欄）」と、その下の「本文」という2段構造になっています。

設定欄にはスキルの「名前」と「説明」を書き、本文には実際の作業手順を書きます。

Codexはまずすべてのスキルの名前と説明だけを読み、タスクに合うものを選んでから本文を取りに行きます。

例として、以下のような構造になります。

---
name: pr-review
description: GitHubのPRに対してレビュー観点でコメントを書く
---

# PRレビュー手順
1. 変更ファイルを一覧化する
2. 命名規則とテストカバレッジを確認する
3. 観点ごとにコメントを生成する

上記サンプルでは、「—」で囲まれた1〜4行目が設定欄、6行目以降が本文です。

この構造によって、不要なスキルの本文をコンテキストに含めずに済み、Codexは軽量な状態で動作できます。

必要なときだけ本文を読み込む

CodexのSkills機能は、「段階的開示（プログレッシブディスクロージャー）」と呼ばれる設計思想を採用しています。

すべてのスキルの本文を最初から読み込むのではなく、タスクに合致したスキルだけを必要なタイミングで読み込む方式です。

たとえばPRレビュー用のスキルを10個登録していたとしても、ユーザーが「議事録を整形して」と頼んだ瞬間に読み込まれるのは、議事録スキルの本文だけです。

この仕組みのおかげで、スキル数を増やしてもコンテキスト容量を圧迫せず、応答速度や精度を保ったまま運用できます。

AGENTS.mdと役割が異なる

AGENTS.mdとSkillsは、「常に必要な前提」と「特定の場面で必要な手順」を切り分ける関係にあります。

AGENTS.mdはCodexが起動するたびに必ず読み込まれるファイルで、プロジェクトの言語・コーディング規約・禁止事項など「毎回変わらない前提」を記述します。

一方でSkillsは、特定のタスクが発生した瞬間にだけ呼び出されるため、「PRレビュー」「リリースノート作成」など発生頻度が中〜低い手順を入れるのに適しています。

使い分けが明確になると、AGENTS.mdの肥大化を防ぎつつ、必要な手順は確実に呼び出せる状態を作れます。

Codex SkillsとClaude Code Skillsの違い

CodexのSkillsとClaude Code Skillsは、SKILL.mdの基本仕様は共通している一方、得意領域と拡張機能に明確な違いがあります。

両者ともAnthropicが提唱したAgent Skills標準に準拠しているため、フォーマットの差分はわずかです。違いは「呼び出し精度の調整方法」と「外部連携の強み」に表れます。

具体的な違いは以下の表のとおりです。

比較項目	CodexのSkills	Claude Code Skills
SKILL.mdの基本仕様	YAML＋本文の2段構造	YAML＋本文の2段構造
暗黙呼び出し	対応	対応
スキル内からの別スキル呼び出し	非対応	対応
権限設定	なし	あり（ファイルやコマンドを限定可能）
外部連携の強み	GitHub Automationsとの統合	Hooks／MCPでの柔軟な制御
ChatGPT連携	ChatGPT Plusなどから利用可能	非対応

それぞれの強みを順に解説します。

Codex Skillsの強み

Codexの強みは、GitHub AutomationsやChatGPTとの統合によって、エディタ外でもスキルを動かせる点です。

たとえばPR作成やIssueコメントをトリガーにスキルを実行できるため、CIや自動レビューの一部としてもスキルを組み込めます。

さらにChatGPT Plusなどのプランから直接Codexを呼び出せるので、アプリを開かずにChatGPT上からスキルを使う運用も実現可能です。

この特性により、開発者以外のメンバーでも、スキル化された手順をChatGPT経由で利用でき、業務全体のAI活用が広がります。

Claude Code Skillsの強み

Claude Code Skillsの強みは、スキル内から別のスキルを呼び出せる「スキル連携」と、ファイル単位の権限設定です。

小さなスキルを部品として組み合わせ、複雑なワークフローを段階的に構築できます。

たとえば「コード生成スキル」と「テスト生成スキル」を組み合わせ、「機能追加スキル」として呼び出すといった設計が可能です。

あわせて、特定のファイルしか触らせない、危険なコマンドを実行させないといった制御も細かく設定できます。

Claude Code Skillsの詳細は、以下の記事で解説しています。Codexと併用する場合の設計指針として、あわせて確認してみてください。

CodexのSkillsとMCPの違い

SkillsとMCPの違いは、「作業手順を教える仕組み」か「外部ツールに接続する仕組み」かという役割の差にあります。

どちらもCodexを拡張する仕組みですが、目的と動作レイヤーがまったく異なります。混同したまま導入すると、本来のメリットを引き出せません。

比較項目	Skills	MCP
役割	作業手順や知識を教える	外部ツールやデータと接続する
記述方法	マークダウン（SKILL.md）	サーバー実装（コードベース）
必要なスキル	マークダウンが書ければ作成可能	プログラミング知識が必要
主な用途	PRレビュー手順、議事録整形など	Slack送信、DB参照、API操作など
呼び出され方	プロンプトに合致したときに自動選択	ツール一覧から都度呼び出される

たとえば「Slackに送信する」処理を実現したい場合、MCPがSlack APIへの接続を担当し、Skillsが「いつ・どんな内容で送るか」の判断を担当します。

つまり2つは対立する概念ではなく、組み合わせれば「手順」と「実行手段」を分離した、保守しやすい自動化を作れる関係です。

【4ステップ】CodexのSkills機能の使い方

ここでは、「PRレビュー観点をチェックするスキル」を例に、4ステップでSkillsの使い方を解説します。

• ステップ1：Codexアプリの準備
• ステップ2：スキルを作成
• ステップ3：Codexで認識を確認
• ステップ4：実際に呼び出して試す

所要時間はおよそ5分です。実際に手を動かしながら進めると、Skillsの動きを体感できます。

ステップ1：Codexアプリの準備

はじめに、Codexアプリをインストールしましょう。

CodexアプリはOpenAI公式サイトからMac・Windows用がダウンロードできます。すでにインストール済みの場合は、アプリの設定画面から最新版にアップデートしましょう。

Skills機能はアプリの最新バージョンで利用可能です。インストール方法や初期設定の詳細は、以下の記事を参考にしてみてください。

ステップ2：スキルを作成

次に、「プラグイン画面から作成」「チャット欄から作成」の2つの方法のうち、好きな方を選びます。

どちらの方法でも、最終的にはCodexのビルトインスキル「Skill Creator」がSKILL.mdを自動生成してくれます。操作の入り口が違うだけで、結果は同じです。

方法A：プラグイン画面から作成する

まず、左サイドバーの「プラグイン」を開き、右上の「スキルを作成」を選択します。

Skill Creatorが起動したチャット画面に自動で切り替わります。

方法B：チャット欄から$skill-creatorで呼び出す

通常のチャット欄に「$skill-creator」と入力すると、その場でSkill Creatorが起動します。

プラグイン画面を開く手間が省けるため、慣れてきたらこちらが早いです。

どちらの方法でも、Skill Creatorが起動したチャット画面に切り替わり、次のステップで作成内容を依頼できる状態になります。

ステップ3：Skill Creatorに作成内容を依頼

続けて、Skill Creatorのチャット欄に、作りたいスキルの内容を日本語で依頼します。

マークダウンを直接書く必要はなく、自然な日本語で「どんなときに何をしたいか」を伝えるだけで、CodexがSKILL.mdを自動生成してくれます。

たとえばPRレビュー用のスキルを作りたい場合、以下のように依頼します。

GitHubのPRをレビューする観点でコメントを返すスキルを作成してください。
命名規則・テストカバレッジ・セキュリティの3観点でチェックさせたいです。

Codexがスキル名・description・本文の手順をまとめたSKILL.mdを生成し、所定の保存場所に登録します。

マークダウンを書かなくても、依頼するだけでスキルが完成する流れです。

ステップ4：実際に呼び出して試す

最後に、新しいチャットを立ち上げて、暗黙呼び出しと明示呼び出しの両方で動作確認します。

サンプルのリポジトリを開き、Codexアプリのチャット欄に以下のように指示してみてください。

# 暗黙呼び出しのテスト
このPRをレビューして観点コメントを出してください

# 明示呼び出しのテスト
$pr-review このPRをチェックして

どちらの場合も、スキルに登録した観点に沿った出力が得られれば成功です。

期待通りに動かない場合は、Skill Creatorに「pr-reviewスキルのdescriptionをもっと具体的に直して」と依頼すれば、自動で修正してくれます。

この一連の流れを体験すれば、自分の作業手順をスキル化する感覚がつかめます。

SKILL.mdの書き方のコツ

SKILL.mdは、アプリで使う場合は、前述のSkill CreatorがSKILL.mdを自動で生成してくれます。

一方で、CLIで使うときや生成内容を細かく直したいときは、自分で書き方を知っておく必要があります。

SKILL.mdの書き方のコツは以下の通りです。

呼び出し精度を高めるには、書き方のコツが必要です。順に、SKILL.mdの書き方を解説していきます。

必須項目を把握する

SKILL.mdに最低限必要なのは、nameとdescriptionの2つのフィールドだけです。

それぞれの文字数制限は以下のとおりで、これを守らないと起動時にバリデーションエラーになります。

• name：100文字以内・1行で書く（スキルの識別子）
• description：500文字以内・1行で書く（いつ使うかの説明）

最小サンプルは以下のように、YAMLフロントマターとタイトルだけでも動作します。

---
name: lint-and-format
description: コードのlintとフォーマットチェックを実行する
---

# Lint & Format
1. ESLintを実行する
2. Prettierでフォーマットする
3. エラーがあれば修正案を出す

2つのフィールドさえ書ければ、最初のスキルは5分以内に動かせる状態になります。

descriptionの書き方で呼び出し精度が決まる

descriptionは、「どんなときに使うか」と「どんなときに使わないか」の両方を書くと精度が上がります。

Codexはユーザーのプロンプトとdescriptionを照合してスキルを選ぶため、説明が曖昧だと意図しない場面で発動したり、必要なときに呼ばれなかったりします。

たとえば以下のように、利用シーンと除外条件を具体的に書くと判定精度が高まります。

description: 
  ユーザーがコード品質チェックや
  フォーマット修正を依頼したときに使う。
  単発のコード生成や説明依頼では使わない。

具体的なdescriptionを書くことで、誤発動を防ぎつつ、必要な場面で確実に呼び出されるスキルになります。

本文は命令形で手順を書く

SKILL.mdの本文は、命令形で手順を箇条書きする形がもっとも安定します。

背景や前提の長文よりも、Codexが順番どおりに実行できる明確な指示のほうが、結果のブレを抑えられます。

たとえば「Step1：◯◯を確認する」「Step2：△△を生成する」のように、手順を分けて書くのが基本です。

本文が長くなりすぎる場合は、「`references/` 」フォルダに参考資料を分けて配置し、SKILL.mdからは「必要なときに参照する」と指示します。

命令形で構造化することで、誰がSKILL.mdを読んでも同じ実行結果を再現できる、ドキュメントとしての価値も高まります。

CodexのSkills機能の活用アイデア

CodexのSkills機能は、エンジニア向けの開発タスクだけでなく、副業や日々のルーティン作業にも幅広く活用できます。

ここでは、すぐに作れて効果が出やすいスキルのアイデアを4つ紹介します。

PRレビュー観点のチェック

PRレビューの観点をスキル化すると、レビューの抜け漏れと属人化をまとめて防げます。

チームで決めた命名規則やテスト基準を1つのスキルにまとめておけば、誰がレビューしても同じ観点でチェックできます。

レビュアー個人の経験差に依存しないため、ジュニアメンバーでも一定品質のレビューが可能になります。新人のオンボーディング期間を短縮できる効果もあります。

結果として、レビュー品質の安定とコードベース全体の保守性向上につながります。

議事録のフォーマット整形

会議メモを決まったフォーマットに整える作業は、スキル化することで毎回の手間を一気に削減できます。

「決定事項」「ToDo」「次回確認事項」といった見出しと並び順をSKILL.mdに書いておけば、生の文字起こしを貼り付けるだけで整った議事録が生成されます。

クライアントごとにフォーマットが違う場合も、案件単位でスコープを分けたスキルを用意すれば、現場ごとの体裁を簡単に切り替えられます。

会議後の作業時間を短縮でき、本来の業務に集中できる時間を増やせます。

ブログ下書きの構成生成

ブログやnoteの下書き構成も、テーマを伝えれば自分のスタイルで構成案を作るスキルとして登録できます。

「リード文→課題提起→解決策→事例→まとめ」のような型をSKILL.mdに書いておくと、テーマを与えるだけで型に沿った構成案が出力されます。

副業で記事執筆をしている場合、メディアごとに異なる構成ルールをスキルで切り替えれば、毎回の構成作りに迷う時間がなくなります。

記事の品質を均一化しつつ、執筆スピードを大きく引き上げる効果があります。

納品前チェックリスト

フリーランスや副業ワーカーには、「納品前チェックリストスキル」を作っておくと納品ミスを防げます。

納品物の種類ごとに、確認すべき項目をSKILL.mdに列挙しておけば、Codexに「納品前チェックして」と頼むだけで漏れなく確認できます。

たとえば「ファイル名規則」「依頼書との整合性」「クライアント固有のNG表現」などをスキルに含めれば、急ぎの案件でも品質が安定します。

納品物のクオリティ担保ができれば、リピート発注や報酬単価アップにもつながりやすくなります。

CodexのSkillsを使う際の注意点

CodexのSkillsを安全に運用するためには、事前に押さえておきたい4つの注意点があります。

知らないまま使うと、情報漏えいや誤動作のリスクにつながります。順番に確認しておきましょう。

APIキーやパスワードを書きこまない

SKILL.mdやスクリプトに、APIキーやパスワードを直接書き込むのは絶対に避けるべきです。

SKILL.mdはGitで管理することも多く、誤ってリポジトリにpushすると情報が公開されてしまいます。

認証情報は環境変数に逃がし、SKILL.mdからは変数名で参照する形にしましょう。Composio CLIのように認証を外部で管理する仕組みを使うのも有効です。

シークレットを分離する習慣をつければ、スキル共有時の情報漏えいリスクを大幅に低減できます。

危険な操作を自動化しない

本番DBの操作やファイルの一括削除など、取り返しのつかない操作をスキルに含めないのが原則です。

Codexはユーザー権限で動作するため、SKILL.mdの指示通りに本番環境を破壊するコマンドも実行できてしまいます。

どうしても自動化したい場合は、実行前に人間の確認を挟むステップを必ず含めましょう。「実行前にプレビューを出して承認を待つ」といった指示をSKILL.mdに書いておくと安全です。

確認の一手間を惜しまないことで、致命的なオペレーションミスを未然に防げます。

スキルを大きく作りすぎない

1つのスキルに多機能を詰め込みすぎると、呼び出し精度が下がり、Codexが意図しない動きをします。

「PRレビューとリリースノートとCI失敗解析」を1スキルにまとめると、descriptionが曖昧になり、いつ呼び出されるべきかCodexが判断できません。

1スキル＝1タスクの原則で分割し、必要なら参照資料を「references/」フォルダに切り出して整理しましょう。

本文が長くなりすぎる場合は、別ファイルに分けて「必要時に読む」と指示するのが有効です。

適切な粒度を保つことで、スキル数が増えても運用が破綻しない状態を維持できます。

一度作ったまま放置しない

スキルは、定期的に見直さないと実態とズレて使い物にならなくなります。

プロジェクトのルールやツールのバージョンは変化するため、過去に書いたSKILL.mdが古くなっていく可能性があります。

四半期に一度はスキルの中身を確認し、不要なものを削除したり、古い手順をアップデートしたりする運用が理想です。

Gitのコミット履歴を見れば、いつ最後に更新したかも確認できます。

定期的なメンテナンスによって、スキル資産の信頼性を保ち続けられます。

CodexのSkills機能で自分の作業を資産化しよう

CodexのSkills機能とは、自分の作業手順をAIに覚えさせて再利用するための仕組みです。

本記事では、Skills機能の仕組みからSKILL.mdの書き方、Claude Code Skillsとの違い、使い方までを解説しました。

まずは「PRレビュー観点チェック」や「議事録整形」など、繰り返し行っている作業を1つだけスキル化してみてください。最初の1スキルが動けば、Skills機能の効果を実感できます。

一方で、CodexやClaude CodeなどのAIコーディングツールを使いこなすには、ツールの操作だけでなく、プロンプト設計やAI活用の全体像を体系的に学ぶことも重要です。

独学だけでは情報が断片的になり、業務に活かしきれずに止まってしまうケースも少なくありません。

SHIFT AIでは、ChatGPTやGeminiなどの生成AIを活用して、副業で収入を得たり、昇進・転職などに役立つスキルを学んだりするためのセミナーを開催しています。

また、参加者限定で、「初心者が使うべきAIツール20選」や「AI副業案件集」「ChatGPTの教科書」など全12個の資料を無料で配布しています。

「これからAIを学びたい」「AIを使って本業・副業を効率化したい」という方は、ぜひセミナーに参加してみてください。