CodexのSkillsとは？SKILL.md・呼び出し方法・適用範囲

CodexのSkillは、モデルの思考深度を切り替える「モード」ではありません。特定の作業を繰り返せるように、指示、参考資料、任意のスクリプトや素材をひとまとめにしたワークフローです。

最小構成

OpenAIのSkills公式ドキュメントでは、Skillをディレクトリとして作り、SKILL.mdを必須ファイルとします。

my-skill/
├── SKILL.md
├── scripts/       # 任意
├── references/    # 任意
└── assets/        # 任意

SKILL.mdのFront Matterには、少なくともnameとdescriptionを記載します。

---
name: release-note-checker
description: リリースノートを一次資料と照合するときに使用する。
---

対象資料を読み、日付・製品名・提供状況を確認する。
確認できない項目は推測せず未確認として報告する。

呼び出しは二通り

1. 明示呼び出し：Codex CLIまたはIDE拡張で/skillsを開くか、プロンプトで$skill-nameを指定する。
2. 暗黙呼び出し：依頼内容がSkillのdescriptionに一致すると、Codexが選択することがある。

暗黙呼び出しに頼る場合、descriptionへ対象作業と対象外を具体的に書きます。「便利なSkill」のような説明では選択条件が分かりません。

読み込み場所

公式ドキュメントは、リポジトリ用の.agents/skills、ユーザー用の$HOME/.agents/skills、管理者用やシステム同梱の場所を区別しています。チーム固有の手順はリポジトリ側、複数リポジトリで使う個人手順はユーザー側、というように範囲を選びます。

混同しない三点

• モデル設定ではない：Skillを選んでも、推論モデルやreasoning設定が必ず変わるわけではない。
• 権限設定ではない：ファイルやネットワークへアクセスできる範囲は、別のsandbox・approval設定で決まる。
• 正しさの保証ではない：Skillの手順が不正確なら結果も不正確になり得る。出力と実行結果を確認する。

実行後の確認

Skill名が表示されたかだけで完了にせず、参照すべき資料を読んだか、指定の検査を実行したか、出力物が要求形式かを確認します。スクリプトを含むSkillは、実行対象と書き込み範囲も事前に見ます。

結論

Skillは「AIを賢くするスイッチ」ではなく、作業方法を再利用可能にするパッケージです。SKILL.mdの目的と境界を明確にし、明示または暗黙で呼び出し、実行後は手順が守られたかを検証してください。