Communitygithub.com

Film-Build

Erstelle ein Produktfilm in Code als deterministische seek(t)-Webseite (echtes Produkt-UI, echtes OS-Chrome, kinetischer Text, getippte Eingabeaufforderungen, ein Cursor, Morphs und Kamerabewegungen), überprüfe es als Standbilder und Entwürfe, rendere es mit 60 fps und Bewegungsunschärfe und passe es an 9:16 an, ohne das 16:9-Format zu ändern. Liefert ein Projekt-Kit (init.sh, Film-Engine, Render-/Sync-/Probe-/Sheet-/Regression-Tools). Stufe 3 und 6 von product-film. Verwende es beim Erstellen, Korrigieren oder Rendern des Bildmaterials eines Launch-/Promo-Films oder beim Erstellen seiner vertikalen Version.

Was ist Film-Build?

Dieses Skill ermöglicht es, einen Produktfilm vollständig in Code zu definieren und als deterministische, suchbare (seek(t)) Webseite darzustellen. Es basiert auf einer leistungsstarken Engine (`scene`, `put`, `reg`) und bietet eine Reihe von Hilfsfunktionen für realistische UI-Elemente (echtes Betriebssystem-Chrome, reale Produktschnittstellen), kinetischen Text, getippte Eingaben, Cursor-Animationen, Morphs und flüssige Kamerafahrten. Das Projekt-Kit enthält alles Nötige: eine initialisierungs-Shell (`init.sh`), ein Film-Grundgerüst (`film.js`), Mock-Daten für UI-Komponenten, sowie Werkzeuge zum Rendern (auch mit 60 fps und Bewegungsunschärfe), Synchronisieren, Überprüfen (Kontaktabzüge, Standbilder) und für Regressionstests (PSNR-Vergleiche). Ein besonderes Merkmal ist die integrierte Unterstützung für zwei Formate: Der Film kann in einer einzigen Datei für 16:9 und 9:16 (z. B. für soziale Medien) definiert werden, wobei `pk()` die formatabhängigen Werte wählt und spezielle Werkzeuge sicherstellen, dass das 16:9-Bild unverändert bleibt. Die Engine ist streng deterministisch – sie verbietet Zufallszahlen, CSS-Übergänge und nicht initialisierte Opacity-Werte, um pixelgenaue, reproduzierbare Ergebnisse zu garantieren. Der Arbeitsablauf ist stark überprüfungsgetrieben: Zuerst werden aus einer Liste von Schnittpunkten Standbilder gerendert und als Kontaktbogen geprüft, dann folgen QA-Durchläufe, ein Draft-Render (30 fps, ~4 Minuten) und schließlich das finale 60-fps-Rendering mit Bewegungsunschärfe (~25–35 Minuten für 60 Sekunden). Das Skill eignet sich besonders für Entwickler, die Launch- oder Promo-Filme direkt aus Code erstellen, korrigieren oder an vertikale Formate anpassen möchten.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Film-Build?

Start

sh ~/.claude/skills/film-build/kit/init.sh marketing/videos/<film>   # lehnt einen nicht leeren Ordner ab
cd marketing/videos/<film> && npm i && npx playwright install chromium   # falls NEXT angezeigt wird

Das Kit enthält:

