Claude → Codex スキルツールキットは何をしますか？

目的

Claude から Codex へのスキルライフサイクル全体を処理します。

GitHub リポジトリまたはローカルスキルフォルダを検査
.claude/skills/<name>/skill.md を手動で作成するシェルスニペットを検査
最短かつ安全なルート（直接インストールまたは移行）を選択
ユーザーが Claude チュートリアルで見つけたインストールヒントを分類
アクション実行前に互換性、依存関係リスク、インストール階層をスコアリング
必要に応じて検出に重要なメタデータを書き換え
Codex が結果を実際に検出できることを検証
完成したスキルを再利用または GitHub 公開用にパッケージ化

このスキルは、一度限りのインストールと、再利用可能で洗練された Codex ネイティブポートの構築の両方に使用します。

自動トリガー

リクエストに以下のようなアイデアが含まれる場合に有効化します。

この Claude スキルを Codex にインストール
この Claude Code スキルを移行
このスキルを Codex に移植
このスキルを Codex に適応
この mkdir/printf .claude/skills/.../skill.md コマンドは本当にスキルをインストールするのか
インストールしたスキルが表示されない理由
移行したこのスキルを GitHub 用にパッケージ化
この Claude スキルが Codex で動作するかレビュー

ユーザーが「このスキルをインストール」と言ってリンクを貼っただけでも、以下を直接 Claude 関連シグナルとして扱います。

GitHub URL または owner/repo 参照で anthropics/ が含まれる場合、特に anthropics/skills
URL、リポジトリ名、またはテキストに Claude、Claude Code、Anthropic、anthropics が含まれる場合
.claude/skills、.claude-plugin、skill.json、marketplace.json を含むパスまたはスニペット
/plugin marketplace add、/plugin install、/plugin add などのコマンド
Claude 固有の ZIP アップロードフローまたは Skills API 参照

これらのマーカーが存在する場合、生の直接インストールに依存する前に、このスキルを最初に使用してください。

クイックルート選択

最も短くても信頼性の高いルートを選択します。

リポジトリにすでにクリーンな SKILL.md があり、フォルダレイアウトが明らかな場合は、まず正確なスキルフォルダをインストールし、その後検出を検証します。
リポジトリに .claude/skills、.claude-plugin、skill.json などのプラットフォーム固有レイアウトが含まれている場合は、インストール不可能と判断する前にこれらのシグナルを検査します。
ユーザーが .claude/skills/<name>/skill.md を作成するシェルスニペットを提供した場合は、ローカルスキャフォールドとして扱い、インストール済みと呼ぶ前に生成されたフォルダを検査します。
リポジトリが Claude 固有、曖昧、マルチスキル、または Claude のみの前提を使用している場合は、成功を主張する前に移行します。
タスクが評価のみの場合は、何もインストールせずにリポジトリを検査し、互換性を説明します。
ユーザーが共有可能なアーティファクトを希望する場合は、最小限の構造と検証ノートを備えたクリーンな Codex ネイティブパッケージを構築します。

ローカルフォルダが利用可能で、リポジトリレイアウトが明らかでない場合は scripts/inspect_skill_repo.py を使用します。フロントマターまたは BOM 問題の決定論的チェックが必要な場合は scripts/check_skill_md.py を使用します。ユーザーが Claude チュートリアルコマンドまたはインストールスニペットを貼り付け、それを Codex ルートにマッピングする必要がある場合は scripts/classify_install_hint.py を使用します。インストール可能性は問題ないが、スキルが実際のユーザープロンプトとよく一致するかどうかを知る必要がある場合は scripts/trigger_score.py を使用します。各インストールレビューの後に読みやすい Markdown 分析を残すには scripts/generate_install_report.py を使用します。選択したローカルスキルを Codex にコピーできる半自動ルートセレクタが必要な場合は scripts/install_skill_flow.py を使用します。

コアワークフロー

ソースを検査する。リポジトリレイアウトを読み取り、skills/、SKILL.md、ヘルパースクリプト、および Claude のみのパッケージング前提を特定します。
ルートを決定する。 references/compatibility-matrix.md を使用して、直接インストール、軽微な適応、または完全な移行のいずれかを決定します。ユーザーがチュートリアルコマンドをコピーした場合は、まず references/install-route-adaptation.md で正規化します。
最小限の変更を実行する。

ソースがすでに Codex フレンドリーな場合は直接インストール。
検出またはトリガー品質が弱い場合は SKILL.md とサポートファイルを書き換え。
耐久性のある Codex ポートを構築する場合は、長いガイダンスを references/ に分割。
互換性スコアとインストール階層を使用して、ルートが安全かリスクがあるかを説明。
結果が後でレビューされたり、共有されたり、移行レコードとして使用される場合は、インストールレポートを生成。

