Skills (スキル)

1 つのスキルは指示・リソース・任意のスクリプトをまとめたもので、Codex が決まったワークフローに沿って作業するために使います。スキルはオープンな agent skills standard を土台にしています。チームの作業手順をコーディングエージェントに組み込み、管理する場面に関わる機能です。

スキルは SKILL.md ファイルを含むディレクトリで、必要に応じてスクリプトや参照資料を加えます。SKILL.md には name と description が必須です。手動で作る場合も、SKILL.md を置いたフォルダを作成します。

スキルは progressive disclosure (段階的な読み込み) の仕組みで使われます。Codex はまず各スキルの名前と説明だけを把握し、そのスキルを使うと判断した時点で SKILL.md の指示全体を読み込みます。

• 最初に読み込むスキル一覧の大きさは、既定でモデルのコンテキストウィンドウの最大 2%、コンテキストウィンドウが不明な場合は 8,000 文字までです。
• skills.max_context_tokens で、この一覧の予算を最大 10,000 トークンまで別の値に設定できます。

任意の agents/openai.yaml を加えると、ChatGPT デスクトップアプリでの表示用メタデータ、呼び出しのポリシー、ツールの依存関係を設定できます。allow_implicit_invocation (既定は true) を false にすると、Codex はそのスキルを自動では呼び出しません。この場合も $skill による明示的な呼び出しは使えます。

Codex はリポジトリ・ユーザー・管理者・システムの各場所からスキルを読み込みます。リポジトリでは、現在の作業ディレクトリからリポジトリのルートまでの各ディレクトリにある .agents/skills を走査します。シンボリックリンクのスキルフォルダにも対応し、リンク先をたどって走査します。同じ name のスキルが 2 つある場合、Codex は統合せず、両方がスキルの選択画面に表示される場合があります。

組み込み以外の厳選スキルをローカルの Codex に追加するには $skill-installer を使います (例: $skill-installer linear)。インストーラーに指示して、他のリポジトリからスキルをダウンロードすることもできます。

スキルを削除せずに無効にするには、~/.codex/config.toml に [[skills.config]] のエントリを追加し、スキルのパスと enabled = false を指定します。設定を変えた後は Codex を再起動します。エントリでは、絶対パスは 1 つの SKILL.md に、name はその名前を持つすべてのスキルに一致し、複数のエントリが一致した場合は最後のエントリが優先されます。

プロジェクト単位で同梱のシステムスキルをすべて止めるには、そのプロジェクトの信頼済みの .codex/config.toml に次を追加します。

[skills.bundled]
enabled = false

対象プランについては、公式のリリースノートには記載がありません。同梱の OpenAI Docs スキルに GPT-5.6 のガイダンスを加えた更新は、macOS・Linux・Windows 向けです。

ここでは、組み込みの作成ツールでスキルを作り、呼び出すまでの流れを示します。

1. Codex で $skill-creator を呼び出し、作りたいスキルの内容を説明します。
2. 作成ツールが、スキルの役割、どんなときに起動するか、指示のみ (既定) にするかスクリプトを含めるかを尋ねるので、それに答えます。
3. Codex はスキルの変更を自動で検出します。更新が反映されない場合は Codex を再起動します。
4. Codex CLI や IDE 拡張で /skills を実行するか、$ を入力してスキルを指定し、呼び出します。