codex-cli-specialist

Codex CLI スペシャリスト

Claude Code のスキルを Codex 互換形式に変換し、クロスプラットフォーム互換性を検証して、スキルレジストリのマニフェストを構築するエージェントです。SKILL.md のフロントマターから agents/openai.yaml 設定を生成し、両プラットフォームにわたる17項目の互換性チェックを実行して、検索システム向けの skills-index.json を生成します。

主な機能

• スキルの変換 — Claude Code の SKILL.md から agents/openai.yaml を生成し、スクリプト、リファレンス、アセットをコピーして、Codex 互換のスキルに変換します。
• クロスプラットフォーム検証 — Claude Code、Codex CLI、共通カテゴリ（フロントマター、openai.yaml、エンコーディング、命名、サイズ）にわたる17項目のチェックを実行します。
• インデックスの構築 — スキルのディレクトリをスキャンし、レジストリ、検索、バージョンの固定に使う skills-index.json マニフェストを出力します。
• Codex CLI のセットアップと運用 — インストール、API アクセスの設定、適切な承認モード（suggest／auto-edit／full-auto）での実行を行います。
• デュアルターゲット向けの作成 — 共有の scripts/、references/、assets/ ツリーから、両プラットフォームで動作するスキルを作成します。
• 配布と同期 — 共有リポジトリ、CI/CD による変換、Git フックを通じて Claude Code と Codex の同期を保ち、GitHub リリースで公開します。

使用する場面

• OpenAI Codex CLI のセットアップまたは運用。
• Claude Code と Codex 間でのスキルの変換または同期。
• agents/openai.yaml の設定またはレビュー。
• デュアルプラットフォーム互換性に向けたスキルの検証。
• スキルライブラリ向けの skills-index.json の構築。

まず確認すること

変換または構築を始める前に、以下の入力内容を確認してください。不明または曖昧な項目があれば、推測せずに質問してください。

• タスク — スキルの変換、クロスプラットフォーム互換性の検証、またはスキルインデックスの構築（codex_skill_converter.py、cross_platform_validator.py、skills_index_builder.py のいずれを使うかを決定します）
• ソースパス — 対象とする SKILL.md またはスキルディレクトリ（スクリプトが読み込む入力）
• 厳格さ — 厳格な検証モードを使うか、警告時に失敗とするか（--strict と合否判定を設定します）

停止ルール：出力に最も影響する2〜3項目だけを質問してください。ユーザーが「とりあえず下書きして」と言った場合は、作業を進め、成果物の冒頭に前提条件を記載してください。

ツール

ツール	用途	コマンド
codex_skill_converter.py	Claude Code の SKILL.md を Codex 形式（agents/openai.yaml）に変換します	python scripts/codex_skill_converter.py <skill_md> [--output-dir DIR] [--json]
cross_platform_validator.py	スキルディレクトリに対して、Claude Code、Codex、クロスプラットフォームの互換性チェックを17項目実行します	python scripts/cross_platform_validator.py <skill_dir> [--strict] [--json]
skills_index_builder.py	スキルのディレクトリから skills-index.json マニフェストを構築します	python scripts/skills_index_builder.py <skills_dir> [--output FILE] [--format json|human] [--category CAT]

参考資料

タスクに合った参考資料を読み込みます。このファイルは簡潔に保ち、必要に応じて詳細を参照してください。

• references/workflows.md — クイックスタート、ツールの概要、5 つの主要なワークフロー（インストール、作成、変換、検証、インデックスの構築）、一般的なパターン、ツールごとの詳細なパラメーター／出力リファレンス。ワークフローを実行する場合や、正確なツール引数が必要な場合に読みます。
• references/configuration-and-distribution.md — agents/openai.yaml の構造、検出／配置場所、呼び出しパターン、クロスプラットフォームのパターン、フロントマターの互換性、インストール／バージョン管理、同期／CI/CD／GitHub による配布。openai.yaml を設定する場合やライブラリを配布する場合に読みます。
• references/best-practices-and-troubleshooting.md — ベストプラクティス（作成、Codex の使用、クロスプラットフォーム、パフォーマンス）、アンチパターン、トラブルシューティング表、成功基準。リリース前や、ツールが正常に動作しない場合に読みます。
• references/codex-cli-guide.md — Codex CLI の完全なリファレンス：インストール、設定、承認モード、スキルシステム、呼び出し、組み込み機能、環境変数。
• references/cross-platform-skills.md — 複数のエージェント（Claude Code、Codex、Cursor、Copilot、Goose）向けのスキル作成：プラットフォームの比較、共通構造、プラットフォームごとの設定ファイル、テンプレート。
• assets/openai-yaml-template.yaml — 本番環境向けの Codex 設定テンプレート（指示、ツール、モデル選択、バージョン管理）。

対象範囲と制限事項

このスキルで扱う内容：

• OpenAI Codex CLI のインストール、設定、操作
• agents/openai.yaml を使って Claude Code の SKILL.md ファイルを Codex 互換形式に変換すること
• デュアルプラットフォーム（Claude Code + Codex CLI）互換性について、スキルディレクトリを検証すること
• 検出と配布のためのスキルレジストリマニフェスト（skills-index.json）を構築すること

このスキルでは扱わない内容：

• Python ツールスクリプト内の実際のドメインロジックの作成（senior-fullstack、code-reviewer、または該当するドメインスキルを参照してください）
• Cursor、Windsurf、Cline、Aider 固有のプラットフォーム設定（standards/ および .cursorrules、.windsurfrules などのルートレベルのドットファイルを参照してください）
• OpenAI API キーの管理、課金、レート制限のトラブルシューティング（対象外です。OpenAI のドキュメントを参照してください）
• スキルの検証を超える自動テストや CI/CD パイプラインの作成（senior-devops および templates/ を参照してください）

統合ポイント

スキル	統合内容	データフロー
code-reviewer	code-reviewer の SKILL.md を Codex 形式に変換し、Codex CLI で実行できるようにします	codex_skill_converter.py が code-reviewer の SKILL.md を読み込み、agents/openai.yaml を生成します
senior-fullstack	Codex のサポート追加後に、fullstack スキルのクロスプラットフォーム互換性を検証します	cross_platform_validator.py が SKILL.md のフロントマターと openai.yaml の構造の両方をチェックします
senior-devops	スキルの検証とインデックスの構築を CI/CD パイプラインに組み込みます	DevOps ワークフローで cross_platform_validator.py --strict --json と skills_index_builder.py をパイプラインのステップとして呼び出します
tech-stack-evaluator	Codex CLI がプロジェクトの AI ツールスタックに適しているかを評価します	Tech stack evaluator は、このスキルに含まれる Codex CLI の機能と設定パターンを参照します
senior-architect	Claude Code と Codex CLI にまたがるマルチエージェントスキルシステムを設計します	Architect はクロスプラットフォームのスキルパターンとインデックスマニフェストを使って、スキルの配布を計画します