Storyboard

Was macht Storyboard?

Ein Storyboard ist der Dreh- und Schnittplan für ein Video. Er ist fertig, wenn der Nutzer ihn von oben nach unten lesen, jede Sitzung filmen und jede Einstellung an den Schnitt (oder an Claude) übergeben kann, mit einem klaren Bild davon, was auf dem Bildschirm zu sehen ist, was der Text sagt und wie der Sound ist.

Halte es schlank. Einstellungen und Sitzungen, nichts weiter. Kein Bogen-Diagramm, keine Übergänge pro Einstellung, kein Brand-Kit, keine Checkliste. Wenn der Nutzer mehr möchte, wird er fragen.

Erster Durchlauf: Geführte Einrichtung

Führe die Einrichtung durch, wenn ~/.claude/storyboard-profile/profile.md noch nicht existiert, direkt nachdem die Skill installiert wurde, oder wenn der Nutzer darum bittet, sie einzurichten oder seinen Stil neu zu erlernen. Führe ihn Schritt für Schritt hindurch: Sage in einem Satz, wozu der Schritt dient, führe ihn aus, und warte an den Stellen, an denen gefragt wird. Halte jede Nachricht kurz; die meisten Leute, die das tun, sind Creator, keine Entwickler.

1. Willkommen. Eine kurze Nachricht: Was die Skill macht (Skript rein, ein Frame für jede Zeile raus, dann baut Claude die Grafiken daraus) und dass die Einrichtung etwa fünf Minuten dauert. Sage dann, dass du zuerst einen Blick auf ihre Videos brauchst.

2. Überprüfe die Werkzeuge. Suche nach Python 3, Google Chrome (oder Chromium / Edge) und ffmpeg. yt-dlp ist ein Bonus für Links. Wenn etwas fehlt, gib den einen Installationsbefehl für ihr System (z.B. brew install ffmpeg auf einem Mac, winget install ffmpeg unter Windows) und biete an, ihn auszuführen. Fahre erst fort, wenn Chrome und ffmpeg funktionieren.

3. Frage nach ihnen. Eine Nachricht, jede Zeile wird beantwortet: Ihr Handle und ihre Plattformen, worum es in ihren Inhalten geht, wie lang ihre Videos normalerweise laufen und wie sie sie beenden (ein Kommentar-Keyword, Folgen, Link in der Bio).

4. Bitte um ihre Videos. Das ist der wichtige Schritt, also erkläre warum: Ihre Storyboards sollten wie ihre Videos aussehen, nicht wie eine Vorlage. Bitte um 3 bis 5 veröffentlichte Videos, die ihren Stil am besten zeigen, idealerweise eins mit Bildschirmaufnahmen oder Grafiken, falls sie solche machen. Sie können die Dateien in den Chat ziehen (das fügt den Pfad ein) oder Links einfügen. Lade Links mit yt-dlp herunter, falls es installiert ist; falls ein Link nicht heruntergeladen werden kann, bitte um die Datei. Lege alles in ~/.claude/storyboard-profile/source/ ab.

5. Studiere die Videos. Für jedes einzelne:

   • Frames: ffmpeg -i v1.mp4 -vf "fps=1,scale=360:-2" -q:v 4 source/v1_%03d.jpg, dann sieh sie dir an.
   • Schnitte: ffmpeg -i v1.mp4 -vf "select='gt(scene,0.1)',showinfo" -f null - 2>&1 | grep -o "pts_time:[0-9.]*" gibt die Schnittzeiten aus, also erhältst du die durchschnittliche Schusslänge. Sprungschnitte bei einem sprechenden Kopf ändern das Bild kaum und werden übersehen, also überprüfe die Anzahl mit den 1-fps-Frames.
   • Wörter: Falls whisper (oder ein anderer Transkriptor) installiert ist, transkribiere es. Falls nicht, lies die eingebrannten Untertitel von den Frames ab oder bitte sie, das Skript einzufügen.

   Schreibe auf, was du tatsächlich siehst, keine Vermutungen: die Mischung der Aufnahmearten (wie viel ist Gesicht vs. Bildschirm vs. B-Roll), durchschnittliche Schusslänge, Bildausschnitt (Nah oder Mittig, wo sie sitzen, der Hintergrund), wie die ersten zwei Sekunden fesseln, der On-Screen-Text (Schriftstärke, Groß-/Kleinschreibung, Farben, Hervorhebungsstil, wo er sitzt), der Untertitelstil, die Hauptfarben, Grafiken oder Overlays, die wiederholt werden, Sound-Gewohnheiten und wie der CTA ankommt.

