open-design-landing は何をしますか?
Atelier Zero デザインシステムを使用して、シングルページのエディトリアルランディングサイト(またはスライドデッキ。姉妹スキル open-design-landing-deck を参照)を構築します。暖かいペーパーバックグラウンド、Inter Tight + Playfair Display、イタリックのセリフ強調スパン、点線のヘアラインルール、コーラル色の終端ドット、スクロールリビールモーション、そして16のシュールなコラージュプレートが特徴です。
これは、Open Design の標準的なマーケティングページレシピです。サンプル出力は、open-design で実際に確認できるページそのものです。
このスキルは完全に パラメーター化 されています。エージェントはユーザーのブリーフから型付けされた単一の inputs.json を生成し、コンポーザーがそのJSONと標準の styles.css をデプロイ可能なアーティファクトに変換します。
inputs.json + styles.css 16 image slots
│ │
└──────────► scripts/compose.ts ◄────────────┘
│
▼
<out>/index.html (self-contained)
<out>/assets/ (PNG or SVG)
得られるもの
すべて を含む単一のHTMLファイル:
- エディトリアルトップバー(巻号/言語ストリップ)、Headroomスタイルの固定ナビゲーション(GitHubスター数のライブ表示付き)。
- 紙質テクスチャの背景を持つ、8つのローマ数字セクション: ヒーロー(3つの統計リング + 4ステップインデックス)、アバウト、ケイパビリティ(4枚のカード)、ラボ(5枚のカード + フィルターピル + プログレスバー)、メソッド(4ステップ、サムネイル付き)、厳選作品(ダークスラブ + 2枚の傾斜カード)、お客様の声(プルクオート + 5つのパートナーグリフ)、CTA(リボン + メールピル)。
- 4つのリンクカラムと大きなイタリックセリフキッカーワードを持つフッター。
- すべてのセクションにスクロールリビールモーション(IntersectionObserver、
prefers-reduced-motionを尊重)。 - 1280 / 1080 / 880 / 560 ブレークポイントで完全レスポンシブ。
ワークフロー契約
以下の4つのステップを順に実行します。エージェントは各ステップを 完了 してから次に進み、コピーをでっち上げるよりも、ユーザーに対して焦点を絞った質問をすることを優先します。
1. ブランド入力を収集する
AskQuestion(またはUIの同等の機能)を使用して、ブランドブリーフをチャンク単位で収集します。schema.ts 全体をユーザーに一度に提示 しないで ください。回答を、型指定された形状に一致する inputs.json にマッピングします。
8つの質問グループ(順番通り):
| グループ | スキーマフィールド | 最小回答数 | 備考 |
|---|---|---|---|
| 1 | brand.{name,mark,tagline,description,location} | 5 | Mark = 単一のグリフ (Ø, ▲, ★…) |
| 2 | brand.{license,version,year,primary_url,contact_email} | 4 | URLは必須; ライセンスのデフォルトはApache-2.0 |
| 3 | nav[] (最大5つ) | 3 | オプションのカウントバッジ |
| 4 | hero.{label,headline,lead,primary,secondary,stats} | すべて | ヘッドラインは MixedText (サンセリフ + 強調 + ドット) |
| 5 | about + capabilities.cards[4] | すべて | 4枚のカード × {num,tag,title,body} |
| 6 | labs.cards[5] + method.steps[4] | すべて | 両方のグリッドは固定アリティ |
| 7 | work.cards[2] + testimonial | すべて | 5つのパートナーグリフはインラインSVGパスデータ |
| 8 | cta + footer.{columns[4],mega} | すべて | メガキッカーはヘッドラインと同じ MixedText |
完全な動作例(Open Design自体)については、inputs.example.json を開いてください。
2. 画像戦略を決定する
| 戦略 | 選択するタイミング | コスト / レイテンシ |
|---|---|---|
placeholder | 最初のパス。デモ。社内スライド。画像予算がまだない場合。 | $0, <1s |
generate | 最終納品。ブランドがオリジナルのコラージュを希望する場合。 | ~$0.40, ~6分 |
bring-your-own | ユーザーがアートディレクション済みのPNGを持っている場合。assets_path に配置。 | $0, 0s |
inputs.imagery.strategy を適宜設定します。
placeholder — フレームモード
npx tsx scripts/placeholder.ts <out>/assets/
16個の .svg ファイル(互換性のために .png エイリアス付き)を <out>/assets/ に書き込みます。各プレースホルダーは、スロットID、アスペクト比、ピクセル寸法、および image-manifest.json からのプロンプトヒントを表示します。コンポーザーの <img src='./assets/hero.png'> などはそのまま動作します。
generate — gpt-image-2 モード
FAL_KEY=... npx tsx scripts/imagegen.ts <inputs.json> --out=<out>/assets/
fal.ai の openai/gpt-image-2 同期エンドポイントをスロットごとに呼び出します。プロンプトは次のように構成されます: スタイルアンカー(ペーパーコラージュエディトリアルシステム)+ ブランド変数(名前/ナビ/ヘッドライン/イタリック強調を inputs.json から取得)+ スロットごとの構成(例:切り取られた石膏の頭部 + アーチを通って伸びる木)。ターゲットファイルがすでに存在するスロットはスキップします。--force を渡すと再レンダリングします。
FAL_KEY がない場合、スクリプトはプロンプトを出力するので、オペレーターは /gpt-image-fal スラッシュコマンドスキルを使用して手動で画像を生成できます。
bring-your-own
assets/image-manifest.json のファイル名に一致する16個のPNGを、inputs.imagery.assets_path に配置します。完了です。
3. アーティファクトを構成する
npx tsx scripts/compose.ts <inputs.json> <out>/index.html
コンポーザーは inputs.json と ../styles.css を読み取り、1つの自己完結型HTMLファイルを書き込みます。ページには以下が含まれます:
- インライン化された完全なAtelier Zeroスタイルシート。
- 段階的なスクロールモーションのための
data-reveal属性を持つ、すべてのセクションマークアップ。 - インラインの IntersectionObserver スクリプト(
apps/landing-page/app/_components/reveal-root.tsxをミラーリング)。 - インラインの Headroom ナビゲーションスクリプト(
header.tsxをミラーリング)。 - インラインの GitHub スター数フェッチャー(
brand.primary_urlから自動検出)。
4.(オプション)デプロイ可能な Astro サイトをミラーリングする
デプロイ可能なプロダクション出力の場合は、apps/landing-page/ パッケージをフォーク します。ワークスペースにコピーし、app/page.tsx を inputs.json の内容に合わせて調整し、<out>/assets/*.png を app/image-assets.ts / R2 URL が想定するパスにコピーします。pnpm --filter @open-design/landing-page build でビルドすると、任意のCDNに配置可能な静的な out/ エクスポートが生成されます。
将来のイテレーションでは、
inputs.jsonから完全なapps/landing-page/ツリーを1つのコマンドで生成するコンポーザーがバンドルされる可能性があります。それまでは、フォーク&編集がサポートされるパスです。
納品前のセルフチェック
完了とマークする前に、エージェントは以下を 必ず 確認する必要があります:
-
<out>/index.htmlがブラウザで開かれ、コンソールエラーがないこと。 - 16個すべての画像スロットが読み込まれること(DevToolsのネットワークタブで404がないこと)。
- ヘッドラインのイタリック強調スパンがPlayfairでレンダリングされていること(サンセリフではない)。
- すべての
displayh1/h2の末尾にコーラル色の終端ドットが表示されること。 - 上から下までスクロールし、すべてのセクションが一度アニメーションすること。
- 880pxおよび560pxにリサイズしても、水平スクロールがなく、オーバーラップがないこと。
-
prefers-reduced-motion: reduce(DevTools → Rendering)でトランジションがきれいに無効化されること。 - Lighthouse: コントラストAA、font-display swap、ヒーローにレイアウトシフトがないこと(CLS < 0.05)。
このスキルのファイル
skills/open-design-landing/
├── SKILL.md # 本契約書
├── README.md # クイックスタート
├── schema.ts # 型指定された入力(単一の真実源)
├── styles.css # Atelier Zero スタイルシート(単一の真実源)
├── inputs.example.json # 動作例としてのOpen Design
├── example.html # 標準レンダリング(inputs.example.jsonから再生成)
├── scripts/
│ ├── compose.ts # inputs.json + styles.css → index.html
│ ├── imagegen.ts # gpt-image-2ラッパー(fal.ai)
│ └── placeholder.ts # SVG紙質テクスチャフレーム
└── assets/
├── *.png # 16個のコラージュプレート(Open Designインスタンス)
├── image-manifest.json # スロット → ファイル/寸法/プロンプトのマッピング
└── imagegen-prompts.md # 人間が読めるプロンプトパック
境界
- 新しい色や書体を考案しないでください。 トークンは
design-systems/atelier-zero/DESIGN.mdにあります。ここに新しいランプを追加する前に、デザインシステムを拡張してください。 - 生成されたマークアップから
data-reveal属性を削除しないでください。 これがないと、ページは静的で生命力のないものになります。 - 独自のスタイルシートの順序を注入するフレームワークで構成されたHTMLをラップしないでください。 Atelier Zeroは、紙のテクスチャとサイドレールのz-indexのために、スタイルシートの順序カスケードに依存しています。
- Astroランディングページフォーク用に別のスタイルシートファイルを追加しないでください。
styles.cssをそのままapp/globals.cssにコピーして、視覚的なパリティを1対1に保ってください。
関連情報
design-systems/atelier-zero/DESIGN.md— トークン仕様。apps/landing-page/— デプロイ可能なAstro静的カウンターパート。skills/open-design-landing-deck/— このデザインシステムを再利用する姉妹スライドスキル。
