パララックスランディングページ は何をしますか?
短い動画を、ユーザーのスクロール操作でフレームごとにシークしながら、5つの劇的なテキストシーンがクロスフェードする1画面の映画的なランディングページに変換します。ドキュメントは実際にはスクロールせず、ホイール/タッチ/キーボード入力をJSでインターセプトし、仮想フレーム進行に変換します。
このスキルは、同梱のリファレンス ../../examples/parasites/(github / lion / hope ランディング — このスキルで構築された3つの動作するページ)で実証されたパターンをエンコードしています。不明な点がある場合は、そのフォルダを信頼できる情報源として扱ってください。
YUV.AIピラミッドにおけるこのスキルの位置づけ
parallax-landing-page は、yuv-design-system、yuv-decks、yuv-viral-video、video-to-landing-page と並んで、YUV.AIスキルピラミッドの 中間層 に位置します。最上位のオーケストレーター yuv-pilot は、5〜15秒の動画クリップを1画面のスクロールシーク型ランディングにする必要がある場合に、ここにルーティングします。
このスキルは 独自のビジュアル言語(Anton + Caveat + Inter、ゴールド/アンバー/アクセント/クリームのアクセントパレット)を持ちます — yuv-design-system を呼び出しません。2つのシステムは共存します:yuv-design-system は Web/アプリ/デッキ表面のブランドパレットを担当し、parallax-landing-page は特にシネマティックなスクロールシーク美学を担当します。YUV.AIパララックスランディングでは、フッターエリアにオプションでフェニックスの透かしと正規のLinktree URLをブランドのスレッドとして追加できます — 透かしファイルについては yuv-design-system/assets/ を参照してください。Anton/Caveat フォントスタックをデザインシステムのNeonパレットに交換しないでください。それでは特徴的な外観が失われます。
何を構築するか
各ランディングは固定ビューポートの単一画面で構成されます:
- 画面いっぱいに表示されるキャンバス。一度に1フレームを描画します(cover-fit、DPR ≤ 2)
- 5つの絶対配置テキストシーン(キッカー + 大文字Anton見出し + Caveat手書き行)。それぞれに独自のスクロール進行ウィンドウがあります
PARALLAX // showcaseロゴと兄弟ランディングへのリンクを持つ固定ナビ- すべてのフレームをプリロードしてからユーザーが操作できるようにするローダー
- ビネット + フィルムグレインオーバーレイ
- ユーザーがスクロールを開始するとフェードアウトする下部のスクロールヒント
- 右下のフレームカウンター(例:
073 / 145) - CTAセクションと なる 最終シーン — 個別の
.endセクションはありません
q:v 2 での総重量:フレームあたり約120〜220 KB × フレーム数。6秒24fpsのクリップ = 145フレーム ≈ 25 MB。10秒のクリップ = 241フレーム ≈ 53 MB。
保存場所
デフォルト: ~/Documents/yuv-projects/landings/<slug>/ — 後で見つけられるように、スタンドアロンランディングは常にここに保存してください。ユーザーが明示的に別の場所を指定した場合、またはモードB(既存の examples/parasites/ ショーケースに統合)が選択された場合のみ上書きします。
mkdir -p ~/Documents/yuv-projects/landings
cd ~/Documents/yuv-projects/landings
# フレームを抽出してHTMLを構築する際に、このスキルはここに <slug>/ を作成します。
最終パス(モードA — スタンドアロン):~/Documents/yuv-projects/landings/<slug>/。
最終パス(モードB — 統合):ユーザーが選択した既存のショーケースディレクトリ。
各ビルドの最後にユーザーに最終パスを伝えてください。
ワークフロー
4つのフェーズがあります。フェーズをスキップしないでください。各フェーズが次のフェーズに情報を提供します。
フェーズ1 — 情報収集
ユーザーと確認すること:
- 動画パス — ソースMP4の場所。
- スラッグ — 短いフォルダ/ファイル名(例:
hope、marcus、desk)。1単語、小文字、スペースなし。これはフレームフォルダ名(<slug>/)とHTMLファイル名(<slug>.html)の両方になります。 - テーマ / トピック — このランディングは何についてですか?製品ローンチ?個人的な瞬間?野生動物の出会い?コピーを書くためにこれが必要です。
- プロジェクトモード — スタンドアロン(新しいフォルダ)またはこのリポジトリのトップにある既存の parasites ショーケース
examples/parasites/に統合。ユーザーが「ショーケースに追加」と言ったら、モードBを意味します。 - アクセントカラー — スクリプト/CTAハイライト用:
gold(#f5b042)、amber(#ff8a3d)、accent(ピンク #ff4d6d)、cream(#f5e9d4)、または新しい色(style.cssの:rootに追加し、新しい.script.<name>ルールを記述)。
ユーザーがこれらのいくつかを指定していない場合は、デフォルトを提案して先に進んでください — 結果を見れば答えられる質問で止まらないでください。
フェーズ2 — フレーム抽出
同梱の抽出スクリプトを実行します。ffprobeで動画をプローブし、-q:v 2(ほぼロスレスJPEG)でネイティブ解像度の全フレームを抽出し、frame-001.jpg から frame-NNN.jpg(3桁ゼロ埋め)という名前を付けます。
python <skill>/scripts/extract_frames.py <video_path> <output_folder>
例:
python C:/Users/User/.claude/skills/parallax-landing-page/scripts/extract_frames.py \
C:/Users/User/Documents/parasites/hope/hope.mp4 \
C:/Users/User/Documents/parasites/hope
スクリプトはJSONメタデータブロックをstdoutに出力します。それをキャプチャしてください — HTMLに frame_count と suggested_scroll_budget が必要です。
なぜ -q:v 2 なのか:ezgifなどのツールは積極的に再圧縮します(約55 KB/フレーム)。q:v 2のネイティブffmpegは、同じ寸法で約120〜220 KB/フレームを提供します — はっきりとシャープです。ダウンスケールしないでください。アップスケールも絶対にしないでください(詳細を追加せずにファイルを肥大化させます)。
なぜスクロールバジェットの計算式(フレームあたり約26ピクセル)なのか:クリップの長さ全体で「フレームを1つ進めるのに必要なスクロール量のピクセル数」を一定に保ちます。145フレーム → 約4200、241フレーム → 約6300、90フレーム → 約2500(下限)。スクリプトが自動計算し、[2500, 8000] にクランプします。
フェーズ3 — ページの作成
<skill>/assets/landing-page-template.html のテンプレートを読んでください。これは {{PLACEHOLDER}} マーカーとクリエイティブな部分の隣に <!-- TODO: --> コメントが付いた完全な動作ファイルです。すべてを置換して <target>/<slug>.html に新しいファイルを記述してください。
置換チェックリスト(すべてのプレースホルダーを置換する必要があります):
| プレースホルダー | 何を入れるか | 例 |
|---|---|---|
{{PAGE_TITLE}} | HTML <title> | Hope — The Fastest Heart in the Negev |
{{PAGE_DESCRIPTION}} | meta description、1文 | A moment with Hope, the cheetah of Midbarium. |
{{SLUG}} | フォルダ名(パスなし、スラッシュなし) | hope |
{{FRAME_COUNT}} | フレーム数の整数 | 241 |
{{FRAME_COUNTER_TEXT}} | 幅が合う 001 / NNN | 001 / 241 |
{{SCROLL_BUDGET}} | 抽出JSONからの整数 | 6300 |
{{PREVIEW_FRAME_MID}} | 中央フレーム(ゼロ埋め) | 121 |
{{PREVIEW_FRAME_END}} | 最終フレーム(ゼロ埋め) | 241 |
{{LOADER_TITLE}} | 1単語、大文字 | HOPE |
{{LOADER_SCRIPT}} | 手書き行、… で終わる | summoning the runner… |
{{NAV_LINKS_HTML}} | ナビ用の完全な <a> タグブロック | 下記参照 |
{{SCENE_N_*}} | 5つのシーンそれぞれのキッカー、見出し、手書き行 | コピーガイド参照 |
{{SCROLL_HINT_TEXT}} | 2〜4単語の大文字プロンプト | SCROLL TO RUN |
{{CTA_BUTTONS_HTML}} | 2〜4個の <a class="cta"> タグ | 下記参照 |
{{ACCENT_CLASS}} | .script.X と .cta.X 用のアクセントカラー接尾辞 | amber |
シネマティックなコピーパターン(キッカーの言い回し、見出しの長さ、手書き行のトーン)については、references/copy-guide.md を読んでください。コピーはこのスキルの価値を発揮する部分です — 一般的なコピーでは、どんなに美しいアニメーションも台無しになります。
フェーズ4 — アセットの配線
ターゲットフォルダにすでに style.css と parallax.js がある場合(ショーケース統合)、何もしないでください — それらは共有されています。それ以外の場合は、両方を <skill>/assets/ からターゲットフォルダにコピーします:
cp <skill>/assets/style.css <target>/style.css
cp <skill>/assets/parallax.js <target>/parallax.js
既存のショーケースに統合する場合は、references/showcase-integration.md の手順も実行します — index.html にカードを追加し、既存のすべてのランディングのナビゲーションバーにリンクを追加し、前のランディングの最終シーンにチェーンCTAを追加します。
ユーザーに表示方法を伝えます:
<target>/<slug>.htmlを親フォルダからpython -m http.server 8000で開いてください(file://ではChromiumがローカル画像オリジンでキャンバスを汚染する可能性があります)。
ファイル契約
<target>/
├── <slug>/ # フレームフォルダ
│ ├── <slug>.mp4 # ソース(保持)
│ ├── frame-001.jpg
│ ├── frame-002.jpg
│ └── … frame-NNN.jpg
├── <slug>.html # ランディングページ
├── style.css # 共有(スタンドアロンの場合コピー)
├── parallax.js # 共有(スタンドアロンの場合コピー)
└── index.html # ハブ(スタンドアロンまたは統合の場合のみ)
フレームフォルダ名とHTMLファイル名は同じスラッグを共有する必要があります — ページの new ParallaxPage({folder: '<slug>', ...}) 呼び出しの folder オプションはリテラルフォルダパスです。
ParallaxPage API(すでに parallax.js 内にあり、再定義しないでください)
new ParallaxPage({
folder: '<slug>', // frame-001.jpg などを含むフォルダ
frameCount: 145, // 整数
prefix: 'frame-', // このスキルでは常に 'frame-'
scrollBudget: 4200, // 全パスに必要な累積入力のピクセル数
// オプション: padWidth(デフォルト 3), ext(デフォルト 'jpg')
})
このクラスは自動的に body.scrub-page をアタッチし(CSSでスクロールをロック)、すべてのフレームをプリロードし、スクロールから派生したターゲットフレームに向けてRAF駆動のlerp(0.22倍率)を実行し、data-start/data-end 範囲に現在の進行が含まれるシーンをクロスフェードします。
ハード制約(交渉不可)
これらはリファレンスに組み込まれており、違反すると体験が損なわれます:
- 5つのシーン、固定進行ウィンドウ:
0.00–0.20、0.22–0.40、0.42–0.60、0.62–0.80、0.82–1.00。シーン間の0.02のギャップは意図的なものです — ビートとビートの間で「画像のみ、テキストなし」の瞬間です。ヒーロー(シーン1)と最終(シーン5)はそれぞれdata-fade="0.30"とdata-fade="0.18"を使用してエッジで長く保持します。中央のシーンはデフォルトの0.25を使用します。 - スクラブの下に
.endセクションはありません。最終シーンにCTAが含まれます。ページ全体が1つの固定ビューポートです。 - Anton + Caveat + Inter — 太字には大文字Anton、手書きアクセント(ゴールド/アンバー/クリーム)にはCaveat、本文リードテキストにはInter。決して代用せず、4つ目のフォントを追加しないでください。
- オフホワイト
#f5f1ea、決して#fffではない — CSSでvar(--text)としてすでに設定済み。 - フレーム名は
frame-NNN.jpg、総フレーム数の桁数に合わせてゼロ埋め(1000フレーム未満のクリップでは3桁が標準。JSは合計からカウンター幅を自動計算します)。 - スラッグはフォルダ名かつHTMLファイル名のベース名 —
hope/、hope.html。例外なし。統合手順はこれを前提としています。
行き詰まったときの参照先
- このリポジトリにバンドルされているリファレンスショーケース:
examples/parasites/— github.html、lion.html、hope.html、style.css、parallax.js、index.html。出力がそれらと視覚的に異なる場合は、逸脱しています。再読してください。 references/copy-guide.md— 5つのシーンを実際にシネマティックに感じさせる書き方。references/showcase-integration.md— 既存のハブに追加する場合に必要な正確な編集。assets/landing-page-template.html— プレースホルダー付きの正規構造。assets/hub-template.html— 新しいショーケースをゼロから作成する場合のみ使用(3枚のカード)。
2つの実際の呼び出し例
スタンドアロン: ユーザーが単一のクリップ desk.mp4 を持っており、ランディングページを希望。
- スラッグ + テーマを尋ねる。
desk.mp4に対して抽出を実行 →./desk/frame-NNN.jpg。 style.css+parallax.jsをプロジェクトルートにコピー。- テンプレートから
desk.htmlを作成。ナビには自身へのリンクが1つだけ。 - 完了。
python -m http.serverで提供するようユーザーに伝える。
ショーケース追加: ユーザーが hope.mp4 を既存の parasites フォルダに追加。
- スラッグ =
hope。抽出 →hope/frame-NNN.jpg。(既存の style.css + parallax.js を再利用。) - テンプレートから
hope.htmlを作成。 - ショーケース統合を実行:
index.htmlに3枚目のカードを追加し、github.htmlとlion.htmlのナビゲーションバーにHopeリンクを追加し、前のランディングの最終シーンにNext: Hope →CTAを追加。 - 新しいアクセントカラーを導入する場合は、
:rootに追加し、style.cssに.script.X+.cta.Xルールを追加。