Communitygithub.com

interaktives-storyboard

Verwandle ein fertiges Storyboard in eine **interaktive visuelle Geschichte**: eine Webseite, auf der der Betrachter die Geschichte durch Klicken, Halten und Ziehen auf den Zeichnungen selbst voranbewegt – mit Ton, Untertiteln/Dialogen und Übergängen, die den Rhythmus des Films respektieren.

Was ist interaktives-storyboard?

Diese Fähigkeit wandelt ein fertiges Storyboard (PDF oder Bilder) in eine einzige, interaktive HTML-Seite um, die durch Berührungsgesten, synthetisierte oder aufgenommene Töne, ein wählbares Aussehen und mehrsprachigen Text gesteuert wird. Entwickelt für Nutzer, die bereits mit Storyboards vertraut sind (Bretter, Einstellungen, Slugs, Notizen), ist es kein Animatic-Generator. Die Fähigkeit unterstützt die Arbeit mit Claude Code, Cursor und Codex. Sie folgt einem strengen Workflow: Zuerst wird das Storyboard analysiert (Bretter extrahieren, Beat-Liste erstellen), dann werden die Einstellungen vor Effekten optimiert (lange Takes zusammenführen, Kamerafahrten berechnen), bevor das Aussehen nach einem der vorgegebenen Stile (Film/Riso, amerikanischer Comic, Pixel) festgelegt wird. Die Interaktion ist gestenbasiert: Jede Geste entspricht einer Handlung der Geschichte. Die Ausgabe ist eine einzelne HTML-Datei mit einem Canvas, einer Szenen-Zustandsmaschine, Sound, mehrsprachigem Text und einem Testskript. Die Fähigkeit betont die Wahrung des ursprünglichen Strichzeichnungsstils des Nutzers und die enge Abstimmung mit dem Nutzer bei Schlüsselentscheidungen, wobei Standardwerte für den Rest angenommen werden.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/beiabei10/interactive-storyboard/tree/HEAD/interactive-storyboard

In Ihrer bevorzugten KI fragen

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

Dokumentation

Interaktives Storyboard

Verwandle ein fertiges Storyboard in eine interaktive visuelle Geschichte: eine Webseite, auf der der Betrachter die Geschichte durch Klicken, Halten und Ziehen auf den Zeichnungen selbst voranbewegt – mit Ton, Untertiteln/Dialogen und Übergängen, die den Rhythmus des Films respektieren. Sie ist für Leute, die bereits wissen, was ein Storyboard ist (Bretter, Einstellungen, Slugs, Notizen); sie ist kein Animatic-Generator.

Beispielfälle des Autors dieser Fähigkeit, Ding Yilin: The Joy of the White Room und Fahrenheit 451 (Szenen 1, 8, 9) – siehe examples/; probiere sie live aus: The Joy of the White Room, Fahrenheit 451, Szenen 1 → 8 → 9.

0. Vor dem Bauen fragen (eine Runde, dann los)

Frage nur, was den Bau verändert; übernimm sinnvolle Standardwerte für den Rest und nenne sie.

  1. Welche Szenen / Bretter (ein langes Storyboard: pilotiere zuerst eine Szene, dann mache die anderen auf die gleiche Weise).
  2. Aussehen: eines der folgenden Voreinstellungen oder „meine Zeichnungen so lassen, wie sie sind”.
  3. Text: nur Dialog / Erzählung / beides / keins. Verwende die eigenen Zeilen des Storyboards; erfinde niemals Dialog oder Erzählung.
  4. Ton: die Aufnahmen des Nutzers (frage nach den Dateien und welchem Brett jede zugehört) oder synthetisierter Ton.
  5. Sprachen: frage immer, welche Sprachen das Stück benötigt; es gibt keine Standardeinstellung. Baue nur diese. Jeder Bildschirmtext (Titel, Slugs, Hinweise, Sprechblasen, Credits) lebt in einer sprachspezifischen Tabelle und ist live umschaltbar; bei mehr als einer Sprache kann die Startsprache einer Host-Seite folgen (?lang=, eine postMessage oder <html lang>). Übersetzungen, die du erstellst, sind Entwürfe, die der Nutzer überprüfen sollte.
  6. Wo es leben wird: nur eine teilbare Seite, oder auch eingebettet in die eigene Webseite des Nutzers (dann frage nach dem Seitenpaket und bearbeite deren Kopie).
  7. Credit-Zeile: verwende genau den Wortlaut, den der Nutzer angibt (z.B. „Erstellt von …”); füge keine Rollen hinzu, die sie nicht aufgelistet haben.

