Communitygithub.com

Storyboard-Director

Erstellt detaillierte Produktions-Storyboards, in denen jeder Beat Text, Position, Bildsprache, Bewegung, Ton, Timing und die Verknüpfung mit dem Drehbuch festhält.

Was ist Storyboard-Director?

**Storyboard-Director** ist ein KI-Agenten-Skill zur Erstellung von Produktions-Storyboards, die weit über einfache Bildlisten hinausgehen. Er zwingt den Nutzer, für jede Szene und jeden Beat präzise Angaben zu Text/Erzählung, Bildsprache, Position/Layout, Bewegung, Ton und Timing zu machen. Der Skill unterstützt die Arbeit mit 1080×1920 vertikalen Formaten bei 60 FPS und liefert eine vollständige, codierbare Spezifikation. Er ist ideal für Entwickler und Kreativteams, die Konsistenz und Nachvollziehbarkeit in der Videoproduktion sicherstellen wollen. Die Ausgabe erfolgt als strukturierte Tabelle mit ID, Ein-/Aus-Frames, Text, Bild, Position, Bewegung, Ton und Übergang – bereit für die direkte Übersetzung durch Motion-Design und Engineering-Teams.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/achmdfzn/motionforge-atelier/tree/HEAD/.claude/skills/storyboard-director

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Storyboard-Director?

Verpflichtend

Ein Storyboard ist nicht nur eine Liste von Bildern. Jede Szene und jeder Beat muss enthalten: Text/Erzählung, Bildsprache, Position/Layout, Bewegung, Ton und Zeit. Verwende die Vorlage docs/templates/STORYBOARD_TEMPLATE.md.

Ablauf

  1. Lege das Briefing, das vertikale 1080×1920-Format, 60 FPS, Dauer, Zielgruppe, Styleguide und Hauptbotschaft verbindlich fest.
  2. Zerlege das Drehbuch in atomare Sätze/Beats; gib ihnen stabile IDs (S01-B01 usw.). Fasse verschiedene Sätze nicht ohne Grund zusammen.
  3. Schreibe für jeden Beat den exakten VO-Text, den exakten Bildschirmtext, was sichtbar ist, das Motiv/Asset und die Aktion.
  4. Setze Positionen mit normalisierten 0…1-Koordinaten (x, y, w, h), Anker, Ausrichtung, Ebene/z-Ordnung, Sicherheitsbereich und Leserichtung. Füge bei Bedarf Pixelgrößen/-positionen hinzu.
  5. Definiere Bildausschnitt, Kamera, Übergänge, Ein-/Ausbewegung, Dauer, Start-/Endframe und Überlappung.
  6. Nimm Audio auf: VO-Clip, Musik, Atmo, SFX, Cue-Frame, Dauer, relativer Pegel, Fade und Pausen/Stille.
  7. Ordne jeden VO-Satz einem oder mehreren Bildern/Shots zu, die seine Bedeutung verdeutlichen. Vermeide sich wiederholende, wörtliche Bilder; nutze Metaphern, wenn sie besser funktionieren.
  8. Prüfe Kontinuität, Lesbarkeit auf Mobilgeräten, Sicherheitsbereich, Timing und dass die Gesamtdauer stimmt.

Verpflichtende Angaben pro Beat

  • ID, Szene, Start-/Endframe, Dauer in Frames und Sekunden.
  • VO-Satz-ID + Text.
  • Bildschirmtext + Position.
  • Bild/Asset + Komposition und Position.
  • Bewegung/Kamera + Easing.
  • Audio-Cue: Typ, Datei/Platzhalter, Start/Ende, relativer Pegel, Fade.
  • Übergang ein/aus und Kontinuitätshinweise.

Regeln

  • Jeder sichtbare Text muss wörtlich ausgeschrieben werden, nicht „Titel hinzufügen".
  • Alle Positionen müssen explizit sein, nicht „ungefähr in der Mitte".
  • Jedes Geräusch muss notiert werden, einschließlich der Entscheidung für kein Geräusch/Stille.
  • Erfinde keine Assets, die es noch nicht gibt; markiere sie als PLATZHALTER und liste die Asset-Anforderungen auf.
  • Beat-Dauer bei 60 FPS: dauerInFrames = endFrame - startFrame mit exklusiver Endgrenze.
  • Ein abschließendes Logo + CTA ist verpflichtend und muss spezifisch für das Video sein, nicht generisch.

