Communitygithub.com

Cinematic-Scroll-Web

Entwirft und baut fortlaufende, scroll-gekoppelte interaktive Web-Erlebnisse – darunter kinematografische Storytelling-Seiten, interaktive Manga/Redaktionsgrafiken sowie scrollgesteuerte Produktpräsentationen oder Conversion-starke E-Commerce-Landingpages – unter Verwendung eines haftenden SVG/CSS-Viewports, Spring-Lerp-Scroll-Physik, reaktiver SVG-Filter und einer choreografierten 6-Stufen-Schiene.

Was ist Cinematic-Scroll-Web?

Dieses Skill ermöglicht es einem KI-Agenten, Scroll-Webseiten zu erstellen, bei denen alle visuellen Layer – Kamerazoom, SVG-Morphing, Partikelstreuung, Windphysik sowie narrativer und Verkaufstext – über eine einzige normalisierte Scroll-Koordinate (Position im Bereich [0, 1]) gesteuert werden. Es eignet sich besonders für kinematografische Geschichten, interaktive Manga-Sequenzen, Luxus-Produkt-Launches, Explosionsansichten oder Endlos-Single-Page-Verkaufsseiten. Die Architektur basiert auf einer vierlagigen, klebrigen Bühne innerhalb einer hohen Scroll-Spur: #sky für die Stimmung, #world für die Heldenzentrale, #rail für die Kapitel und #texture für Head-up-Displays. Die Implementierung nutzt Spring-Lerp-Physik, smoothstep-Animationen und eine choreografierte 6-Stufen-Bogen-Struktur, um fließende Übergänge ohne Ruckeln zu gewährleisten. Der Skill unterstützt sowohl Storytelling/Manga als auch E-Commerce-Domänen und liefert Referenzdokumente wie die Physik- und SVG-Engine sowie einen E-Commerce-Anpassungsleitfaden. Wichtige Fallstricke – wie CSS-Überschreibungen von SVG-Attributen und falsche Transform-Ursprünge – werden ausdrücklich behandelt.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TuanAnhPhan-pika/cinematic-scroll-skill/tree/main/cinematic-scroll-web

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Skill für kinematografisches Scroll-gekoppeltes Web

Erstellen Sie abhängigkeitsfreie, interaktive Web-Erlebnisse mit 60 Bildern pro Sekunde und kontinuierlichem Scrollen, bei denen jede visuelle Ebene – Kamerazoom, SVG-Morphing, Partikelstreuung, Windphysik sowie narrative und Verkaufstexte – eine einzige normalisierte Scroll-Koordinate (position in [0, 1]) gemeinsam nutzt.

Architekturüberblick

Jede Seite folgt einer vierlagigen, klebrigen Bühne innerhalb einer hohen Scroll-Spur:

#track (Höhe: 700vh, erzeugt natürliche Scroll-Distanz)
└── #viewport (position: sticky; top: 0; height: 100vh; overflow: hidden)
    ├── #sky / ambient background layers (Farbe & Stimmungsinterpolation)
    ├── #world (isolierte Bühne: Heldenmittelstück, SVG-Filter, Partikel, Atmosphäre)
    ├── #rail (position: absolute; N gestapelte 100vh-Kapitel, kontinuierlich verschoben)
    └── #texture / HUD (#bar, #meter, #guide, sticky CTA-Leiste für E-Commerce)
  • Schalten Sie niemals diskrete Folien nur mit Klassen um. Treiben Sie #rail über translate3d(0, ${-position * (N - 1) * innerHeight}px, 0) und interpolieren Sie alle Szenenübergänge mit smoothstep (smooth(a, b, position)).
  • Halten Sie #world und #rail nicht blockierend (pointer-events: none) – außer auf expliziten interaktiven Elementen (#overlay button, Variantenmuster, Kauf/Warenkorb-CTA), die pointer-events: auto und einen höheren z-index setzen müssen.

