Oil UI
仕組みインストール・使用ガイド
エージェントガイド · OpenAI Codex

OpenAI Codex UIデザインガイド:Oil UIで作るWebサイト、管理画面、アプリ

OpenAI CodexとGPTシリーズは、コード実行、複雑な状態の連携、データ密度の高いUIに強みがあります。Oil UI Skillと組み合わせると、その実装力を、見やすいレイアウトと使いやすいインタラクションにつなげられます。リアルタイムに試せる書体ファウンドリーのサイト、タイムラインのドラッグでログをそろえる運用監視コンソール、390×844の複数画面サーフ予報アプリまで同じ手法で作れます。

重要なポイント

要点 1

npx skills add oil-oil/oil-ui でCodexにデザインワークフローを導入し、コードを書く前にレイアウトの重心と色の抑制を確立します。

Codexは実際に動くインタラクションを得意とします

「字重を変えるとライセンス価格を即時計算」「タイムラインをドラッグするとトポロジーとログのハイライトが同期」といった連携をプロンプトに明記すると、静的な展示ページよりはるかに効果的です。

同じタスクブリーフから、Codexに大きく異なる複数の方向を作らせられます

ギャラリーのOrvoの9方向、Atelier VoldersとFonderie Mercierのシリーズがその例です。

要点 4

1440×900と390×844の実ビューポートのスクリーンショットとサブエージェントのブラインドレビューを組み合わせ、テーブルのはみ出し、文字サイズの不連続、余分な罫線を取り除きます。

ページのあいだ · 独立出版ワークスペース第 07 号 · 秋号

著者原稿料精算書

精算日 11.20
未精算総額¥8,640.00
2 件は資料完備 · 1 件は銀行情報が未登録
著者と原稿税引後原稿料 (¥)状態
リン・ヤオ水辺を歩く · 長文3,200.00精算可能
チェン・ジョウ器のもう一つの表情 · 写真2,880.00精算可能
シュー・ナン庭園スケッチ · イラスト2,560.00銀行情報が必要
資料が未登録の原稿は自動的に次号へ繰り越し
OpenAI CodexにOil UIオープンソース版をインストール
npx skills add oil-oil/oil-ui

実行後、対話形式のリストでCodex / OpenAI Agentのディレクトリを選択してください。

CodexがUIで得意なことと、陥りやすい盲点

ギャラリーの作品の80%以上は、GPT / Codex系モデル(GPT 6.1 Sol、GPT 6 Luna、GPT 6 Astraなど)とOil UIで制作されています。実際の成果を見ると、Codexは本物のロジックを伴うUIを特に得意としています。「Fieldwork Type」では文字を入力しながら字幅とライセンス料金を変更し、「Nightwatch」では障害の時間帯をドラッグしてトポロジー図とデプロイマーカーを連動させ、「Vesper」では異常な請求を絞り込んでWebhookペイロードを展開できます。

一方、デザイン上の制約がないと、Codexも「エンジニアのデバッグパネル」のような画面を作りがちです。すべての項目を平場に並べ、罫線を引きすぎ、状態ボタンを一列に積み、密なテーブルの枠線の中に主次関係を埋もれさせてしまいます。Oil UIは、先に視覚的な優先順位を確立し、余分な要素を減らすために役立ちます。

ギャラリーの代表的なCodex / GPT作品とインタラクションの重心
作品とモデルUIの形式中心的なインタラクションビューポートと状態設計
Fieldwork Type (GPT 6.1 Sol)独立系書体ファウンドリーのWebサイトオンラインの書体テスターと用途に応じて即時計算するライセンスセレクター1440×900から幅390pxまでレスポンシブ対応。テスター展開時と購入時の状態を含む
Nightwatch (GPT 6.1 Sol)運用監視と障害対応時間範囲のドラッグに合わせてトポロジー、デプロイマーカー、ピーク時のログを同期1440×900の4状態:正常、警告中、ピーク調査、リリースとの関連確認
Vesper (GPT 6.1 Sol)API使用量の請求管理画面使用量のしきい値で顧客を絞り込み、異常な請求明細の確認と支払いの再試行1440×900の3状態:通常ダッシュボード、異常請求ドロワー、コマンドパレット
Tide (GPT 6.1 Sol)サーフィン・潮汐予報アプリタイムラインのドラッグで波高、風向、潮汐曲線、入水の推奨を同時に更新モバイル390×844。単一ページと3画面並列のscreens.htmlを提供

Codexで「方向比較 → 状態の実装 → スクリーンショットレビュー」を進める