DateiBeschreibung
film/core.jsDie Engine: scene({name, from, to, build, run, after}) (Zeiten in Beats = s × 2), put(el, {o, css}), reg(el, base), C.W/C.H/C.FMT, C.start()
film/film.jsEin Starter mit allen untenstehenden Hilfsfunktionen und vier Beispiel-Shots (Linie, Eingabeaufforderung, Split, Persona-Karte). Jeder Hilfsfunktions-Kommentar gibt an, von welcher Ablehnung sie stammt. Ersetze die Shots, behalte die Hilfsfunktionen.
film/mock.jswindow.MOCK: HTML für echte UI-Teile (Dashboards, Fenster, Telefonbildschirme), in Bildschirm-Px
film/index.htmlLädt Schriftarten aus assets/fonts/{display,ui}.woff2 (mit lokalen Sans-Fallbacks)
scripts/render.mjs--sheet, --at t1,t2, --draft, --range a,b, --verify, final, --mux, --fmt 9x16, --all
scripts/sync.mjsKopiert timeline.json in die Seite
scripts/review.pyKritik-Kit aus dem gerenderten MP4: Kontaktabzug, Streifen der höchsten Aktivität, Telefonansicht, 9:16-Sicherheitszonen, Metriken
tools/probe.mjscuts (jeder Schnitt und Mittelpunkt jedes Shots, in Videosekunden) oder jeder Ausdruck, z. B. "window.UNWARP(12.4)"
tools/sheet.pyOrdne Standbilder zu einem beschrifteten Blatt an
tools/pack_grid.pySchneide ein 4×3-Charakterblatt (transparent oder auf weiß) in einen 12-Zellen-Streifen für sprite(); gibt die Zellengröße aus
tools/cut_cast.pyZerlege eine einreihige Aufstellung in einzelne Standbild-Charaktere
assets/characters/Vier Beispielcharaktere (Gründer, Entwickler, Verkäufer, Student), 12-Frame-Streifen mit 360-Px-Zellen
tools/same.shsave / check PSNR-Regression zwischen Vorher- und Nachher-Standbildern

Hilfsfunktionen im Starter (verwende sie, erfinde sie nicht neu)

  • io (quintisch rein-raus) für Kamerafahrten und Morphs; oq (quintisch raus) für Eingänge; back für einen kleinen Überschwinger.
  • cam(e, s, fx, fy) setzt den Fokuspunkt (fx, fy) einer 1920×1080-Ebene bei Skalierung s in die Bildmitte. camD macht dasselbe, zeigt aber nie über die Ebenenkanten hinaus (Cover-Skalierung; bei 9:16 unerlässlich).
  • posIn(e, root) liest die Position eines Elements innerhalb der bewegten Ebene (für Cursor-Ziele, Caret-Verfolgung).
  • typed() für Buchstaben, die nacheinander in einer Zeile erscheinen; keyed() für eine echte Tastatur: unregelmäßiges Timing pro Zeichen, längere Pausen bei Leerzeichen, ein blinkendes Caret danach.
  • wordsHTML() legt jedes Wort ab dem ersten Frame in seiner endgültigen Breite an, transparent bis zu seinem Zeitpunkt, sodass die Zeile nie umfließt („Textübergang ist überhaupt nicht flüssig“).
  • cursor()/putCursor()/bump(): Ein echter Pfeilcursor, der gleitet, früh ankommt, bei einem Klick um 15% eintaucht.
  • pop() für kleine Objekte, die landen.
  • sprite(parent, src, cellW, cellH, h) / putSprite(e, t, a, z, loops) für einen gezeichneten Charakter: Durchläuft seine 12 Frames von a bis z, mit einem kleinen Atemzug, damit er nie stillsteht. Es ist ein <img>, also wartet die Engine darauf.
  • shot(name, t0, t1, build, run) kapselt scene in Sekunden.
  • Tempowechsel unten: SLOW (globale Dehnung), EV hält (friert einen Moment zum Lesen ein) und Einfügungen; window.CUTS und window.UNWARP geben Videosekunden für Ton- und Sprachplatzierung.
  • PT / pk(a16, a9) wähle formatabhängige Werte in einer Datei.

Regeln der Engine (Determinismus)

Der Film ist eine reine Funktion von t. Jeder Frame muss identisch aussehen, egal ob er zuerst oder nach jedem anderen Frame gerendert wird.

  • Nur 2D-Transformationen: kein translate3d, kein will-change, keine CSS-Transitions, kein Math.random (verwende einen Hash eines Index).
  • Zu Beginn versteckte Elemente: reg(el, {o: 0}), niemals opacity:0 inline.
  • Layout in after() oder einmal in build messen, niemals innerhalb von run (es liest den vorherigen Frame).
  • 3D-Ansichten: Jeden Frame mit insertBefore(v, firstChild) neu einfügen, damit kein gecachtes Raster überlebt.
  • Eingebettete CSS-Animationen (z. B. ein Produkt-Widget-Eigen): Sie pausieren und setzen animation-delay: calc(-1s * var(--t)).
  • Warte auf Bilder und Schriftarten (decode(), document.fonts.ready) vor dem ersten Frame.
  • Produkt-CSS unter einer eindeutigen Root-Klasse zusammenfassen; verwende eindeutige Klassennamen im Film (.w ist einmal durchgesickert).
  • classList.add, niemals className =.
  • node scripts/render.mjs --verify muss vor jedem versendeten Render 12/12 ausgeben.