Aufbau-Workflow

  1. Wählen Sie den Domain-Modus:
  2. Entwerfen Sie das geschichtete Helden-SVG:
    • Bauen Sie das Heldenmittelstück (Charakter, Emblem oder Produkthardware) in einem einzigen normalisierten viewBox mit benannten <g>-Ebenen, damit einzelne Teile unabhängig rotieren, auseinanderfliegen, zoomen oder die Farbgebung wechseln können.
  3. Verdrahten Sie die Spring-Lerp-Schleife (requestAnimationFrame):
    • Berechnen Sie target = clamp(-track.getBoundingClientRect().top / maxScroll, 0, 1).
    • Gleichen Sie position += (target - position) * 0.115 aus und leiten Sie geglättete speed und begrenzte impulse (wind) ab, sodass schnelles Scrollen auf natürliche Weise Stoff, Haare, Partikel und SVG-Verschiebungsfilter antreibt.
  4. Choreografieren Sie den 6-Stufen-Bogen:
    • Ordnen Sie 0.00 -> 1.00 über 6 gleichmäßig verteilte .chapter-Abschnitte mit 100vh (top: 0 bis top: 500vh) zu.
    • Kombinieren Sie progressiven Zoom (scale) und Ebenenüberblendungen (smooth(a, b, position)) mit prägnanten .caption-Karten und einem oberen #bar + #meter-HUD.
  5. Überprüfen Sie vor der Auslieferung:
    • Stellen Sie die Seite über lokales HTTP bereit und testen Sie die Scroll-Positionen 00%, 25%, 50%, 75% und 100%.
    • Bestätigen Sie, dass interaktive Overlays (#enter), Variantenauswahlen und sticky CTAs anklickbar bleiben (pointer-events: auto).
    • Bestätigen Sie null Konsolenfehler, lesbaren Textkontrast über hellen Fokuselementen und saubere Darstellung sowohl auf Desktop (1280x800) als auch auf Mobilgeräten (390x844).

Kritische SVG- & CSS-Fallstricke

Vermeiden Sie diese häufigen Fehlermodi beim Erstellen SVG-lastiger Scroll-Seiten:

  1. CSS #id { opacity: 0 } blockiert setAttribute('opacity', …): ID-Selektoren in CSS überschreiben SVG-Präsentationsattribute. Lassen Sie entweder opacity: 0 in CSS weg (verwenden Sie anfangs das SVG-Attribut opacity="0" + setAttribute('opacity', …)) oder aktualisieren Sie el.style.opacity in JavaScript.
  2. SVG transform-Attribute ignorieren CSS transform-origin: transform-box: fill-box; transform-origin: … gilt nur für CSS el.style.transform. Verwenden Sie für SVG setAttribute('transform', …) explizit um das Zentrum (cx, cy) gewickelte Rotationen/Skalierungen: translate(cx cy) rotate(deg) scale(s) translate(-cx -cy).
  3. Verwenden Sie kubische Bézier-Kurven (C) anstelle von spitzen Keilen: Vermeiden Sie für organische Haare, Bänder, Stoffe, Rauch oder Flüssigkeitsspuren dreieckige L-Spitzen und große CSS-skewX-Verzerrungen. Animieren Sie kubische Bézier-Kontrollpunkte sanft mit Sinuswellen-Offsets entlang der phase und begrenztem wind.
  4. Fixieren Sie das Seitenverhältnis des Helden-Wrappers auf viewBox: Geben Sie dem Helden-SVG-Container aspect-ratio: <B>/<H>; height: auto; (anstatt unabhängige vw- und vh-Abmessungen zu mischen), damit die Zoom-Koordinaten von transform-origin auf allen Bildschirmgrößen auf dem Ziel fixiert bleiben.
  5. Verhindern Sie atmosphärische Nähte in der Bildschirmmitte: Schließen Sie mittige Nebel/Dunst-<path>-Formen nicht entlang einer flachen horizontalen Linie (L1440 490 … Z) mit einem sichtbaren Strich. Verwenden Sie stroke: none und schließen Sie Wolkenbänder sanft unterhalb des Viewports oder mit wellenförmigen unteren Kurven.
  6. Schützen Sie den Textkontrast über leuchtenden Fokusbereichen: Verwenden Sie mehrschichtige dunkle Schlagschatten (text-shadow) auf großen Überschrift-Titeln und dunkle transluzente Karten (backdrop-filter: blur(4px)) für Bildunterschriften, damit der Text auch beim Überfahren heller Monde, Glüheffekte oder metallischer Produkthighlights lesbar bleibt.

Referenzen & Beispiele

  • Physik & SVG-Engine — Spring-Lerp-Mathematik, smooth(), reaktive SVG-Filter, konzentrische Rotationen, wandernde Bézier-Wellen und Partikelstreuformeln.
  • E-Commerce-Anpassungsleitfaden — Anpassung des 6-Kapitel-Bogens für Produkt-Launches, Explosionsansichten, Farbwechsel, Spezifikationshinweise und sticky Kauf-Leisten.
  • Starter-Vorlage — Sauberes 6-Stufen-Kontinuierlich-Scroll-Gerüst, bereit für jedes Theme.
  • E-Commerce-Produktpräsentation — Voll funktionsfähige Demo eines Luxus-Zeitmessers / Hardware-Produkt-Launches, erstellt mit dieser Engine.

Verwandte Skills