CodexでOil UIを使うときは、大きなタスクを明確な段階に分け、各段階に具体的な完了条件を設けるのがおすすめです。一度に数千行の未検証コードを生成させないようにします。

  1. Skillをインストールし、実際のタスクブリーフを渡す

    npx skills add oil-oil/oil-ui を実行してインストールします。Codexに渡すブリーフには、プロダクトの位置づけ、中心となる対象、必須状態、ビューポートを含めてください。

    npx skills add oil-oil/oil-ui
  2. 複数方向を並べて比較し、主方向を一つに決める

    実際のコンテンツを使い、構図、書体の印象、色の明度が明確に異なる3~4案をCodexに作らせます。一つを選んだら、落選した案の部品を主案に寄せ集めないようにします。

  3. URLパラメーターや複数画面ページで重要な状態を固定する

    ギャラリーの「Nightwatch」や「Vesper」のように、?state=incident や screens.html を使い、3つの重要な業務状態を直接開けるビューにすると、一つずつスクリーンショットを撮って検証しやすくなります。

  4. 100%と200%のスクリーンショットで要素を減らし、ブラインドレビューを行う

    各状態を実際にレンダリングしてキャプチャし、折り返しのずれ、余分な区切り線、コントラスト不足の補助文字がないかを確認し、修正してからタスクを終えます。

Codexに適したタスクプロンプトの例

Codexへのプロンプトでは、「ユーザーがどのコントロールを操作し、画面のどこが連動して変わるか」を具体的に書くほど、プロダクトとしての実感が生まれます。次の文は直接書き換えて使えます。

Codex向け、データとインタラクションが多いUIのプロンプトテンプレート
Oil UIを使って、[プロダクト名と種類(例:AIチーム向けのAPI使用量・請求管理コンソール)]をデザインして実装してください。デスクトップのビューポートは1440×900です。
- 中心タスク:サブスクリプションプランとリアルタイムのAPI使用量を管理し、当期の請求額と異常な請求を確認します。状態や使用量のしきい値で顧客を絞り込み、各レコードの明細行、支払い、Webhookのタイムラインを開けるようにしてください。
- 重要な連動:フィルターを変えるとリストと上部のトレンドが同時に更新されます。異常な請求を開くと、支払いの再試行、クォータ調整、請求書のエクスポートを直接行えます。
- 納品する状態:1) 日常の概要とリアルタイムフィルター、2) 異常請求の詳細と復旧操作、3) クイックコマンドパレットの3状態を実装し、ブラウザーでスクリーンショットを撮って確認してください。

この構成はギャラリー作品「Vesper」の実際のタスクプロンプトをもとにしています。自分の業務上の対象に置き換えてください。

実際に動くギャラリー作品とプロンプト

関連事例のコレクションを見る →
Oil UI Pro

CodexでOil UI Proを使う

リスト―詳細、キャンバス―プロパティ、タイムライン、ノードグラフなど10種類の専門ワークスペースの骨格をCodexに使わせたい場合、既存フロントエンドリポジトリの散らかったスタイルを改修する場合、最大3ラウンドの厳密なブラインドレビューを行う場合は、Oil UI Proをインストールできます。

Oil UI Proの全機能を見る →
Pro のインストール用プロンプトをコピー
npx github:oil-oil/oil-cli install oil-ui-pro

よくある質問

ギャラリーに同じプロダクトのCodex作品が複数あるのはなぜですか(Orvoには9バージョンあります)?

同じプロダクトブリーフが、異なるデザイン方向でどう表現されるかを示すためです。Orvoの9作品は、同じプロダクトの位置づけと3段階の価格($0 / $24.99 / $34.99)を共有しながら、「Launch Garden」「Tandem」「Coastal Workshop」「Open Creative Studio」などの方向ごとに、レイアウト、色調、語り口が大きく異なります。

CodexでモバイルUIを作るとき、縮小したWebページになるのを防ぐには?

プロンプトで390×844のビューポートを明示し、操作できるindex.htmlと複数画面を並べたscreens.htmlの両方を要求してください。Oil UIは、デスクトップの3カラムを無理に1カラムへ詰め込むのではなく、親指で届く範囲、下部またはセグメントナビゲーション、1画面1主タスクを軸にモバイルUIを組み立てるようモデルを導きます。

Codexが作るダークモードはくすんだり眩しかったりしがちですが、Oil UIではどう処理しますか?

プロダクトの使用場面に合わせて明暗を決めます。例えば夜間の車載UI「Yantu」や運用監視「Nightwatch」は暗色、日常の読書やフォームツールは明色を使います。高彩度の発光色は主要な操作経路と警告状態に限定し、ページ全体がネオンパープルになるのを防ぎます。

Oil UIオープンソース版を導入済みの場合、Proへはどう切り替えますか?

npx github:oil-oil/oil-cli install oil-ui-pro を実行してProをインストールしたら、旧オープンソース版のディレクトリを削除してください。Proにはオープンソース版の全機能が含まれています。

関連ガイド

Claude Code UIデザインガイド ↗公式サイト・SaaSランディングページ実践ガイド ↗管理画面・デスクトップワークスペース実践ガイド ↗