Hyliox Pixel Perfect は何をしますか?
UIスクリーンショットを、フロントエンドエージェント向けの長大で高密度な規範的ビルド仕様書に変換します。最大の忠実度を優先し、簡潔さは重視しません。
哲学
このスキルは、固定の21セクションからなる約1000行の仕様書を生成します。Cursor、v0、Lovable、Codex、Claude Codeにコピー&ペーストしてすぐに使える形式です。適応的ではなく、規範的です。すべての出力で同じ21セクションが同じ順序で現れます。あるセクションに該当画像の内容がない場合(例:アニメーションが表示されていない場合)、そのセクションをスキップするのではなく、「このスクリーンショットでは表示されていません。静的として実装してください」と明示的に記載します。予測可能な構造は、可変的な創意工夫よりも優先されます。
このスキルは、二つのゴールドスタンダード出力(assets/gold-standard-kraken.md および assets/gold-standard-agentai.md)からリバースエンジニアリングされています。形式、長さ、粒度について迷った場合は、最初にゴールドスタンダードを読んでください。それらが絶対的な基準です。
解釈よりも忠実度。 画像にあるものを記述してください。セクション、コピー、機能、改善点を創作してはいけません。画像に3つのフィーチャーカードが表示されているなら、3つを記述します。ブランドロゴがブランド行で繰り返されているなら、繰り返します。ナビゲーションに「Why Karken」というタイポがあれば、それをそのまま残し(再構築者に修正するかどうかの選択肢を提供します)、記述します。
散文よりも粒度。 すべての視覚プロパティ(位置、サイズ、色、パディング、フォントウェイト)は、それぞれラベル付きの txt コードブロックに記述します。インラインコードを散文内に埋め込むだけでは不十分です。仕様書はコピー&ペースト可能な成果物であり、エッセイではありません。
デフォルトの技術スタック
- Next.js 16.2 (App Router + Turbopack) + React 19 + TypeScript
- Tailwind CSS (設定は
tailwind.config.ts) - shadcn/ui プリミティブ(必要な場合)
- Framer Motion (
motion/react) - lucide-react アイコン用
- 静的アセットは
/public/images/および/public/icons/に配置 - CSS変数はHSL形式(shadcnの慣習:
0 0% 100%のように生の値で、変数内にhsl()ラッパーは含めない)
ゴールドスタンダードからの適応に関する注意点。 二つのゴールドスタンダードの例はReact + Viteをターゲットとしています。このスキルは代わりにNext.js 16 App Routerを出力します。変換ルールはシンプルですが、一貫して適用する必要があります:
index.css→app/globals.css- アセットパスは
<Image>または<img>から/public/...をルート相対URLとして参照します(/images/foo.png) - Framer Motion、Reactフック(
useState、useEffect、useScroll、useInView)、イベントハンドラ、<video>コントロール、またはブラウザAPI(hls.js)を使用するコンポーネントは、先頭に'use client'を宣言する必要があります - 純粋なレイアウト/静的なコンテンツコンポーネントはサーバーコンポーネントのままにします(
'use client'は不要) - ページ構造はApp Routerのファイルツリーを示します(
app/layout.tsx、app/page.tsx、app/globals.css、app/components/...) - 静的な画像(既知の寸法)には
next/imageを使用し、GIFや動的/アニメーションコンテンツには生の<img>を使用します
その他(CSSユーティリティ、ガラスファミリー、fadeUpヘルパー、アニメーションパターン、レイヤード背景、ファインボーダートリック)は同一のまま移行します。
ワークフロー
スキルがトリガーされたら、次の手順を順に実行します。手順をスキップしないでください。
ステップ1 — リファレンスとゴールドスタンダードを読む
書き始める前に、以下を読み込んでください:
references/section-templates.md— 21セクションのテンプレート(各セクションの役割、コンテンツルール、形式を含む)references/idiom-library.md— 標準的なCSSスニペット(ガラスファミリー、ファインボーダー、レイヤード背景、fadeUp、フローティングモーション)references/writing-patterns.md— ラベル付きコードブロックパターン、あいまいさへのヘッジ、アンチパターン形式- 1つのゴールドスタンダードを、長さ、密度、トーンの具体的なリファレンスとして読み込みます:
- 入力画像がダーク/シネマティック/エージェンシースタイルの場合 →
assets/gold-standard-agentai.md - 入力がプロダクト/SaaS/フィンテック/ペイメントの場合 →
assets/gold-standard-kraken.md - 不明な場合 →
assets/gold-standard-kraken.md(より多様なセクションをカバー)
- 入力画像がダーク/シネマティック/エージェンシースタイルの場合 →
これらのファイルは大きいです。最初に一度だけ読み込み、生成途中で再読み込みしないでください。
ステップ2 — 画像を分析する
書き始める前に、内部的に棚卸しをします:
- 分類(3軸:インターフェースタイプ、アートディレクション、ムードレジスター)—
references/section-templates.mdの「Pre-write」セクションに完全なラベル語彙があります。この分類により、フォントプリセット、デザイントークンの方向性、冒頭の「~のように感じるべき」リストが決まります。 - ブランド名とロゴ(ナビゲーションに表示)
- ページのビジュアルメタファー(Kraken:クリプトペンダント。AgentAI:赤い生物発光クラゲ。常にページの視覚的な核を一文で表現するようにしてください。)
- セクションリスト(上から下へ:ナビゲーションバー、ヒーロー、証拠、ロゴストリップ、サービスなど)
- カラーパレット — プライマリ背景、アクセントカラー、カードサーフェス
- タイポグラフィのペアリング — 見出し用のディスプレイサンセリフ、本文用のボディサンセリフ、オプションでイタリックアクセント用のセリフ
- すべての可視コピー — タイポや繰り返しも含めて逐語抽出
- ガラス / ぼかし / ノイズ / グレイン 処理
- アニメーションの手がかり — 動きを示唆するもの(浮遊要素、ハローグロー、ホバーアフォーダンス)
何かが部分的に隠れていたり読めない場合は、ヘッジ言語を使用して仕様書にフラグを立てる計画を立てます(「…with your customers」— ユーザーが完全な文を望む場合は拡張し、そうでなければそのまま残す)。
ステップ3 — 仕様書をファイルに書き込む
単一のMarkdownファイルとして /mnt/user-data/outputs/<スラッグ>-spec.md に仕様書を生成します。ここで <スラッグ> は、画像に表示されているブランドから派生させたケバブケース(例:kraken-spec.md、agentai-spec.md、bloom-spec.md)です。ブランドが識別できない場合のみ、ui-rebuild-spec.md にフォールバックします。
ファイルは references/section-templates.md の固定の21セクションテンプレートに従います。長さの目標:800~1300行。800行より短いと粒度が不足しています。1300行より長いと冗長で水増しされています。
ステップ4 — ファイルを提示し、チャットで簡潔に返信する
present_files を仕様書パスを指定して呼び出します。チャットの返信は最大3~6行とします:
- カバーされたセクション(または「このスクリーンショットでは表示されていません」とマークされたセクション)
- 仕様書でフラグが立てられたあいまいさや仮定
- 再構築者が明示的に決定する必要がある事項(例:タイポの保持、繰り返しロゴ)
チャットで仕様書を複製しないでください。要約もしないでください。ファイルが成果物です。
忠実度のハードルール
これらは交渉の余地がありません。利便性、簡潔さ、丁寧さよりも優先されます。
逐語コピー。 画像内のすべての可視単語(見出し、ボタン、ラベル、フッター、マイクロコピー)は、元の言語で、タイポ、句読点の癖、繰り返しを含めて、そのまま仕様書に現れます。タイポが保持された場合、オプションで再構築者に選択肢を提供します(「表示されたスクリーンショットを正確に再現する場合のみ Why Karken を使用。それ以外の場合は Why Kraken を使用」)。
アンチパターンを明示。 VISUAL DETAILS TO MATCH セクションには、必ずアンチパターンのリストを含めます:避けるべきこと、やってはいけないこと、スキップすべきカラーディレクション。例:「青、緑、オレンジ、またはマルチカラーグラデーションを避けてください。パレットを黒、紫、ラベンダー、白、グレーに厳密に制限してください。漫画っぽくしないでください。」
創作禁止。 画像に表示されていないセクション、機能、ソーシャルプルーフ、推薦文、その他のコンテンツを追加しないでください。画像が途中で切れている場合(下部がクロップされている場合)、表示されているものだけを記述し、切り詰められていることを注記します。
不明瞭なものにはヘッジ。 テキストが途切れている、部分的に隠れている、または真にあいまいな場合は、捏造しないでください。「このカードはスクリーンショットの下部で部分的に切れています。表示されている本文が可視部分です。ユーザーが完全な文を望む場合は自然に '…' で拡張し、そうでなければそのまま残してください」とマークします。
レイヤード背景の分解。 すべての複雑な背景は、明示的な絶対レイヤー(ベースカラー、ラジアルグラデーション、ノイズオーバーレイ、ビネットなど)に積み重ね順とともに分解します。集約しないでください(「ドットグリッド + バイオレットグロー + ピクセルフロア」ではなく、各レイヤーを独自のスニペットでリストアップします)。
ガラスファミリーの命名。 「リキッドガラス」のような単一の名前を押し付けないでください。ガラスユーティリティは画像内での用途に応じて命名します:.glass-nav、.glass-card、.glass-card-soft、.glass-pill、.glass-panel。画像が命名を導きます。
ブランドカラーの名前空間。 デザインに強力なブランドパレットがある場合、Tailwind拡張に名前空間を設定します:colors: { kraken: { black, panel, purple, ... } } または colors: { redai: { DEFAULT, dark, soft } }。これにより、仕様書が汎用的ではなく意図的に感じられるようになります。
Box-shadowを名前付きトークンとして。 Tailwind設定で boxShadow: { 'red-glow': '...', 'glass': '...' } を定義し、インラインで shadow-[...] 文字列をあちこちに書くのではなく、shadow-red-glow として参照します。
生成途中でゴールドスタンダードを参照するタイミング
あるセクションを記述しようとしていて、その密度、粒度、形式がわからない場合 — 停止して、一致するゴールドスタンダードの同等のセクションを再読してください。ゴールドが基準を定義します。例:
- HEROセクションを記述しようとしているが、サブセクション(2a、2b、2c)の数がわからない場合? 一致するゴールドがヒーローをどのように構成しているかを確認します。
SPACING AND LAYOUT DETAILSを記述しようとしているが、JSONにどのキーが属するかわからない場合? ゴールドから構造をコピーし、値を自分の画像に合わせて適応します。VISUAL DETAILS TO MATCHを記述しようとしているが、項目が5つしかない場合? ゴールドには15~25あります。もっと見つけてください。
ゴールドはキャリブレーションツールです。それらを使用してください。
納品前のフォーマットチェックリスト
present_files を呼び出す前に、ドラフトを一度スキャンします:
- 長さが800~1300行(短い = 仕様不足、長い = 水増し)
- 「Build a...」という、技術スタックとコアな美的感覚を述べる文で始まる
- 21のセクションがすべて順序通りに存在し、一部が「このスクリーンショットでは表示されていません」と記載されていてもよい
- 冒頭または
GLOBAL PAGE DIRECTIONにビジュアルメタファーが記載されている - 技術スタックがNext.js 16 App Routerに適応されている(Viteではない)
- アニメーション/インタラクティブコンポーネントに
'use client'のリマインダーがある - すべての可視コピーが元の言語で逐語抽出されている
- 見出し内のイタリックセリフアクセントが検出され、言及されている
- CSSユーティリティが汎用的な「リキッドガラス」ではなく、その用途に基づいて命名されている
- Tailwind設定にブランドカラーの名前空間がある
- Tailwind設定にbox-shadowの名前付きトークンがある
- 背景がN個の絶対レイヤーに分解されている(集約されていない)
- すべての視覚プロパティがそれぞれラベル付きの
txtコードブロックにある(Style:、Position:、Implementation:) -
EXACT VISUAL HIERARCHYが要素を視覚的重みでランク付けしている(番号付きリスト) -
SPACING AND LAYOUT DETAILSにピクセルジオメトリを含むJSONブロックがある -
VISUAL DETAILS TO MATCHにアンチパターンが含まれている(「Aを避け、Bをしない」) -
COPYWRITING CONTENTがすべてのコピーをスキャン可能なブロックに再グループ化している - クロップされた、あいまいな、または読めないコンテンツに対してヘッジが適用されている
- 批評、改善提案、前置きがない
- 仕様書が
/mnt/user-data/outputs/<スラッグ>-spec.mdに書き込まれている - チャットの返信が最大3~6行