Communitygithub.com

Film-Storyboard

Schreibe die Geschichte eines Produktfilms als Beats (was der Zuschauer sieht, die Worte auf dem Bildschirm, die Stimme, der Ton, warum der Beat existiert und wo jede Behauptung bewiesen ist) und sende sie dem Eigentümer als einseitiges Storyboard mit Frames zur Überprüfung, mit 2–4 Richtungen, wenn die Geschichte offen ist. Stufe 2 von Produktfilm, und das Überprüfungsformat wird für den Voiceover wiederverwendet. Verwende dies bei der Planung der Geschichte, der Aufnahmeliste oder des Drehbuchs eines Launch-/Promo-Films oder wenn der Eigentümer sagt: „Gib mir ein Storyboard“, „Gib mir Richtungen“, „Ich werde prüfen und entscheiden“.

Was ist Film-Storyboard?

Das **Film Storyboard** Skill ist ein zentrales Werkzeug für die zweite Stufe der Produktfilmerstellung. Es ermöglicht Entwicklern und KI-Agenten, die narrative Struktur eines Films in sogenannten „Beats“ zu entwerfen – detaillierten Einheiten, die beschreiben, was der Zuschauer sieht, welche Texte eingeblendet werden, welche Voiceover und Soundeffekte ablaufen, warum jeder Beat existiert und wo jede Behauptung im Produkt nachgewiesen ist. Das Skill unterstützt die Arbeit mit Plattformen wie Claude Code, Cursor oder Codex und ist besonders nützlich, weil es teure Fehler vermeidet: Eine Änderung eines Satzes im Storyboard kostet eine Minute, eine Änderung eines bereits gerenderten Shots kostet eine Stunde. Es generiert aus einer `storyboard.json`-Datei eine HTML-Seite zur Überprüfung, die der Eigentümer mit Anmerkungen versehen kann. Das Skill erzwingt eine Reihe von Qualitätskriterien (z. B. echte Produktfunktionen, keine abstrakten Behauptungen, ausreichende Zeiten für Texteinblendungen) und ermöglicht es, mehrere kreative Richtungen (2–4) gleichzeitig zu präsentieren. Die Funktionsweise ist strikt prozessorientiert: Nach Lesen der freigegebenen Briefs und Referenzen werden die Beats im JSON-Format erstellt, die Seite gebaut, eine Selbstprüfung durchgeführt und schließlich die Freigabe durch den Eigentümer eingeholt, bevor das Storyboard als verbindliche Quelle für Timing und Platzierung von Shots und Voiceover festgeschrieben wird.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aqeelshamz/product-film-skills/tree/HEAD/film-storyboard

In Ihrer bevorzugten KI fragen

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

Dokumentation

Film Storyboard

Das Storyboard ist der Ort, an dem die meisten Korrekturen des Eigentümers stattfinden sollten, denn einen Satz zu ändern kostet eine Minute und einen gerenderten Shot zu ändern kostet eine Stunde. Sende es, bevor du baust, und sende es erneut (mit echten Frames), bevor du eine Stimme aufnimmst.

Was eine gute Produktfilm-Geschichte ausmacht

Überprüfe jeden Beat anhand dieser Kriterien. Jedes stammt aus einem abgelehnten Entwurf (siehe product-film/references/lessons.md).

  1. Der Schmerz des Zuschauers, in seinem Alltag. Nenne die Gewohnheit oder das Ärgernis so, wie der Zuschauer es sagen würde. Teste den Satz: Nachdem man ihn gehört hat, was würde ein Fremder denken, dass wir verkaufen? „Jeden Tag dieselben Zahlen“ ließ die Leute an Analysesoftware denken, also ist es gescheitert.
  2. Rollen dürfen nicht falsch verstanden werden. Zeige echte Tools mit Namen und Logo. Überprüfe jedes benachbarte Zeilenpaar: „Frag die KI, die du bereits bezahlst. Sie heißt Nimbet.“ lässt das Produkt wie die KI klingen. Binde den Namen an das, was das Produkt tut.
  3. Konkret, nicht abstrakt. „Deine KI“ als Bezeichnung war unklar; das echte Claude Desktop-Fenster war klar. Ein echtes Stripe-Dashboard ist besser als eine Box mit der Aufschrift „Umsatz“.
  4. Bandbreite braucht Raum. Wenn das Versprechen „was auch immer DU brauchst“ ist, zeige 8+ Arten von Menschen (jeweils eine Vollbildkarte), dann eine Wand mit vielen Gegenständen, die Arbeit, Leben und Spaß mischen (Spiele, Haustiere, Aufkleber). Weniger als ~6 fühlen sich „festgefahren“ an. Dies benötigt 45–65 s; 20 s sind zu kurz.
  5. Nur echt. Jeder Gegenstand, jede Fähigkeit und jede Behauptung funktioniert im heutigen Produkt. Fülle das Feld claim mit dem Ort, an dem es bewiesen ist (eine Datei, ein Dokument, ein Test). Wenn die Geschichte etwas benötigt, was das Produkt nicht kann, sprich es beim Eigentümer an: Baue es oder streiche es.
  6. Verstehe jeden Shot, bevor du darüber schreibst. Schreibe das why für jeden Beat. Wenn du nicht sagen kannst, wofür ein Shot da ist, frage den Eigentümer. (Eine Haustierzeile wurde über einen Shot geschrieben, der tatsächlich die eigenen benutzerdefinierten Widgets der Leute zeigte.)
  7. Jede Zeile lesbar. Text auf dem Bildschirm: ~0,3 s pro Wort + 1 s, niemals unter 1,5 s vollständig sichtbar.
  8. Ende mit der Aktion, mit dem Namen und der URL, und der Nominativ-Verwendungszeile, falls eine Marke erschienen ist.

