Codex plugin（.codex-plugin/plugin.json）の表示用メタデータは、マニフェストのトップレベルではなく interface オブジェクト配下に置く。2026-07 時点の実測に基づく。

フィールドと配置

interface 配下で使える主なキー: displayName / developerName / shortDescription / longDescription / category / capabilities / websiteURL / privacyPolicyURL / termsOfServiceURL / brandColor / composerIcon / logo / logoDark / screenshots。アイコン類は plugin 同梱の assets ディレクトリへの相対パス（SVG/PNG とも可）。

誤解しやすい条件（実測で確認した壊れ方）

• 同じキー名（logo / composerIcon）をトップレベルに置くとエラーにならず黙って無視される。interface に移すと反映される。
• 設定はセッション起動時に読まれるため、反映確認には version bump → マーケットプレイス再取得 → アプリ完全再起動が必要。
• スキル行のアイコンは現状サードパーティから制御できない（interface.composerIcon、MCP サーバーの serverInfo.icons 広告、MCP 設定の _meta.ideToolIconPath のいずれも効かず。official directory 掲載 plugin のみ反映されている可能性）。

スキーマの一次資料の見つけ方

公式ドキュメントはフィールドの正確な配置を示さないことがある。確実なのは、ベンダー自身が配布する公式 plugin の実マニフェストをローカルキャッシュ（Codex の場合は curated plugin のキャッシュディレクトリ）から横断 grep して逆引きすること。今回も interface 配下という正解は公式 plugin 177 件の composerIcon 使用箇所から特定できた。同じ手法は他の未文書ツール仕様（設定ファイル形式・マニフェスト拡張）にも転用できる。