Communitygithub.com

Scroll Narrative

Erzähle eine Geschichte mit dem Scrollen – für Websites, die fesseln statt nur zu informieren.

Was ist Scroll Narrative?

Diese Fähigkeit hilft dir dabei, Webseiten zu gestalten, die eine Geschichte durch Scrollen erzählen – sogenannte Scrollytelling-Seiten. Statt langweiliger Feature-Blöcke wird der Inhalt wie ein narratives Erlebnis aufgebaut, bei dem der Besucher durch verschiedene Kapitel geführt wird. Die Fähigkeit eignet sich besonders für Brand-Seiten, kleine Unternehmen, Reiseberichte, Services mit sichtbaren Ergebnissen oder Portfolio-Seiten. Sie unterstützt sowohl vollständige narrative Seiten als auch einzelne Szenen, z. B. ein „So funktioniert es“ für SaaS-Produkte. Die Implementierung nutzt die bereitgestellten CSS- und JavaScript-Assets (`storymotion.css` und `storymotion.js`) sowie Rezepte aus der `web-motion`-Fähigkeit. Entscheidend ist der Aufbau einer Gliederung (Beats) mit festgelegten Headlines, Texten, Fakten, visuellen Elementen und Bewegungen, wobei jedes Beat eine klare Rolle hat. Die Fähigkeit betont klares Storytelling, starke Bilder, sinnvolle Pacing-Regeln und mobile Optimierung. Ziel ist es, eine fesselnde, barrierefreie und responsive Seite zu erstellen, die den Besucher emotional abholt und zu einer Aktion führt.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YehorSS/storymotion/tree/main/skills/scroll-narrative

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Scroll Narrative?

Nicht jede Seite braucht eine Geschichte. Entscheide zuerst: eine vollständige Erzählung (Marken, kleine Unternehmen, Reisen, Orte, Handwerk, Dienstleistungen mit sichtbaren Ergebnissen), eine einzelne Story-Szene (SaaS, Apps: meistens „So funktioniert es“) oder keine (Shops, Dokumentationen, Dashboards, Formulare: Bewegung nur für Feedback, verwende ausschließlich web-motion). Für teilweise wende diese Fähigkeit nur auf diese eine Szene an.

Eine narrative Seite ist eine Geschichte, die der Besucher mit dem Scrollrad durchläuft. Fakten werden in die Handlung eingewoben, nicht als Feature-Blöcke gestapelt. Bewegung (siehe die web-motion-Fähigkeit) ist das Vergehen der Zeit in dieser Geschichte.

1. Finde die Geschichte vor dem Code

Beantworte jede Frage in einem Satz:

  • Held – wer oder was wir begleiten (der Besucher, das Produkt, ein Ort, ein Gericht, ein Tag).
  • Wunsch – was sie/er/es will oder wohin es geht.
  • Hindernis – was im Weg steht (das Problem, das das Produkt löst).
  • Wendepunkt – der Moment, der alles verändert (das Produkt, der Gipfel, der erste Bissen).
  • Danach – die Welt nach dem Wendepunkt und die eine Aktion, die der Besucher nun ausführt.

Wähle dann ein narratives Mittel, das den gesamten Scrollaufbau strukturiert:

MittelScrollen bedeutetGeeignet für
ZeitachseMorgengrauen → Nacht, 1920 → heute, Tag 1 → Tag 30Restaurants, Veranstaltungen, Geschichte, Routinen
WegBewegung entlang einer Route oder KarteReisen, Logistik, Expeditionen, Immobilien
ZoomStadt → Straße → Raum → DetailArchitektur, Produkte, Handwerk
TransformationRoh → fertig, vorher → nachherDienstleistungen, Renovierung, SaaS, Fitness
Countdownauf einen Start oder einen Höhepunkt zuFestivals, Drops, Veröffentlichungen
FigurDem Tag einer Person folgenApps, B2C-Dienstleistungen

2. Schreibe das Beat-Sheet

Speichere es als beats.md vor dem Bau. Eine Zeile pro Beat:

#BeatÜberschrift (≤ 8 Wörter)Text (≤ 40 Wörter)Eingewobener FaktVisuellBewegungScrolling-Länge

Standardbogen (6–9 Beats):

  1. Aufhänger – der erste Bildschirm. In 3 Sekunden: worum es geht, die Schlüsselzahl, die Hauptaktion. Kein „Scrollen Sie nach unten, um mehr zu entdecken“ ohne etwas anderes.
  2. Aufbau – die Welt davor; der Held und der Wunsch.
  3. Reise (2–4 Beats) – Fortschritt durch das Mittel; jeder Beat trägt einen Fakt als Handlungspunkt („um 6 Uhr morgens ist das Brot bereits draußen – 140 Laibe“).
  4. Wendepunkt – die größte Szene: normalerweise eine gepinnte Bühne (200–300 vh), die durch Scrollen gesteuert wird.
  5. Beweis – Zahlen, Gesichter, Bewertungen, erzählt als Ergebnis der Geschichte.
  6. Auflösung + CTA – wo die Geschichte landet, und eine klare Aktion. Wiederhole die Aktion des Aufhängers.

3. Pacing-Regeln

  • Eine Idee, ein visuelles Element, eine Bewegung pro Beat.
  • Wechsle zwischen dicht und sparsam: nach einer gepinnten Szene ein ruhiges, randloses Foto oder ein einzelner Satz.
  • Maximal ~3 gepinnte Szenen pro Seite; jede Pin muss ihre Scroll-Länge verdienen.
  • Gesamtseite: 6–12 Viewport-Höhen auf dem Desktop. Länger nur, wenn jeder Bildschirm noch Neuigkeiten bietet.
  • Text erscheint mit dem Moment, den er beschreibt, niemals vorher.
  • Der Besucher weiß immer, wo er ist: Kapitelbezeichnung + Fortschrittsanzeige.
  • Das Scrollen selbst spricht die Geschichte: Die Anzeige verwendet das narrative Mittel als Metapher (Stunde, km, Maßstab, Jahr, Kapitelnummer) und die Farbpalette und Schriftart der Seite; Kapitel sind darauf markiert und werden beim Darüberfahren benannt.

4. Inhalt und Handwerk

  • Fotos sind die Hauptfigur: nur hohe Auflösung, scharf bei 100 % Zuschnitt; reaktionsfähiges srcset.
  • Schreibe wie ein Mensch, klare Worte; kein „entfesseln“, „erheben“, „nahtlos“.
  • Zahlen sind Handlungspunkte, kein Statistikraster – es sei denn, das Raster ist der Höhepunkt.
  • Jedes Beat muss ohne Bewegung und ohne JS überleben: Es liest sich immer noch als gute lange Seite.
  • Mobil ist kein geschrumpfter Desktop: kürzere Pins (150–200 vh), gestapelte Bühne, größere Schrift.

5. Bauen

  1. Baue auf storymotion.css + storymotion.js (in web-motion/assets/; gepinnte Szenen mit --p, Schrittbeschriftungen, Enthüllungen, Counter, Kapitelbezeichnung, ziehbare Scrollanzeige, Ladeanimation, Sprachen, reduzierte Bewegung) und den Rezepten in web-motion/references/recipes.md.
  2. Ordne jedes Beat einem Abschnitt zu; gepinnte Beats werden zu .scene > .stage mit [data-step]-Beschriftungen; benutzerdefinierte Logik pro Frame hört auf das progress-Ereignis der Szene.
  3. Füge Bewegung gemäß web-motion hinzu; überprüfe bei 375 px und 1440 px mit reduzierter Bewegung ein- und ausgeschaltet.

Checkliste vor Fertigstellung:

  • Aufhänger besteht den 3-Sekunden-Test.
  • Jedes Beat hat genau eine Aufgabe und einen Fakt.
  • Die Geschichte liest sich in der richtigen Reihenfolge, auch wenn JS deaktiviert ist.
  • Kapitelbezeichnung und Anzeige stimmen mit dem Beat-Sheet überein.
  • Der CTA am Ende wiederholt die Aktion des Aufhängers.

Verwandte Skills