Parallax-Landingpage
Verwandle ein kurzes Video in eine einseitige kinoreife Landingpage, bei der die Scroll-Geste des Nutzers das Video Bild für Bild durchblättert, während fünf dramatische Textszenen ein- und ausblenden. Das Dokument scrollt tatsächlich nie – Rad-/Touch-/Tastatureingaben werden in JS abgefangen und in virtuellen Bildfortschritt umgewandelt.
Dieser Skill kodiert die Muster, die in der gebündelten Referenz unter ../../examples/parasites/ (die GitHub-/Lion-/Hope-Landings – drei funktionierende Seiten, die mit genau diesem Skill erstellt wurden) bewiesen sind. Behandele diesen Ordner als die absolute Wahrheit, falls hier etwas mehrdeutig ist.
Wo dieser Skill in der YUV.AI-Pyramide sitzt
parallax-landing-page befindet sich in der mittleren Ebene der YUV.AI-Skills-Pyramide, zusammen mit yuv-design-system, yuv-decks, yuv-viral-video und video-to-landing-page. Der Top-Orchestrator yuv-pilot leitet hierher weiter, wann immer ein 5–15 s Videoclip zu einer Single-Hero-Scroll-Scrub-Landing werden soll.
Dieser Skill bringt seine eigene visuelle Sprache mit (Anton + Caveat + Inter, Gold/Amber/Akzent/Creme-Akzent-Palette) – er ruft NICHT yuv-design-system auf. Die beiden Systeme koexistieren: yuv-design-system besitzt die Markenpalette auf Web-/App-/Deck-Oberflächen, parallax-landing-page besitzt speziell die kinoreife Scroll-Scrub-Ästhetik. Für YUV.AI-Parallax-Landings kannst du OPTIONAL ein Phoenix-Wasserzeichen + die kanonische Linktree-URL im Footer-Bereich als Markenklammer hinzufügen – siehe yuv-design-system/assets/ für die Wasserzeichendatei. Tausche NICHT den Anton/Caveat-Type-Stack gegen die Neon-Palette des Designsystems aus – das würde den markanten Look verlieren.
Was du baust
Jede Landing ist ein einzelner gesperrter Viewport mit:
- Einer Leinwand, die den Bildschirm ausfüllt und jeweils ein Bild zeichnet (Cover-Fit, DPR ≤ 2)
- 5 absolut positionierten Textszenen (Kicker + großgeschriebene Anton-Schlagzeile + Caveat-Handschriftzeile), jede mit eigenem Scroll-Fortschrittsfenster
- Einer fixierten Navigation mit
PARALLAX // showcase-Logo und Links zu Schwester-Landings - Einem Ladebildschirm, der jedes Bild vorlä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-Bereich ist – kein separater
.end-Abschnitt darunter
Gesamtgewicht bei q:v 2: grob 120–220 KB pro Bild × Bildanzahl. Ein 6-Sekunden-Clip mit 24fps = 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
# Der Skill erstellt hier <slug>/ während er Bilder extrahiert und das HTML baut.
Endgültiger Pfad (Modus A – eigenständig): ~/Documents/yuv-projects/landings/<slug>/.
Endgültiger Pfad (Modus B – integrieren): das bestehende Showcase-Verzeichnis, das der Nutzer gewählt hat.
Teile dem Nutzer am Ende jedes Builds den endgültigen Pfad mit.
Arbeitsablauf
Es gibt vier Phasen. Überspringe keine Phasen – jede speist die nächste.
Phase 1 – Ermitteln
Bestätige mit dem Nutzer:
- Videopfad – wo die MP4-Quelldatei lebt.
- Slug – kurzer Ordner-/Dateiname (z. B.
hope,marcus,desk). Ein Wort, Kleinbuchstaben, keine Leerzeichen. Dies wird sowohl der Bildordnername (<slug>/) als auch der HTML-Dateiname (<slug>.html). - Thema / Thema – worum geht es auf dieser Landing? Ein Produkt-Launch? 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, ist Modus B unten gemeint. - Akzentfarbe – für den Script-/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 mache weiter – bleibe nicht bei Fragen hängen, die sie beantworten können, sobald sie das Ergebnis sehen.
Phase 2 – Bilder extrahieren
Führe das gebündelte Extraktionsskript aus. Es untersucht das Video mit ffprobe und extrahiert jedes Bild in nativer Auflösung mit -q:v 2 (nahezu verlustfreies JPEG) und benennt sie von frame-001.jpg bis frame-NNN.jpg (3-stellige Nullauffüllung).
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 an 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 liefert ~120–220 KB/Bild bei gleichen Abmessungen – sichtbar schärfer. Verkleinere nicht; vergrößere niemals (es bläht die 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 Cliplängen hinweg konstant. 145 Bilder → ~4200, 241 Bilder → ~6300, 90 Bilder → ~2500 (Mindestwert). Das Skript berechnet es für dich und begrenzt es auf [2500, 8000].
Phase 3 – Seite verfassen
Lies die Vorlage unter <skill>/assets/landing-page-template.html. Es ist eine vollständige Arbeitsdatei mit {{PLATZHALTER}}-Markierungen und <!-- TODO: -->-Kommentaren neben kreativen Stellen. Schreibe eine neue Datei unter <ziel>/<slug>.html, in der alles ersetzt ist.
Ersetzungs-Checkliste (jeder Platzhalter muss ersetzt werden):
| Platzhalter | Was einsetzen | Beispiel |
|---|---|---|
{{PAGE_TITLE}} | HTML <title> | Hope – Das schnellste Herz in der Negev |
{{PAGE_DESCRIPTION}} | Meta-Beschreibung, ein Satz | Ein Moment mit Hope, dem Geparden von Midbarium. |
{{SLUG}} | Ordnername (kein Pfad, kein 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}} | Null-aufgefülltes mittleres Bild | 121 |
{{PREVIEW_FRAME_END}} | Null-aufgefülltes letztes Bild | 241 |
{{LOADER_TITLE}} | Ein Wort, Großbuchstaben | HOPE |
{{LOADER_SCRIPT}} | Handschriftzeile endend mit … | den Läufer herbeirufen … |
{{NAV_LINKS_HTML}} | Vollständiger <a>-Tag-Block für Nav | siehe unten |
{{SCENE_N_*}} | Kicker, Schlagzeile, Handschriftzeile für jede der 5 Szenen | siehe Copy-Leitfaden |
{{SCROLL_HINT_TEXT}} | 2–4 Wörter Großbuchstaben-Aufforderung | ZUM LAUFEN SCROLLEN |
{{CTA_BUTTONS_HTML}} | 2–4 `<a class= |