6. Wähle ihr Standbild mit Gesicht. Wähle einen sauberen Frame von ihnen, der in die Kamera spricht, ohne eingebrannte Untertitel, beschneide ihn auf 9:16 (ffmpeg -ss <t> -i v1.mp4 -frames:v 1 -vf "crop=ih*9/16:ih,scale=540:960" face.jpg) und speichere es als ~/.claude/storyboard-profile/face.jpg. Jede Gesichtsaufnahme verwendet es von nun an.

7. Schreibe das Profil. Speichere ~/.claude/storyboard-profile/profile.md mit Abschnitten für Creator (Schritt 3), Aufnahmen (Artmischung, durchschnittliche Länge, Bildausschnitt), Hook, On-Screen-Text, Untertitel, Farben, Sound, CTA und Wiederkehrende Grafiken. Schreibe dann ~/.claude/storyboard-profile/theme.css und überschreibe die Variablen des Kits mit ihrem Look:

   :root { --ink: #111; --accent: #ff5a1f; --on-accent: #fff; --bg: #f4f1ea;
           --grid: rgba(0,0,0,.05); --font: "Montserrat", sans-serif; }
   

   Verwende eine Schriftart, die sie installiert haben; falls ihre nicht vorhanden ist, wähle die nächstgelegene, die es ist.

8. Zeige es ihnen und bestätige. Baue ein Beispiel-Frame (ihren Überschriftenstil über ihrem Gesichts-Standbild), rendere es, zeige es mit einer dreizeiligen Zusammenfassung des Profils und frage, was nicht stimmt. Korrigiere es, bis sie sagen, dass es wie ihre Inhalte aussieht.

9. Übergabe. Sage ihnen, dass die Einrichtung abgeschlossen ist und was als nächstes zu tun ist: "Füge ein Skript ein und sage 'Storyboard this'." Sie können die Einrichtung jederzeit wiederholen, wenn sich ihr Stil ändert.

Wenn sie die Einrichtung lieber überspringen möchten, erstelle das Storyboard mit dem Standard-Look des Kits und biete die Einrichtung am Ende erneut an.

Das Format

Jede Einstellung hat:

Feld	Inhalt
type	face (spricht in Kamera), split (Bildschirm oben, Gesicht in abgerundetem Feld unten), screen (Bildschirmaufnahme), graphic (im Schnitt erstellt), b-roll (reales Filmmaterial)
vo	die genauen Skriptwörter, die über diese Einstellung gesprochen werden
on_screen_text	Text, der in das Frame eingebrannt ist, normalerweise leer
edit_note	ein oder zwei Zeilen: was auf dem Bildschirm zu sehen ist, was sich bewegt, der Bildausschnitt
sfx	ein Sound, normalerweise leer
thesis	true bei genau einer Einstellung
status	real (das Frame IST das Filmmaterial), stand-in (zeigt die Absicht), to-capture (noch nichts)

Die Zeitmessung erfolgt über den VO mit 3,4 Wörtern pro Sekunde. Niemals von Hand einstellen.

Sitzungen gruppieren die Einstellungen nach Drehort: label, detail (was vorzubereiten ist) und shots (Einstellungsnummern).

Schritte

1. Lies das Profil und hole das Skript. Lies ~/.claude/storyboard-profile/profile.md und folge ihm: ihren Einstellungslängen, ihrer Mischung der Einstellungstypen, ihrem Textstil, ihrem CTA. Wo es von den Standardwerten unten abweicht, gewinnt das Profil. Noch kein Profil? Biete zuerst die Einrichtung an. Frage nach dem Skript, wenn es nicht im Gespräch oder in einer Datei ist, und notiere die Ziellänge (die übliche Länge des Profils, wenn sie nichts sagen). Bearbeite das Skript nicht. Wenn eine Zeile falsch klingt, sage es und lass den Nutzer sie korrigieren.

