概要
https://developers.openai.com/codex/skills/
詳細内容
## [OpenAI Codexを拡張する「Agent Skills」の仕様と実装ガイド]
https://developers.openai.com/codex/skills/
**Original Title**: Agent Skills
OpenAIの開発者向けツール「Codex」に対し、プロジェクト固有の指示や実行スクリプトをパッケージ化して機能を拡張する「Agent Skills」の仕様を公開。
**Content Type**: 🛠️ Technical Reference
**Language**: en
**Scores**: Signal:5/5 | Depth:4/5 | Unique:4/5 | Practical:5/5 | Anti-Hype:4/5
**Main Journal**: 92/100 | **Annex Potential**: 85/100 | **Overall**: 88/100
**Topics**: [[OpenAI Codex, AI Agents, Agent Skills, Developer Tools, Workflow Automation]]
OpenAIが提供する開発者向けAIツール「Codex」（CLIおよびIDE拡張）において、特定のタスクやワークフローを自動化するための拡張規格「Agent Skills」の全容が公開された。著者は、Agent Skillsを「指示、リソース、オプションのスクリプトをパッケージ化したもの」と定義しており、これによって開発チームは独自の文脈に沿った高度な自動化をCodex上で実現できるようになる。
本ドキュメントの核心は、スキルが「SKILL.md」というMarkdownファイルを中心としたディレクトリ構造で定義される点にある。このファイルにはスキルの名称、説明、メタデータ、そしてエージェントが従うべき具体的な指示を記述する。また、必要に応じて実行可能なコード（scripts/）や関連ドキュメント（references/）、テンプレート（assets/）を同梱することが可能だ。特筆すべきは「Progressive Disclosure（段階的開示）」によるコンテキスト管理の効率化である。Codexは起動時に利用可能なスキルの名前と説明のみを読み込み、ユーザーのタスクとスキルの内容が一致した際（暗黙的呼び出し）、あるいはユーザーが明示的に指定した際（/skillsコマンド等）にのみ、詳細な指示や参照情報をロードする仕組みを採用している。
実務上の重要ポイントとして、スキルの「優先順位（Precedence）」と「スコープ」が挙げられる。スキルは、現在の作業ディレクトリ（.codex/skills）、リポジトリのルート、ユーザーのホームディレクトリ、システム全体という4つの階層で管理できる。上位の階層（プロジェクト固有の設定など）は下位の階層（システムデフォルトなど）を上書きできるため、組織全体で共通のスキルセットを持ちつつ、特定のマイクロサービスやモジュールごとに挙動をカスタマイズすることが容易だ。
さらに、スキルの作成自体もAIによって効率化されており、組み込みの`$skill-creator`を使用することで、自然言語の記述からスキルの雛形をブートストラップできる。また、LinearやNotionといった外部ツールとの連携を可能にするスキルがキュレーションされており、`$skill-installer`を通じて簡単に導入できる点も、開発ワークフローへの即時導入を促す要因となっている。著者は、このAgent Skillsというオープンな標準規格に基づき、チーム内やコミュニティでスキルを共有することで、AIエージェントの能力をリポジトリ固有の専門知識にまで拡張できると強調している。ウェブアプリケーションエンジニアにとっては、自社のコーディング規約やCI/CDパイプライン、独自のライブラリ使用法などを「スキル」として定義し、チーム全体でAIの回答精度と実行能力を底上げするための強力なフレームワークとなるだろう。