Realismus: Lies references/realism.md vor dem Erstellen eines Bildschirms

Kurzfassung: Echte Apps in echter Dichte, echte Logos von den Websites der Marken, OS-Chrome mit Apps, die auf diesem Betriebssystem existieren, echte Hintergrundbilder, Telefone auf dem echten Launcher-Raster in echten dp-Größen, gezeichnet vom eigenen Renderer des Produkts, Produkt-UI reichhaltiger als du denkst, eine nominative Nutzungszeile, wann immer ein Markenzeichen gezeigt wird.

Build-Schleife (überprüfungsgesteuert)

  1. Shot-Liste vom genehmigten Storyboard in film.js, jeder als shot(), überlappend für Übergaben.
  2. Zuerst Standbilder. node tools/probe.mjs cuts → Rendere ein Standbild an jedem Shot-Mittelpunkt und jeder Übergabe: node scripts/render.mjs --at … dann python3 tools/sheet.py review/stills/16x9 review/sheet.jpg <times>. Lies das Blatt selbst. Korrigiere. Wiederhole. (Ca. 1–2 Minuten pro Runde, gegenüber 25+ für einen vollständigen Render.)
  3. QA-Durchlauf VOR jedem versendeten Review: Gehe den Film bei ≤ 1,5 s und an jeder Übergabe durch (10–15 fps Kontaktabzug über jeden Übergang). Überprüfe references/qa.md Zeile für Zeile: Überlappungen, Clipping, leere Frames, Lesezeit, Textglätte, Tippen, Logohinweis, OS-Realismus, Telefongrößen.
  4. Sende Standbilder (das Blatt) an den Eigentümer für den ersten Blick. Warte.
  5. Entwurf: node scripts/render.mjs --draft (30 fps, ~4 Min.), python3 scripts/review.py 1 --draft, lies die Streifen. Sende das Entwurfs-MP4. Sage klar, dass es ein 30-fps-Entwurf ohne Unschärfe ist (sieht ruckeliger aus als das Endergebnis).
  6. Bei „Render final“: node scripts/render.mjs im Hintergrund (60 fps, Bewegungsunschärfe; ~25–35 Min. für 60 s). Bearbeite film.js niemals während des Renderings: Kopiere zuerst das Projekt, wenn du weiterarbeiten musst.
  7. Comitte Film-Code und Zeitachse nach jeder genehmigten Runde.

Tempo

Erste Schnitte sind fast immer zu schnell. Bildschirmtext benötigt etwa 0,3 s pro Wort + 1 s bei voller Deckkraft (niemals unter 1,5 s). Bevorzuge die Verzerrung (SLOW 1,1–1,25, EV hält bei Zeilen) gegenüber der Neujustierung jedes Shots. Nach jeder Tempowechsel führe probe.mjs cuts erneut aus, da sich Ton und Sprachpositionen verschieben.

9:16: Lies references/formats.md

Bilde denselben Film in einer Datei mit pk() neu ein; beweise mit tools/same.sh, dass 16:9 unverändert bleibt (jedes Standbild PSNR = inf); --verify --fmt 9x16; Standbildblatt für den Eigentümer; dann --fmt 9x16 final im Hintergrund, dann --mux --fmt 9x16.

Individual skills in this repo

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

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-storyboard

Write the story of a product film as beats (what the viewer sees, the words on screen, the voice, the sound, why the beat exists, and where each claim is proven) and send it to the owner as a one-page storyboard with frames for review, with 2–4 directions when the story is open. Stage 2 of product-film, and the review format reused for the voiceover. Use when planning a launch/promo film's story, shot list, or script, or when the owner says "give me a storyboard", "give me directions", "I'll review and decide".

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