Schritte

  1. Lies das freigegebene Briefing, reference/NOTES.md, das Live-Produkt und die Website sowie die Lektionen-Datei.
  2. Erstelle Beat-Entwürfe in storyboard.json (Format im Skript-Header):
    { "title": "…", "subtitle": "Entwurf 1 · 16:9 · 60 s", "directions": ["A · …", "B · …"],
      "beats": [{ "t": "0.0–4.0", "still": "review/sketches/01.png", "picture": "…", "onscreen": "…",
                  "vo": {"A · …": "…", "B · …": "…"}, "sfx": "…", "why": "…", "claim": "…" }] }
    
    Bevor der Film existiert, kann still eine schnelle Skizze oder ein Frame aus der Referenz mit einer Notiz sein; danach immer ein ECHTER gerenderter Frame (node scripts/render.mjs --at …).
  3. Richtungen. Wenn der Blickwinkel offen ist, schreibe 2–4 Richtungen, die sich in der Idee unterscheiden, nicht in der Formulierung (z. B. „Tipps, die der Zuschauer nutzen kann“, „Das tägliche Ärgernis“, „Was deine KI bereits über dich weiß“). Für jede: eine einzeilige Idee, das Risiko und für wen sie geeignet ist. Setze deine Wahl an die erste Stelle.
  4. Baue die Seite:
    python3 ~/.claude/skills/film-storyboard/scripts/storyboard.py storyboard.json review/storyboard.html
    
    Sie öffnet sich mit dem Voiceover jeder Richtung als einen Absatz (die Augen-geschlossen-Leseprobe), dann jeder Beat mit seinem Frame.
  5. Selbstprüfung vor dem Senden: Lies nur den Transkript-Absatz. Ergibt er bei geschlossenen Augen Sinn? Gibt es eine Zeile, die falsch verstanden werden könnte? Gibt es eine „dein X, dein Y“-Liste, eine Triade oder ein wiederholtes Wort? Gibt es eine Behauptung ohne Beweis?
  6. Freigabe-Schleuse. Sende die Seite (SendUserFile, Render anzeigen) und frage: welche Richtung und welche Beats geändert werden sollen. Füge die Stufe-2-Fragen aus product-film/references/question-bank.md hinzu (Eröffnung, wie Rollen gezeigt werden, Personenformat, Charaktere, UI-Realität). Warte auf ein klares Ja. Committe storyboard.json.

Nach der Freigabe

Behalte storyboard.json als die Quelle der Wahrheit: Das Timing der Shots im Film und die Platzierung der Phrasen im Voiceover stammen beide daraus. Wenn der Eigentümer später einen Beat ändert, ändere ihn zuerst hier und generiere die Seite neu.

Individual skills in this repo

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

film-build

Build a product film in code as a deterministic seek(t) web page (real product UI, real OS chrome, kinetic text, typed prompts, a cursor, morphs and camera moves), review it as stills and drafts, render it at 60 fps with motion blur, and adapt it to 9:16 without changing 16:9. Ships a project kit (init.sh, film engine, render/sync/probe/sheet/regression tools). Stage 3 and 6 of product-film. Use when building, fixing or rendering the picture of a launch/promo film, or making its vertical version.

film-sound

Add sound to a finished product-film picture with real recorded sound effects (CC0 packs such as Kenney's) placed only on real on-screen events, decide with the owner whether there's a music bed, mix to -14 LUFS and mux into the renders without re-rendering. Stage 4 of product-film. Use when a film's picture is approved and needs sound effects or music, or when the owner says the sounds feel fake, synthetic or "AI slop".

film-voiceover

Write, review, test and record the voiceover for a product film after its picture is approved, as a script on a storyboard of the film's real frames, with directions to choose from, an eyes-closed coherence check, a pronunciation test for the product name, TTS recording per section (Fish Audio), phrase placement on the film's timeline, mixing and muxing. Stage 5 of product-film. Use when a launch/promo film needs narration, or the owner says the voiceover sounds like AI, doesn't match the frames, or mispronounces the name.

product-film

Make a product launch / promo / explainer film that sells and does not look or sound AI-made, through review gates the owner signs off one at a time. Study a reference video for its grammar (never copy it), then storyboard, build the film in code, add sound, write and record the voiceover, and deliver 16:9 and 9:16. Use when someone wants a launch video, promo, product film, explainer, ad, "a video like this one" for their product, or says the last video looked like "AI slop" or "vibe coded". Entry point for the film-* skills (film-reference-study, film-storyboard, film-build, film-sound, film-voiceover).

Verwandte Skills