1. Das Storyboard lesen

  • Storyboarder / PDF-Exporte: pdfimages -png gibt jedes Brett in voller Größe inklusive des NOTIZ-Bereichs aus; finde den Zeichenrahmen einmal (scanne Zeilen/Spalten nach den Rahmenlinien) und beschneide jedes Brett auf die gleiche Weise auf den Zeichenbereich (behalte ein 16:9-Fenster bei, wenn die Bühne 16:9 ist). Rendere die Seiten mit pdftoppm -r 150 und lies die Notizen, Slugs (EXT./INT. … – TAG/NACHT), Dauern und Dialoge; pdftotext -layout liefert die Slugs.
  • Erstelle ein Kontaktblatt und eine Ansicht mit Raster (Linien alle 0,1 der Breite/Höhe) jedes Bretts: jede spätere Koordinate (wo eine Figur steht, wo getippt werden soll, wo ein Bildschirm ist) wird darauf gemessen, in Bildbrüchen, niemals geraten.
  • Schreibe eine Beat-Liste: Brett → was passiert → die eine Geste, die den Betrachter diese Aktion ausführen lassen würde → Ton → Text.

2. Einstellungen vor Effekten

  • Finde die langen Takes. Aufeinanderfolgende Bretter mit dem gleichen Set und sich bewegenden Subjekten (A→B→C von gehenden Personen) sind ein kontinuierlicher Take: Baue einen sauberen Hintergrund (entferne das Subjekt mit Hilfe der anderen Bretter), schneide das Subjekt aus und bewege es, die Kamera driftet mit. Verwende dort keine Überblendungen ganzer Bretter.
  • Nahe Einstellung → Totale der gleichen Subjekte (oder umgekehrt) ist eine Bewegung: Rahme die Total so ein, dass ihre Subjekte die gleiche Größe und Position wie in der Nahen haben (berechne Zoom und Zentrum aus den gemessenen Kopf-/Fußpositionen), beende die Überblendung bei dieser passenden Einrahmung, dann ziehe zurück. Überprüfe den angepassten Rahmen in einem Screenshot; Geister bedeuten, dass die Zahlen falsch sind.
  • Bretter, die wie eine Bewegung wirken sollen, teilen sich eine Palette (verarbeite sie mit der gleichen Farbvoreinstellung).
  • Wenn der Nutzer sagt, ein Brett zeige die Rückseite eines Fernsehers, eine von hinten gesehene Tür usw., zeichne nichts, was das Brett nicht zeigt: Licht und Ton können das Off-Screen andeuten.

3. Aussehen-Voreinstellungen

Alle Voreinstellungen behalten die Strichzeichnung des Nutzers; sie zeichnen sie nie neu.

  • Film / Risographie (der White-Room-Look): Noten pro Szene (helle, gesättigte Farbe gegen Düsternis), weiche Papiertextur, sanftes Korn; gelegentlich – nicht ständig – Torsionsschwankung, Flimmern und leichte Kratzer; ein Registrierungsschatten. Effekte sind selten und leise: ständiges Flimmern oder Wackeln ist ermüdend.
  • Amerikanischer Comic: bilaterale Glättung; eine Tintenschicht aus einem dunklen Schwellenwert plus Black-Hat, sodass dünne Bleistiftstriche getuscht werden; eine flache Schmuckfarbe in den gezeichneten Bereichen, 45°-Ben-Day-Punkte in den Mitteltönen und ein heller Raster über dem gesamten Panel, dichter an den Rändern; die Farbplatte um 1–2 px von der Tintenplatte versetzt; Ausgabe ~1,5×. Eine Schmuckfarbe pro Ort/Zeit (warmer Tag, blaue Nacht, grüne Überwachungskamera, roter Alarm …). Beschriftung: gelbe Bildunterschriften für Slugs, Comic-SFX-Wörter im Bild, Sprechblasen für Dialoge.
  • Pixel: Verkleinerung auf ein kleines Raster mit einer begrenzten Palette und geordnetem Dithering, Vergrößerung mit nächstem Nachbarn; Text in einer Pixel-Schriftart.

Das Seiten-Chrom folgt der Voreinstellung (Vorführraum, Zeitungsseite, Spielbildschirm). Web-Schriftarten werden mit einem 2–3 s Fallback-Rennen geladen, damit die Geschichte nie auf sie wartet.