2. Teile das Skript Wort für Wort in Einstellungen auf. Wieder zusammengesetzt müssen die vo-Felder exakt dem Skript entsprechen. Keine Umformulierungen, Kürzungen oder hinzugefügte Zeilen.

   • Schneide, wo sich das Bild ändert, nicht an Satzenden. Ein Komma ist ein guter Schnittpunkt.
   • Ziele auf 2 bis 6 Sekunden pro Einstellung (7 bis 20 Wörter). Ab etwa 8 Sekunden teile es auf, es sei denn, ein durchgehendes Bild trägt die Zeile wirklich.
   • Einstellung 1 enthält das Gesicht des Sprechers (eine face- oder split-Einstellung). Ein Gesicht in der ersten Sekunde hält die Leute.
   • Markiere genau eine thesis-Einstellung: die Zeile, die sagt, worum es im Video geht.
   • Letzte Einstellung: das Gesicht des Sprechers, das den Call-to-Action sagt. Wenn es ein Kommentar-Keyword gibt, wird es gesprochen und lebt in den Untertiteln, nicht als große On-Screen-Pille.
   • Variiere den Typ. Keine drei face-Einstellungen hintereinander. Verwende face für Behauptungen, Nebenbemerkungen und den CTA; verwende screen für alles, was gezeigt wird.

3. Fülle die Felder sparsam aus.

   • on_screen_text: Überschrift von Einstellung 1, Listennummern (01 SCRIPT) und höchstens ein Höhepunkt. Überall sonst leer; Untertitel tragen den Rest.
   • edit_note: was auf dem Bildschirm zu sehen ist, was sich bewegt und der Bildausschnitt (Mitte oder Nah). Füge hier auch Privatsphäre-Hinweise ein: E-Mails unkenntlich machen, Dateipfade mit Benutzernamen zuschneiden.
   • sfx: zwei oder drei im gesamten Video, nur dort, wo etwas landet (ein Ping beim Öffnen, ein Hit, wenn etwas live geht).

4. Gruppiere die Einstellungen in Sitzungen nach Drehort, nicht nach Einstellungsreihenfolge.

   • Gesicht: eine Sitzung für jede Gesichtsaufnahme plus die Gesichtshälfte jeder Split-Aufnahme.
   • Bildschirme: eine Sitzung pro App- oder Tool-Sitzung, die dasselbe echte Projekt durchgehend verwendet.
   • Weg vom Schreibtisch: nur, wenn eine B-Roll-Einstellung es erfordert.
   • detail: was vorzubereiten ist (welches Projekt zu öffnen ist, was laufen soll, was zuerst vom Bildschirm zu räumen ist).

5. Schreibe storyboard.json in einem storyboard/<video-slug>/-Ordner im Arbeitsverzeichnis des Nutzers (frage, ob es einen besseren Ort gibt):

   {
     "title": "AI edits my videos",
     "target_seconds": 50,
     "shots": [
       {"type": "face", "vo": "My last couple of videos were all edited by Claude.",
        "on_screen_text": "CLAUDE EDITS MY VIDEOS", "edit_note": "Mid shot, headline holds 4s.",
        "sfx": "", "thesis": false, "status": "to-capture"}
     ],
     "sittings": [
       {"label": "Face", "detail": "Same shirt and light for every face line.", "shots": [1]}
     ]
   }
   

6. Baue ein Frame für jede Einstellung (nächster Abschnitt) als frames/f01.html, frames/f02.html, und so weiter. Die Nummer ist die Position der Einstellung.

7. Rendern:

   python3 <Ordner dieser Skill>/kit/render.py storyboard/<video-slug>
   

   Es rendert frames/out/fNN.png bei 540x960 mit headless Chrome, ein frames/out/contact-sheet.jpg und board.html: jedes Frame neben seinem VO, Text, Bearbeitungshinweis, Sound und Timing, plus die Sitzungen. Es gibt die Laufzeit und die Gesicht- vs. Bildschirmsekunden aus.

8. Überprüfe das Kontaktblatt, korrigiere und rendere neu: Text über einem Gesicht, Überlappungen, Text in den Sicherheitszonen, alles Private.

