Agent SkillsをClaude CodeとCodexで共用するときに見るべき差分

複数のAIエージェントツールを使い分ける現場では、特定のチームの手順を何度も入力するのは非効率です。そのため SKILL.md という形式でファイル化し、ツール側で自動発見させる工夫が定着しています。ただし Claude Code と Codex というツール間では、ファイルを探すディレクトリが異なります。Claude Code なら .claude/skills/ を見ますが、Codex は公式ドキュメント上 .agents/skills/ を指定対象にしています。同じ名前のファイルを両方に置いても、どちらか一方にしか自動発見されない現実があり、無視するとどちらかのツール側でスキルが見落とされるトラブルが起きます。

AIの鬼が着目するのは、この「配置の差を隠さないこと」の大切さです。ツール間の差を無理に吸収しようとして、本文に「Claude Code のコマンド使用」「Codex のこのツール名で実行」といったホスト依存の記述を混ぜると、手順そのものが再利用できなくなります。本来なら「ファイルを読む」「手順を実行する」という抽象度で書く方が、複数ホストへの移植性が高まります。一方、配置は素直にホストごとに分け、実装の差を「検証結果は記事や PR に残す」という形で記録に残しておくのが現実的です。アストラやクロードといった複数モデルを試すように、今後はコーディング支援ツールも複数使うチームが増えるでしょう。そのとき SKILL.md をどう管理するかは、ツールの乗り換えや併用の成否を左右する運用課題になります。