open-design-landing は何をしますか?
シングルページのエディトリアルランディングサイト(またはスライドデッキ — 姉妹スキル open-design-landing-deck を参照)を Atelier Zero デザインシステムで構築します。暖かみのある紙背景、Inter Tight + Playfair Display フォント、イタリックのセリフ強調、点線のヘアライン、コーラルカラーの終端ドット、スクロールリビールアニメーション、そして16枚のシュールなコラージュ画像を備えています。
これは Open Design マーケティングページの標準レシピです — 出力例はまさに open-design でご覧いただけるページそのものです。
このスキルは完全に パラメータ化 されています。エージェントはユーザーのブリーフから型付けされた inputs.json を生成し、コンポーザーがその JSON と標準の styles.css を組み合わせてデプロイ可能なアーティファクトを生成します。
inputs.json + styles.css 16の画像スロット
│ │
└──────────► scripts/compose.ts ◄────────────┘
│
▼
<out>/index.html (自己完結型)
<out>/assets/ (PNG または SVG)
得られるもの
1つのHTMLファイルに すべて 含まれています:
- エディトリアルなトップバー (Volume / Issue / 言語ストリップ)、Headroom スタイルのスティッキーナビゲーション(GitHub スター数をリアルタイム表示)。
- 紙テクスチャ背景の8つのローマ数字セクション:ヒーロー(3つの統計リング + 4ステップインデックス)、アバウト、ケイパビリティ(4枚のカード)、ラボ(5枚のカード + フィルターピル + プログレスバー)、メソッド(4ステップ + サムネイル)、厳選された作品(ダークスラブ + 2枚の傾いたカード)、推薦の言葉(プルクォート + 5つのパートナーグリフ)、CTA(リボン + メールピル)。
- 4つのリンクカラム + 大きなイタリックセリフのキッカーワードを含むフッター。
- すべてのセクションにスクロールリビールアニメーション (IntersectionObserver、
prefers-reduced-motionに対応)。 - 1280 / 1080 / 880 / 560 のブレークポイントで完全レスポンシブ。
ワークフロー契約
以下の4つのステップを順番に実行します。エージェントは各ステップを 完了 してから次に進み、コピーをでっち上げるよりも、ユーザーに的を絞った質問をすることを優先します。
1. ブランド入力を収集する
AskQuestion(または同等のUI)を使用して、ブランドブリーフを分割して収集します。スキーマ全体をユーザーに一度に提示 しないで ください。回答を、型付けされた形状に合うように 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} | すべて | Headline は MixedText (sans+em+dot) |
| 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} | すべて | Mega kicker は見出しと同様の MixedText |
完全な動作例(Open Design 自身)については、inputs.example.json を開いてください。
2. 画像戦略を決定する
| 戦略 | 選択すべきタイミング | コスト / レイテンシ |
|---|---|---|
placeholder | 最初のパス。デモ。内部スライド。まだ画像予算がない場合。 | $0, <1s |
generate | 最終納品。ブランドがオリジナルコラージュを希望する場合。 | ~$0.40, ~6 min |
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/ パッケージをフォークします。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 の末尾にコーラルカラーの終端ドットが表示されていること。 - 上から下までスクロールし、すべてのセクションが1回アニメーションすること。
- 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にコピーして、視覚的な同一性を維持してください。
関連情報
design-systems/atelier-zero/DESIGN.md— トークン仕様。apps/landing-page/— デプロイ可能な Astro 静的サイト対応。skills/open-design-landing-deck/— このデザインシステムを再利用する姉妹スライドスキル。