想定せずに検証する。常に以下を確認：

スキルフォルダが意図した場所に存在すること
SKILL.md がパーサーフレンドリーであること
ファイルが UTF-8 で BOM なしであること
ターゲットがライブ Codex インストールの場合、codex debug prompt-input がスキルを表示すること

要求されたらクリーンにパッケージ化する。 GitHub または共有用に、1つの正規スキルフォルダを維持：

SKILL.md
有用な場合 agents/openai.yaml
オンデマンドでロードする価値のある素材のみ references/ に配置
決定論的ヘルパーのみ scripts/ に配置

GitHub スキルリポジトリの高速パス

ユーザーが GitHub リポジトリまたはスキル URL を提供した場合：

まずリポジトリルートと skills/ を検査する。
リポジトリが単なるドキュメントやカタログであると判断する前に、.claude/skills、ルート skill.json、および .claude-plugin/plugin.json も検査する。
リポジトリ、所有者、パス、または周囲のテキストに anthropics/skills、Claude、Anthropic、または .claude/* などの Claude 関連シグナルが含まれている場合、スキルパスが明白に見えても、このツールキットフローにとどまる。
ターゲットパスが明確な場合は、リポジトリ全体ではなく、正確なスキルフォルダをインストールする。
インストール直後にインストールされた SKILL.md を読み取る。
検出がすでにクリーンで、トリガー品質が許容範囲であれば停止する。
インストールされたスキルが表示されない、名前が曖昧、不正な形式、説明が弱い、または Claude 専用の場合は、移行に切り替える。

自信を持ってパスを推測できる場合は、正確な --repo と --path のインストールを優先します。

ローカル Claude シェルスニペットの高速パス

ユーザーが mkdir ... .claude/skills/... && printf ... > skill.md のようなシェルスニペットを提供した場合：

公開されたスキルがインストールされた証拠ではなく、ローカルスキャフォールドとして扱う。
生成されたフォルダを直接検査する。
skill.md または Skill.md を SKILL.md に正規化する。
必要に応じて、Markdown メタデータセクションを YAML フロントマターに変換する。
正規化後でのみ、スキルが Codex 対応であると主張する。

移行ルール

移行が必要な場合：

元のパッケージングではなく、動作を保持する。
name と description が機能とトリガーフレーズの両方を明確に表現するように、フロントマターを書き換える。
ボディは簡潔で実用的に保つ。
長いプレイブック、マッピング、トラブルシューティングは references/ に移動する。
実際の検出理由がない限り、重複するエイリアスを避ける。

完全なシーケンスについては、references/migration-playbook.md を読んでください。

検出ルール

「ディスクにはインストールされているが、codex debug prompt-input に表示されない」をインストール失敗として扱う。
SKILL.md を UTF-8 BOM なしで保存する。
スキルごとに1つの正規フォルダを推奨する。
フロントマターをシンプルに保つ。
description を、Codex が実際のユーザーの言い回しにマッチできるようにトリガー豊富にする。

検出が壊れている場合は、references/discovery-troubleshooting.md を使用します。

パッケージングルール

共有可能な Codex ネイティブポートを構築する場合：

正規スキルフォルダ自体を公開する
ユーザーが明示的にリポジトリ向けドキュメントを要求しない限り、余分なドキュメントファイルを避ける
ヘルパースクリプトは汎用的で決定論的に保つ
同じスキルの重複した移行バリアントを出荷しない
リポジトリに複数のスキルが含まれている場合は、各スキルを個別のスキルフォルダとしてパッケージ化する

必須検証

移行が完了したと呼ぶ前に、以下を確認：

scripts/check_skill_md.py <path-to-skill-md> がブロックする問題を報告しないこと
scripts/inspect_skill_repo.py <path-to-skill-folder> が期待される構造を示すこと
互換性スコア、依存関係プロファイル、インストール階層が選択したルートに対して妥当であること
トリガー品質が現実的なプロンプトに対して十分に良いこと、またはレポートが移行ポリッシュがまだ必要である理由を明確に説明していること
codex debug prompt-input がライブ Codex スキルディレクトリにインストールされたときにスキルを表示すること

リファレンスガイド

必要なものだけを読んでください：

references/migration-playbook.md エンドツーエンドの移行シーケンス用
references/compatibility-matrix.md ルート選択用
references/install-route-adaptation.md Claude インストールチュートリアルを Codex アクションに変換するため
references/install-workflow.md 半自動インストーラパターン用
references/discovery-troubleshooting.md 障害分析用

Claude → Codex スキルツールキット