ID- und Zeitkonventionen

  • Beat-ID: S<szene>-B<beat> mit zwei Stellen (S01-B01). IDs ändern sich nicht, wenn ein Beat verschoben wird; ein eingefügter Beat erhält eine neue ID (S02-B03), statt alles umzunummerieren.
  • Halboffenes Intervall [startFrame, endFrame): Frame endFrame gehört bereits zum nächsten Beat.
  • Von Sekunden nur einmal und an einer Stelle umrechnen: frame = round(sekunden × fps). Danach ist jede Zahl im Storyboard ein ganzzahliger Frame.
  • Aufeinanderfolgende Beats müssen lückenlos sein: endFrame von Beat N = startFrame von Beat N+1. Überlappung ist nur für Übergangsfenster erlaubt, die in der Spalte Übergang notiert sind.
  • Gesamt: endFrame des letzten Beats = dauerInFrames der Komposition.

Ausgabeformat

  • Kopfzeile: Projekt-ID, Leinwand, FPS, Dauer (Sekunden + Frames), Pfade zum Styleguide und Audio-Plan.
  • Beat-Tabelle gemäß docs/templates/STORYBOARD_TEMPLATE.md.
  • Hinweise zu komplexen Beats (mehrstufige Bewegungen, Figuren, 3D).
  • Satz-zu-Shot-Zuordnung bei VO, oder eine einzelne Zeile „nicht zutreffend — keine VO".
  • Audio-Cue-Blatt, einschließlich absichtlicher Stille.
  • Spezifikation für die maßgeschneiderte Endkarte.
  • Liste der PLATZHALTER-Assets mit Anforderungen und Lizenzstatus.

QA-Checkliste

  • Jeder Beat hat eine ID, Frame ein/aus, wörtlichen Text (oder „—"), Bildsprache, normalisierte Position, Bewegung, Ton und Übergang.
  • Beats sind lückenlos ab Frame 0; die Summe der Dauern = dauerInFrames.
  • Wichtiger Text liegt im Sicherheitsbereich und ist auf einem Telefonbildschirm lesbar (Größe, Kontrast, Einblendzeit).
  • Text bleibt lange genug sichtbar; lange Sätze werden aufgeteilt oder erhalten mehr Zeit.
  • Jeder VO-Satz hat einen zugeordneten Shot; jeder Shot hat einen redaktionellen Zweck.
  • Stille wird explizit notiert, nicht leer gelassen.
  • Bewegung wird als Funktion des Frames beschrieben (von/bis, Frame-Bereich, Easing), bereit für die Übersetzung durch frame-time-engineering.
  • Die Endkarte führt das Motiv des Videos fort und ihr CTA ist wörtlich.
  • Jedes Asset, das noch nicht existiert, ist als PLATZHALTER markiert.

Minimalbeispiel

Ein 2-Sekunden-Text-Hook-Beat:

Beat-IDFramesVOBildschirmtextBildPositionBewegungTonÜbergang
S01-B010–120—Warum wirkt dein Video generisch?Einfarbig dunkler Hintergrundx .08, y .40, w .84; linksbündig; z 2Jedes Wort erscheint alle 10 Frames, Slide-Up 24 px, 14-Frame-Dauer, ease-outStille 0–30, SFX-001 Whoosh bei 30Schnitt

Bewegung codierbereit: Wort i startet bei Frame i × 10; opacity 0→1 und translateY 24→0 über [i×10, i×10+14].

Fehlermodi

  • „Text erscheint in der Mitte" → kann nicht codiert werden; schreibe x/y/w/h, Anker und Ausrichtung.
  • Beats um einen Frame versetzt (0–119 dann 120–240) → die exclusive Konvention wurde nicht angewendet; stelle alles auf halboffen um.
  • Text in Code geändert, aber nicht im Storyboard → das Storyboard ist die Quelle der Wahrheit für Copy; aktualisiere zuerst das Storyboard.
  • Gesamtdauer passt nicht zur Komposition → berechne aus der Tabelle neu; korrigiere nicht im Code.
  • Bilder pro Satz zu wörtlich → verwende eine Demonstration, ein Diagramm oder eine Metapher; notiere den Grund.
  • Endkarte ist ein Logo + „Folge uns" → nicht maßgeschneidert; baue eine visuelle Brücke vom Motiv des Videos.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Verwandte Skills