Was macht Parallax-Landing-Page?
Verwandle ein kurzes Video in eine einbildschirmige kinematografische Landing-Page, bei der der Scroll-Gesture des Nutzers Bild für Bild durch das Video blättert, während fünf dramatische Text-Szenen ein- und ausblenden. Das Dokument scrollt nie wirklich – Rad-, Touch- und Tastatureingaben werden in JavaScript abgefangen und in einen virtuellen Bildfortschritt umgewandelt.
Dieses Skill kodiert die Muster, die in der beigefügten Referenz unter ../../examples/parasites/ bewiesen wurden (die Github-/Lion-/Hope-Landings – drei funktionierende Seiten, die mit genau diesem Skill erstellt wurden). Behandle diesen Ordner als die absolute Wahrheit, falls etwas hier mehrdeutig ist.
Wo dieses Skill in der YUV.AI-Pyramide sitzt
parallax-landing-page befindet sich in der mittleren Ebene der YUV.AI-Skills-Pyramide, neben yuv-design-system, yuv-decks, yuv-viral-video und video-to-landing-page. Der Top-Level-Orchestrator yuv-pilot leitet hierher weiter, sobald ein 5–15 s Videoclip zu einer einzelnen Hero-ScrollScrub-Landing werden soll.
Dieses Skill bringt seine eigene visuelle Sprache mit (Anton + Caveat + Inter, Gold/Amber/Akzent/Creme-Palette) – es ruft NICHT yuv-design-system auf. Die beiden Systeme koexistieren: yuv-design-system besitzt die Markenpalette über Web/App/Deck-Oberflächen, parallax-landing-page besitzt die kinematografische ScrollScrub-Ästhetik speziell. Für YUV.AI-Parallax-Landings kannst du OPTIONAL ein Phönix-Wasserzeichen + die kanonische Linktree-URL im Footer-Bereich als Markenanker hinzufügen – siehe yuv-design-system/assets/ für die Wasserzeichen-Datei. Ersetze NICHT den Anton/Caveat-Schriftstapel durch die Neon-Palette des Designsystems – das würde den unverwechselbaren Look zerstören.
Was du baust
Jede Landing ist ein einziger fixierter Viewport mit:
- Einer Canvas, die den Bildschirm ausfüllt und jeweils ein Bild zeichnet (Cover-Fit, DPR ≤ 2)
- 5 absolut positionierten Text-Szenen (Kicker + Großbuchstaben Anton-Headline + Caveat-Handschriftzeile), jede mit eigenem Scroll-Progress-Fenster
- Einer fixen Navigation mit
PARALLAX // showcase-Logo und Links zu benachbarten Landings - Einem Ladebildschirm, der jedes Bild vorglädt, bevor der Nutzer interagieren kann
- Einer Vignette + Filmkorn-Überlagerung
- Einem unteren Scroll-Hinweis, der ausgeblendet wird, sobald der Nutzer zu scrollen beginnt
- Einem Bildzähler unten rechts (z. B.
073 / 145) - Einer letzten Szene, die der CTA-Abschnitt ist – kein separater
.end-Abschnitt darunter
Gesamtgewicht bei q:v 2: ca. 120–220 KB pro Bild × Bildanzahl. Ein 6-Sekunden-Clip mit 24 fps = 145 Bilder ≈ 25 MB. Ein 10-Sekunden-Clip = 241 Bilder ≈ 53 MB.
Speicherort
Standard: ~/Documents/yuv-projects/landings/<slug>/ – speichere eigenständige Landings immer hier, damit du sie wiederfindest. Überschreibe nur, wenn der Nutzer explizit einen anderen Ort wählt ODER wenn Modus B (Integration in die bestehende examples/parasites/-Showcase) ausgewählt ist.
mkdir -p ~/Documents/yuv-projects/landings
cd ~/Documents/yuv-projects/landings
# Das Skill erstellt <slug>/ hier, während es Bilder extrahiert und das HTML baut.
Endgültiger Pfad (Modus A – eigenständig): ~/Documents/yuv-projects/landings/<slug>/.
Endgültiger Pfad (Modus B – Integration): das vorhandene Showcase-Verzeichnis, das der Nutzer gewählt hat.
Teile dem Nutzer den endgültigen Pfad am Ende jedes Builds mit.
Arbeitsablauf
Es gibt vier Phasen. Überspringe keine Phasen – jede speist sich aus der vorherigen.
Phase 1 – Erkunden
Bestätige mit dem Nutzer:
- Videopfad – wo die Quell-MP4 liegt.
- Slug – kurzer Ordner-/Dateiname (z. B.
hope,marcus,desk). Ein Wort, kleingeschrieben, keine Leerzeichen. Dies wird sowohl der Bildordnername (<slug>/) als auch der HTML-Dateiname (<slug>.html). - Thema / Topic – worum geht es auf dieser Landing? Eine Produkteinführung? Ein persönlicher Moment? Eine Tierbegegnung? Du brauchst dies, um den Text zu schreiben.
- Projektmodus – eigenständig (brandneuer Ordner) oder Integration in die bestehende Parasiten-Showcase unter
examples/parasites/(oben in diesem Repo). Wenn der Nutzer „Füge es zur Showcase hinzu“ sagt, meint er Modus B unten. - Akzentfarbe – für den Skript-/CTA-Highlight:
gold(#f5b042),amber(#ff8a3d),accent(pink #ff4d6d),cream(#f5e9d4) oder etwas Neues (füge es zu:rootin style.css hinzu und schreibe eine neue.script.<name>-Regel).
Wenn der Nutzer einige davon nicht angegeben hat, schlage Standardwerte vor und mach weiter – bleibe nicht bei Fragen hängen, die er beantworten kann, sobald er das Ergebnis sieht.
Phase 2 – Bilder extrahieren
Führe das beiliegende Extraktionsskript aus. Es prüft das Video mit ffprobe und extrahiert jedes Bild in nativer Auflösung mit -q:v 2 (nahezu verlustfreies JPEG), benannt als frame-001.jpg bis frame-NNN.jpg (3-stellig, nullaufgefüllt).
python <skill>/scripts/extract_frames.py <video_path> <output_folder>
Beispiel:
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
Das Skript gibt einen JSON-Metadatenblock auf stdout aus. Erfasse ihn – du benötigst frame_count und suggested_scroll_budget für das HTML.
Warum -q:v 2: ezgif und ähnliche Tools komprimieren aggressiv (~55 KB/Bild). Natives ffmpeg mit q:v 2 ergibt ~120–220 KB/Bild bei denselben Abmessungen – deutlich schärfer. Downskaliere nicht; skaliere niemals hoch (es bläht Dateien auf, ohne Details hinzuzufügen).
Warum die Scroll-Budget-Formel (≈26 px pro Bild): hält das taktile „Pixel Scroll pro vorgerücktem Bild“ über alle Cliplängen konstant. 145 Bilder → ~4200, 241 Bilder → ~6300, 90 Bilder → ~2500 (Minimum). Das Skript berechnet es für dich und begrenzt es auf [2500, 8000].
Phase 3 – Die Seite verfassen
Lies die Vorlage unter <skill>/assets/landing-page-template.html. Es ist eine vollständig funktionsfähige Datei mit {{PLACEHOLDER}}-Markierungen und <!-- TODO: -->-Kommentaren neben kreativen Teilen. Schreibe eine neue Datei unter <target>/<slug>.html mit allen Ersetzungen.
Ersetzungscheckliste (jeder Platzhalter muss ersetzt werden):
| Platzhalter | Was einfügen | Beispiel |
|---|---|---|
{{PAGE_TITLE}} | HTML <title> | Hope — The Fastest Heart in the Negev |
{{PAGE_DESCRIPTION}} | Meta-Beschreibung, ein Satz | A moment with Hope, the cheetah of Midbarium. |
{{SLUG}} | Ordnername (ohne Pfad, ohne Schrägstrich) | hope |
{{FRAME_COUNT}} | Ganzzahl Bildanzahl | 241 |
{{FRAME_COUNTER_TEXT}} | 001 / NNN mit passender Breite | 001 / 241 |
{{SCROLL_BUDGET}} | Ganzzahl aus dem Extraktor-JSON | 6300 |
{{PREVIEW_FRAME_MID}} | nullaufgefülltes mittleres Bild | 121 |
{{PREVIEW_FRAME_END}} | nullaufgefülltes letztes Bild | 241 |
{{LOADER_TITLE}} | ein Wort, Großbuchstaben | HOPE |
{{LOADER_SCRIPT}} | handschriftliche Zeile endend mit … | summoning the runner… |
{{NAV_LINKS_HTML}} | vollständiger <a>-Tag-Block für Navigation | siehe unten |
{{SCENE_N_*}} | Kicker, Headline, Handschriftzeile für jede der 5 Szenen | siehe Kopieranleitung |
{{SCROLL_HINT_TEXT}} | 2–4 Wörter in Großbuchstaben | SCROLL TO RUN |
{{CTA_BUTTONS_HTML}} | 2–4 <a class="cta">-Tags | siehe unten |
{{ACCENT_CLASS}} | Akzentfarbe-Suffix für .script.X und .cta.X | amber |
Lies references/copy-guide.md für die kinematografischen Textmuster (Kicker-Formulierung, Headline-Länge, Handschriftzeilen-Ton). Der Text ist der Bereich, in dem dieses Skill seinen Wert beweist – generischer Text wird eine ansonsten schöne Animation ruinieren.
Phase 4 – Assets verdrahten
Wenn der Zielordner bereits style.css und parallax.js hat (Showcase-Integration), tue nichts – sie werden gemeinsam genutzt. Kopiere andernfalls beide aus <skill>/assets/ in den Zielordner:
cp <skill>/assets/style.css <target>/style.css
cp <skill>/assets/parallax.js <target>/parallax.js
Bei Integration in eine bestehende Showcase führe außerdem die Schritte in references/showcase-integration.md durch – füge eine Karte zu index.html hinzu, füge einen Link zu jeder vorhandenen Landing-Navigationsleiste hinzu und füge den Ketten-CTA auf der letzten Szene der vorherigen Landing hinzu.
Teile dem Nutzer mit, wie er anzeigen kann:
Öffne
<target>/<slug>.htmlviapython -m http.server 8000vom übergeordneten Ordner (nichtfile://– Chromium kann die Canvas mit lokalen Bildquellen verfälschen).
Dateivertrag
<target>/
├── <slug>/ # Bildordner
│ ├── <slug>.mp4 # die Quelle (erhalten)
│ ├── frame-001.jpg
│ ├── frame-002.jpg
│ └── … frame-NNN.jpg
├── <slug>.html # die Landing-Page
├── style.css # gemeinsam genutzt (kopieren, wenn eigenständig)
├── parallax.js # gemeinsam genutzt (kopieren, wenn eigenständig)
└── index.html # der Hub (nur wenn eigenständig oder Integration)
Der Bildordnername und der HTML-Dateiname MÜSSEN denselben Slug verwenden – die folder-Option im new ParallaxPage({folder: '<slug>', ...})-Aufruf ist der wörtliche Ordnerpfad.
Die ParallaxPage-API (bereits in parallax.js, nicht neu definieren)
new ParallaxPage({
folder: '<slug>', // Ordner mit frame-001.jpg usw.
frameCount: 145, // Ganzzahl
prefix: 'frame-', // immer 'frame-' für dieses Skill
scrollBudget: 4200, // Pixel akkumulierter Eingabe für einen vollständigen Durchlauf
// optional: padWidth (Standard 3), ext (Standard 'jpg')
})
Die Klasse hängt automatisch body.scrub-page an (was Scrollen per CSS sperrt), lädt alle Bilder vor, führt einen RAF-gesteuerten Lerp (Faktor 0,22) in Richtung des scrollabgeleiteten Zielbildes aus und blendet Szenen ein/aus, deren data-start/data-end-Bereiche den aktuellen Fortschritt enthalten.
Harte Einschränkungen (die nicht verhandelbar sind)
Diese sind in der Referenz eingebaut und zerstören das Erlebnis, wenn sie verletzt werden:
- 5 Szenen, feste Fortschrittsfenster:
0,00–0,20,0,22–0,40,0,42–0,60,0,62–0,80,0,82–1,00. Die 0,02-Lücke zwischen den Szenen ist beabsichtigt – sie ist ein Moment von „nur das Bild, kein Text“ zwischen den Beats. Der Held (Szene 1) und die letzte (Szene 5) verwendendata-fade="0,30"bzw.data-fade="0,18", damit sie länger an den Rändern halten; mittlere Szenen verwenden den Standardwert 0,25. - Kein
.end-Abschnitt unter dem Scrub. Die letzte Szene enthält die CTAs. Die ganze Seite ist ein einziger fixierter Viewport. - Anton + Caveat + Inter – Anton in Großbuchstaben für alles Fette, Caveat für handschriftliche Akzente (Gold/Amber/Creme), Inter für jeglichen Fließtext. Niemals ersetzen, niemals eine vierte Schriftart hinzufügen.
- Off-White
#f5f1ea, niemals#fff– bereits im CSS alsvar(--text). - Bildnamen sind
frame-NNN.jpgnullaufgefüllt auf die Breite der Gesamtzahl (3 Stellen ist der Standard, da Clips < 1000 Bilder; das JS berechnet die Zählerbreite automatisch aus der Gesamtzahl). - Der Slug ist der Ordnername UND der HTML-Dateiname-Basename –
hope/,hope.html. Keine Ausnahmen; die Integrationsschritte setzen dies voraus.
Wo du nachschauen kannst, wenn du nicht weiterkommst
- Die beigefügte Referenz-Showcase in diesem Repo:
examples/parasites/– github.html, lion.html, hope.html, style.css, parallax.js, index.html. Wenn dein Ergebnis sichtbar von diesen abweicht, bist du abgedriftet; lies noch einmal. references/copy-guide.md– wie die 5 Szenen geschrieben werden, damit sie sich tatsächlich kinematografisch anfühlen.references/showcase-integration.md– genaue Bearbeitungen, die beim Hinzufügen zu einem bestehenden Hub erforderlich sind.assets/landing-page-template.html– die kanonische Struktur mit Platzhaltern.assets/hub-template.html– wird nur verwendet, wenn eine brandneue Showcase erstellt wird (3 Karten von Grund auf).
Zwei reale Beispielaufrufe
Eigenständig: Der Nutzer hat einen einzelnen Clip desk.mp4 und möchte eine Landing-Page.
- Frage nach Slug + Thema. Führe Extraktor auf
desk.mp4aus →./desk/frame-NNN.jpg. - Kopiere
style.css+parallax.jsin das Projektverzeichnis. - Verfasse
desk.htmlaus der Vorlage. Navigation hat nur einen Link: sich selbst. - Fertig. Sage dem Nutzer, er solle mit
python -m http.serverausliefern.
Showcase hinzufügen: Der Nutzer fügt hope.mp4 zum vorhandenen Parasiten-Ordner hinzu.
- Slug =
hope. Extraktion →hope/frame-NNN.jpg. (Wiederverwende vorhandenes style.css + parallax.js.) - Verfasse
hope.htmlaus der Vorlage. - Führe Showcase-Integration durch: füge eine dritte Karte zu
index.htmlhinzu, hänge einenHope-Link an die Navigationsleiste ingithub.htmlundlion.htmlan, verlinke die letzte Szene der vorherigen Landing mit einemNext: Hope →-CTA. - Wenn eine neue Akzentfarbe eingeführt wird, füge sie zu
:rootund füge.script.X+.cta.X-Regeln instyle.csshinzu.