9. Berichte kurz: Anzahl der Einstellungen, Laufzeit vs. Ziellänge, Gesicht- vs. Bildschirmsekunden und was noch aufzunehmen ist. Öffne board.html für den Nutzer.

Frames

Verwende die realste Quelle, die du bekommen kannst, in dieser Reihenfolge:

1. Echtes Material. Ein Screenshot der echten Website oder App, die in der Einstellung vorkommt (headless Chrome oder Playwright, 1440 breit für Desktop, 390 für Mobilgeräte), oder ein Standbild aus dem eigenen Filmmaterial des Nutzers (ffmpeg -ss <Zeit> -i clip.mp4 -frames:v 1 still.jpg). Lege Bilder in den frames/-Ordner und referenziere sie mit Dateinamen.

2. Gebaute Frames. Schreibe das Frame als HTML-Body-Fragment unter Verwendung der Klassen in kit/frame-kit.css. {{face}} in einem Fragment wird zu frames/face.jpg, falls vorhanden, sonst zum Gesichts-Standbild aus der Einrichtung, sonst zu einer neutralen Silhouette. Das theme.css der Einrichtung gestaltet jedes Frame automatisch mit ihren Farben und Schriftarten um.

   Klasse	Verwendung
   .f	Der Frame-Wrapper, immer das äußere Element
   .hl	Überschrift oben, <em> auf einem Schlüsselwort
   .lbl mit .n + .t	Ein nummeriertes Listenetikett (01 SCRIPT)
   .face	Ganzflächiges Gesicht (ein <img src="{{face}}">)
   .facebox	Die Gesichtsbox in einer split-Einstellung
   .term	Ein Claude Code Terminal (.p Prompt, .tool Toolaufruf, .ok, .dim)
   .chat + .bub + .vid	Eine Agent-Chat-Nachricht, optional mit Video
   .shot	Eine Screenshot-Karte (<div class="shot"><img src="..."></div>)
   .tbl	Eine Datentabelle (.h Kopfzeile, .r Zeilen, .r.new eine neue Zeile)
   .big	Ein großer Höhepunkt
   .room	Ein B-Roll-Platzhalter mit einer Bildunterschrift

   Setze die vertikale Position mit einem Inline-style="top:..px". Beispiel-Fragment:

   <div class="f">
     <div class="lbl"><span class="n">01</span><span class="t">SCRIPT</span></div>
     <div class="term" style="top:200px">
       <div class="bar"><i></i><i></i><i></i></div>
       <div class="p">write me a 45 second script about ...</div>
       <div class="ok">  ✓ script.md</div>
     </div>
     <div class="facebox"><img src="{{face}}"></div>
   </div>
   

3. Mocke es mit echten Daten, wenn der Bildschirm hinter einem Login steckt, den du nicht umgehen kannst. Melde dich nicht im Namen des Nutzers an. Baue den Bildschirm aus echten Zahlen und markiere ihn als Platzhalter.

Frame-Regeln:

• Sicherheitszonen: Halte Text aus den unteren 20% und den rechten 12% (der Like- und Kommentar- Leiste) fern und halte die oberen 8% frei. Die Positionen des Kits respektieren diese bereits.
• Ihr Überschriftenstil: Folge den Notizen zum On-Screen-Text des Profils (Groß-/Kleinschreibung, Gewicht, wie sie ein Wort hervorheben). Die Standardeinstellung ist fette Großbuchstaben mit einem Schlüsselwort in <em>. Über einem ganzflächigen Gesicht macht das Kit die Schrift weiß mit einem weichen Schatten.
• Privatsphäre: Keine Dateipfade mit Benutzernamen, E-Mails, API-Schlüsseln oder .env-Inhalten in irgendeinem Frame. Verwende in Tabellen gefälschte IDs.

Verwenden zum Erstellen des Videos

Sobald das Storyboard genehmigt ist, ist es der Prompt. Baue die Grafiken Einstellung für Einstellung auf: "Baue Einstellung 4 aus dem Storyboard als 9:16-Bewegungsgrafik: Stimme das Frame, den On-Screen-Text und den Bearbeitungshinweis überein." Die erste Version ist nie richtig; lege sie in den Schnitt, vergleiche sie mit dem Frame und gehe hin und her, bis sie übereinstimmt.