Codex と Skill とは
Codex は OpenAI のエージェント型コーディング AI です。ChatGPT 内 / 専用 CLI / IDE 統合などで使え、コードを読んで修正する、Issue から PR を作る、といった「実作業」をエージェントとしてこなします。
Skill はその Codex に 新しい能力 / 専門性 を後付けする「手順パッケージ」です。中身は基本的に SKILL.md というテキストファイル 1 つで、
・name（スキル名）
・description（このスキルが何者か）
・必要なら手順、参照ドキュメント、補助スクリプト
を含みます。Codex は最初は スキルの名前と説明だけ を読み込み、本当に必要になった時に中身を全部展開します（公式ドキュメントはこれを "progressive disclosure" と呼んでいます。コンテキストの節約になる、という意味です）。
Skill 仕様は Codex 専用ではなく、エージェント横断のオープン仕様 として説明されています（例: 同じ仕組みを Claude Code 等が独自に採用している）。本記事では Codex の話に絞ります。
何が公開されたか
公式ドキュメント (developers.openai.com/codex/skills) で、以下が明文化されました。
1. Skill の保存場所
Codex は次の 3 箇所を見にいきます。
・リポジトリ単位: $REPO_ROOT/.agents/skills → そのリポジトリ専用の Skill。チームでバージョン管理しやすい。
・ユーザー単位: $HOME/.agents/skills → 自分のマシンで常に使いたい Skill。
・管理者単位: /etc/codex/skills → マシン全体に配布する用途（社内端末などを想定）。
2. 公式キュレーション済み Skill のインストール
Codex のチャット内で次のように打つだけです。
$skill-installer linear
ここでの linear は Skill 名（公式ドキュメントが例示している名前）。 Linear（Issue / プロジェクト管理 SaaS）と連携するための Skill が想定例として挙げられています。
3. 自分で Skill を作る
これも Codex のチャット内コマンドで完結します。
$skill-creator
走らせると、Codex が 対話形式で SKILL.md のテンプレートを生成 してくれる、という位置付けです。
誰にどう効くか
・同じ指示を毎日書いている人: 例えば「PR を作るときはまず lint → test → コミットメッセージは conventional commits」のような社内ルールを Skill に閉じ込めれば、Codex に毎回貼り付けなくて済む。
・チームに Codex を展開したい人: $REPO_ROOT/.agents/skills に Skill を置いて Git で管理 → クローンしたチームメンバー全員が同じ手順で動く Codex を持てる。
・非エンジニア: 「Linear に Issue を切る」「Notion に議事メモを残す」のような繰り返し作業を Skill で固めておけば、Codex に普通の文章で頼むだけで再現できる。
注意点
・投稿本文は @OpenAIDevs の元投稿では「Here's how you can install the skill」とだけ書かれていて、 実際の手順は添付メディア + 公式ドキュメント側にあります。本記事のコマンド例は公式ドキュメント (developers.openai.com/codex/skills) を一次ソースとしています。
・$skill-installer linear の 実体（どの Linear API を使うか、認証はどうするか） は本記事では確認していません。導入前に Skill の中身（SKILL.md と関連スクリプト）を確認してください。
・Skill は Codex に外部権限を委譲する仕組み にもなり得ます。社内ポリシーで「外部 SaaS への自動操作を制限」している場合、入れる Skill を運営側で吟味する運用が望ましいです。