4. Bauen: eine HTML-Seite, eine Leinwand

  • Eine 16:9-Bühne, eine Leinwand, ein Untertitel-/Hinweisbereich darunter, ein Sprachwechsler (falls mehr als eine Sprache) und ein Ton-Umschalter.
  • Szenen-Zustandsmaschine: Jede Szene ist ein Objekt mit enter / render(t) / tap / drag / down / up / hover / key; go(szene) wechselt; st() ist die Zeit in der Szene. Ein Kamera-Helfer (setCam(img, zoom, cx, cy), toScreen, toImg), damit jeder Trefferbereich und Effekt in Bildbrüchen platziert wird und der Kamera folgt.
  • Jede Szene hat einen Ausweg: eine Tastaturtaste und ein langsamer automatischer Fallback (10–20 s), damit niemand stecken bleibt, plus einen „Überspringen”-Link bei den langen Szenen.
  • Wickle jeden Tonaufruf ein, sodass ein fehlender Audio-Kontext oder eine fehlgeschlagene Dekodierung niemals die Geschichte zerstören kann.
  • Lade Bilder mit <img> (funktioniert auch bei file://); Audio über fetch + decodeAudioData, mit Rückfall auf <audio>-Elemente, wenn fetch blockiert ist.

5. Interaktionsdesign

  • Die Geste ist die Handlung der Geschichte. Laufen = schnelle Klicks; den Atem anhalten = nicht berühren; sich hinauslehnen = halten; klettern = wiederholtes Ziehen nach oben; etwas übergeben = es tragen; eine Seite umblättern = über das Buch ziehen; ausschalten = auf die Hand am Knopf halten. Bevorzuge diese vor generischem „Klicken zum Fortfahren”; behalte einfache Tippen für Dialoge und für Beats, die reiner Rhythmus sind.
  • Verwende die eigene Zeichnung des Nutzers, niemals ein erfundenes Requisit. Schneide die Figur/das Objekt entlang seiner Kontur aus (Polygon, das auf dem gerasterten Zoom nachgezeichnet wurde, weiche Kante), füge einen dünnen weißen Rand wie einen Papierausschnitt hinzu, hebe es mit einem kleinen Schatten an und neige es beim Ziehen, lasse das bloße Papier zurück, wo es war, schnappe zurück, wenn es falsch abgelegt wird. Überprüfe den Ausschnitt am Brett: nimm nicht versehentlich Treppen, Möbel oder die Hand einer anderen Figur mit.
  • Effekte, die auf einem Brett hinzugefügt werden (ein Bildschirm, der aufleuchtet, Radiowellen, ein Sucher), müssen der Geometrie der Zeichnung folgen – schneide einen Bildschirm-Glow auf das Perspektiv-Viereck des Bildschirms zu, nicht auf ein Rechteck – und sollten dem Nutzer als Ergänzungen mitgeteilt werden.
  • Hinweise sagen, wo und wie: „Halte den Fisch und kritzle hin und her”, nicht „interagiere”. Größer als Fließtext, unter dem Bild.
  • Bildführungen, leise standardmäßig (denk an What Remains of Edith Finch): Ein kleines Zeichen am Berührungspunkt, das bereits die Aktion sagt – ein Puls für Tippen, ein sich füllender Ring für Halten, Chevrons, die in die Ziehrichtung fließen, ein sich drehender Bogen für Kreisen (im Comic-Stil: Tinte „schau her”-Häkchen). Eine Hand demonstriert die Geste zweimal, wenn der Schritt beginnt, dann tritt sie zurück; sie kehrt erst nach ~3 s des Zögerns zurück. Verstecke alles, während der Finger unten ist. Decke das Bild niemals mit langen gestrichelten Pfaden ab.

6. Übergänge

  • Passe den Ton an: weich standardmäßig (Überblendungen, bei denen sich das neue Panel aus etwas Größerem setzt, Tinte rein/raus, ein leichtes Aufleuchten für einen Fernseher, der angeht, oder ein Feuer, das auffängt). Behalte einen harten Schnitt (Negativrahmen, Bewegungslinien, Wackeln) für den einzigen Schock der Szene. Alle harten Schnitte = steif.
  • Ein kontinuierlicher Schub in den nächsten Raum ist eine lange Bewegung: Was dazwischen liegt (eine Wand), nimmt Farbe und Textur vom Ziel-Panel und schmilzt darin ein; keine Rinnen in der Mitte einer Bewegung.
  • Zeige niemals die schwarzen Kanten eines gedrehten oder gezoomten Bildes: begrenze die Kamera.

7. Ton

  • Aufgenommener Ton: schneide ihn auf die Aktion zu (eine Tür, die sich synchron zum gezeichneten Griff öffnet), pegle alles, schleife Atmosphären mit Überblendungen.
  • Synthetisierter Ton (WebAudio, keine Dateien): Schritte, Papier, Türen, mechanische Hunde, Alarme, Herzschläge, Fernsehgemurmel … Randomisiere jeden Schlag (Timing, Tonhöhe, Hüllkurve) und forme die Hüllkurven ungleichmäßig, damit nichts maschinell wiederholt klingt; vermeide Klicks und trockene Pieptöne in ruhigen Szenen.
  • Verwende Tonbrücken für Bedeutung (eine Waschmaschine, die langsam zum Meer des Traums wird; ein Ton, der über den Titel hinweg weiterläuft). Frage, bevor du Töne hinzufügst, die das Storyboard nicht andeutet.

8. Text

  • Dialog: Sprechblasen (Comic) oder Untertitel (Film), Spitze zeigt auf den Kopf des Sprechers, innerhalb des Panels gehalten, durch Messen umbrochen, beginne nie eine Zeile mit schließender Interpunktion. Fülle Körper und Schwanz jeder Blase separat, damit kein Strich den Text kreuzt.
  • Slugs als Beschriftungskästen in der Ecke; halte sie von wichtigen Zeichnungen fern (überspringe die Beschriftung auf einem Brett, wo sie das Subjekt abdecken würde).
  • Zitate, die du hinzufügst (z.B. was Figuren aufsagen), müssen gemeinfrei sein und dem Nutzer gekennzeichnet werden.

9. Leistung

  • Begrenze die Leinwand auf ~1600 px Breite (DPR = max(1, min(devicePixelRatio, 2, 1600 / cssWidth))).
  • Vorausberechnung statischer Overlays (Papiertextur, Vignette) einmal pro Größe und lege sie auf jeden Frame; baue niemals Farbverläufe oder Muster pro Frame neu.
  • Für Überblendungen behalte den vorherigen Frame bei halber Größe, nicht eine vollständige Kopie pro Frame.
  • Lazy-Lade die Geschichte auf der Host-Seite (Poster + „In die Geschichte eintreten”-Button); jede Szenenseite lädt nur ihre eigenen Bilder.

10. Wie ein Betrachter testen

  • Ein Headless-Browser-Durchlauf (z.B. Playwright) mit echten Mausgesten (Klicks, Halten, Ziehen, gemessen von toScreen) durch die gesamte Geschichte, in jeder Sprache, die bei jedem Seitenfehler fehlschlägt. Stelle ein test-only __go(szene, zustand) bereit, um zu einem Beat zu springen.
  • Screenshots von jedem Schlüsselbild und von der Mitte jedes Übergangs/Matches; schau sie dir an.
  • Syntaxprüfung des Skripts nach Bearbeitungen (node --check). Setze keine //-Kommentare mitten in eine einzeilige Anweisung (sie kommentiert stillschweigend den Rest der Zeile aus und die Seite bleibt leer).
  • Messe die Bildrate vor/nach großen Änderungen. Sage klar, dass Ton und Gefühl durch Messungen und Screenshots überprüft wurden, nicht durch Abspielen.

11. Liefern

  • Eine teilbare gehostete Seite zur Überprüfung; für die Webseite des Nutzers ein Zip von deren Seitenpaket mit der Geschichte in einem eigenen Ordner (z.B. story/<projekt>/), einem Lazy-Loading-Einbettblock und nichts anderem geändert. Wenn der Nutzer die Geschichte in seiner Seite angepasst hat, bearbeite immer diese Kopie (3-Wege-Merge deiner Änderungen darauf), überschreibe sie niemals mit dem Original.
  • Mehrere Szenen: eine Seite pro Szene, die einen gemeinsamen Assets-Ordner teilen, verkettet (Ende der Szene → nächste Szene, Sprache erhalten; die letzte kehrt zur ersten zurück). Das Cover jeder Szene benötigt einen Klick, um Audio nach der Navigation freizuschalten.
  • Stelle niemals etwas im Auftrag des Nutzers bereit; übergib das Zip.
  • Eine eigenständig geöffnete Datei wird schwarz sein: die Seite benötigt ihren a/-Assets-Ordner daneben. Sage dies bei der Übergabe der Dateien.

Verwandte Skills