Communitygithub.com

Produktfilm

Erstelle einen Produkt-Launch-, Werbe- oder Erklärfilm, der verkauft und nicht nach KI wirkt – mit Freigabeschritten, die der Eigentümer einzeln abzeichnet.

Was ist Produktfilm?

Dieses Skill beschreibt einen strengen, iterativen Workflow zur Erstellung eines professionellen Produktfilms, der vermeidet, wie KI-generierter „Slop“ auszusehen. Der Kernansatz ist der eines „Review-Gates“: Der Eigentümer genehmigt jeden Schritt, bevor der nächste beginnt, um sicherzustellen, dass das Endprodukt genau den Anforderungen entspricht. Es integriert mehrere Sub-Skills (film-reference-study, film-storyboard, film-build, film-sound, film-voiceover) in eine Pipeline von der Briefing-Phase bis zur Auslieferung in 16:9- und 9:16-Formaten. Der Fokus liegt auf Realismus (keine synthetischen Elemente, echte Produktfunktionen, echte Logos), Spezifität (keine generischen Beschreibungen) und der Perspektive des Zuschauers. Jeder Schritt hat klare Regeln, um typische Fallstricke zu vermeiden, die Filme wie KI-Arbeit aussehen lassen, wie z. B. generische Optionen oder synthetische Soundeffekte. Entscheidungen werden dem Eigentümer als konkrete Wahlmöglichkeiten mit Kosten/Risiken präsentiert, nicht als offene Fragen. Der Workflow ist deterministisch (render.mjs --verify) und erfordert häufiges Committen sowie kleine, ehrliche Berichte über den Überprüfungsstatus. Nach Abschluss werden Lektionen in einer zentralen Datei dokumentiert, um ähnliche Fehler in zukünftigen Projekten zu vermeiden.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Produktfilm?

Ein Produktfilm wird zuerst von einer Person beurteilt: dem Eigentümer. Er korrigiert, was falsch ist, du behebst es, und der Film wird Runde für Runde besser. Dieses Skill existiert, damit die Korrekturen des Eigentümers unnötig werden: Jede Regel hier stammt aus einer Korrektur, die jemand von Hand vornehmen musste. Lies references/lessons.md, bevor du beginnst, und noch einmal vor jeder Überprüfung, die du sendest. Es ist das Protokoll darüber, was Eigentümer abgelehnt haben und warum.

Die Pipeline und ihre Tore

Nichts geht zur nächsten Stufe über, bis der Eigentümer die aktuelle genehmigt hat. Genehmigung ist ein klares Ja im Chat, nicht Schweigen und nicht „sieht gut aus, aber …“. Sende nach jeder Änderung, die der Eigentümer verlangt, zur erneuten Überprüfung zurück.

StufeSkillDu sendest zur ÜberprüfungTor
0 · Briefingdieses hierdas Briefing: Produkt, Käufer, die eine Sache, von der sie überzeugt werden sollen, Länge, Formate, wo es abgespielt wirdEigentümer genehmigt das Briefing
1 · Referenzfilm-reference-studywas die Referenz tut und was übernommen werden soll, als Zahlen und FramesEigentümer stimmt zu, was übernommen wird und was nicht
2 · Storyboardfilm-storyboardeine Storyboard-Seite: ein Frame pro Beat, Text auf dem Bildschirm, warum jeder Beat da ist; 2–4 Richtungen, wenn die Geschichte offen istEigentümer wählt eine Richtung und genehmigt die Beats
3 · Bildfilm-buildzuerst Standbilder, dann ein 30-fps-Entwurf, niemals zuerst einen finalen RenderEigentümer genehmigt das Bild („Render final“)
4 · Tonfilm-sounddas Finale mit Soundeffekten und die MusikentscheidungEigentümer genehmigt den Ton
5 · Voiceoverfilm-voiceoverdas Skript auf einem Storyboard mit ECHTEN Frames, dann Namens-Tests, dann der vertonte SchnittEigentümer genehmigt Skript, Aussprache, dann den Schnitt
6 · Formatefilm-build (Formate)9:16-Standbilder, dann der 9:16-RenderEigentümer genehmigt; 16:9 nachweislich unverändert
7 · Auslieferndieses hierdie Dateien, Untertitel, Credits, was nicht verifiziert isterledigt

„Vor dem Rendern lass mich überprüfen“: Der Eigentümer möchte den Plan und die Standbilder sehen, bevor du 30 Minuten für einen Render aufwendest. Ein finaler Render ohne genehmigten Entwurf ist verschwendete Zeit und verschwendet ihr Vertrauen.

Wie man fragt (jedes Tor)

Stelle an jedem Tor konkrete Wahlmöglichkeiten statt offener Fragen und mach jede Option zu etwas, das ein echter Editor wählen würde. Generische Optionen („modern“, „sauber“, „dynamisch“) sind der Grund, warum ein Film zu KI-Slop wird. references/question-bank.md enthält die Fragen und Optionen für jede Stufe: Look, Bewegung, Tempo, Übergänge, Tippen, Charaktere, Ton, Musik, Stimme, Auslieferung. Regeln:

  • Zwei bis vier Optionen pro Frage, jede mit dem, was sie aussieht oder klingt, und ihren Kosten oder Risiken. Setze deine Wahl an die erste Stelle und begründe sie in einem Satz.
  • Frage nur nach Dingen, die die Arbeit verändern. Entscheide den Rest basierend auf der Marke und der Referenz und sag, was du entschieden hast.
  • Wenn der Eigentümer laut über Ideen nachdenkt, setze sie nicht sofort um. Recherchiere, dann komm mit 2–4 Richtungen und ihren Abwägungen zurück und lass ihn wählen („gib mir einige Richtungen mit den Abwägungen, damit ich entscheiden kann“).
  • Wenn der Eigentümer sagt „warte, ich sage dir mehr“, halt an und warte. Bearbeite nicht weiter.
  • Wenn eine Korrektur kommt, finde die Regel dahinter und überprüfe den gesamten Film auf denselben Fehler, nicht nur die eine Stelle, auf die sie hingewiesen haben.

Regeln, die in jeder Stufe gelten

  1. Nur echt. Jede Funktion, jedes Widget, jeder Bildschirm, jede Zahlenquelle und jede Behauptung im Film funktioniert heute im Produkt. Wenn der Film etwas braucht, das das Produkt nicht kann, bau es entweder ins Produkt ein (und protokolliere die Entscheidung) oder lass es weg. Jede gesprochene oder gezeigte Behauptung hat eine Quelle, auf die du verweisen kannst (eine Datei, ein Dokument, ein Test).
  2. Spezifisch, nicht generisch. Echte Logos von den Websites der Marken. Echte OS-Chrome mit Apps, die auf diesem OS tatsächlich existieren. Echte Gerätegrößen. Echte Hintergrundbilder (lizenziert). Reichhaltige, detaillierte Produkt-UI: „zu einfach“ wird als „warum sollte ich dafür bezahlen“ gelesen. Siehe film-build/references/realism.md.
  3. Die Perspektive des Betrachters. Der Film ist für einen Fremden, der noch nie vom Produkt gehört hat. Teste jeden Beat: Würden sie ihn verstehen? Könnten sie ihn falsch verstehen (z. B. denken, das Produkt SEI die KI)? Geht es um ihr Leben oder um unsere Funktionen?
  4. Nicht KI-gemacht. Keine synthetischen Pieptöne, keine minimalistischen Mockups, keine Icon-Font-Nachahmungen echter Marken, keine Triaden und „dein X, dein Y“-Kopien, kein szenenbeschreibendes Voiceover. Eigentümer kennen diese Verräter, und ihre Käufer auch. Ein Konkurrent wurde öffentlich für ein Launch-Video kritisiert, das „mit Claude gemacht“ aussah.
  5. Lesbar und flüssig. Jede Zeile bleibt lange genug stehen, um sie bis zum Ende zu lesen. Das Tippen sieht aus wie eine Tastatur. Nichts cliped, überlappt oder blinkt leer. Tempo für Menschen: Erste Schnitte sind fast immer zu schnell.
  6. Determinismus. Der Film ist eine reine Funktion der Zeit; render.mjs --verify muss bestehen, bevor du einen Render sendest.
  7. Kleine, ehrliche Berichte. Wenn du eine Überprüfung sendest, sag, was sich geändert hat, was noch offen ist und was du nicht überprüfen konntest (du kannst kein Audio hören: sag es und frage). Bezeichne niemals etwas als verifiziert, das du nicht überprüft hast.
  8. Häufig committen (Code, Skripte, Storyboard, VO-Skript). Renders, Audio und Standbilder bleiben außerhalb von Git.

Projektstruktur

<film>/
  brief.md                 Stufe 0
  reference/               Studienausgabe (Frames, Blätter, summary.md, NOTES.md)
  storyboard.json          Stufe 2 Quelle → review/storyboard.html
  film/                    die Filmseite (core.js, film.js, mock.js, index.html)
  scripts/ tools/          Render, Sync, Sound, Voice, Mix, Probes (aus dem Baukasten von film-build)
  timeline.json vo.json    Bildtiming und Sound-Cues; Voiceover-Phrasen
  VO-SCRIPT.md             das genehmigte Voiceover mit Quellenangabe für jede Behauptung
  assets/                  Schriftarten, Logos, Hintergrundbilder, SFX, Charaktere, CREDITS.md
  renders/ audio/ review/  (git-ignoriert)

Beginne mit sh ~/.claude/skills/film-build/kit/init.sh <film>.

Stufe 0 · Briefing

Bevor irgendetwas anderes passiert, schreibe brief.md und lass es genehmigen:

  • Produkt, in einem Satz, den ein Fremder versteht. Nicht der Slogan.
  • Wer kauft, in ihren Worten. Mehrere Arten von Personen, wenn das Produkt mehrere bedient (Personas): Was jede von ihnen täglich prüft oder braucht.
  • Die eine Sache, von der der Film sie überzeugen muss, und das eine Missverständnis, das er verhindern muss.
  • Verfügbare Beweise: Was heute real ist, was gebaut und aufgezeichnet wurde, was gezeigt werden darf.
  • Länge und Formate: Ein Launch-Film, der Reichweite zeigt, braucht etwa 45–65 s. 20 s sind zu kurz, um mehrere Personen und ihre Anwendungsfälle zu zeigen. Formate: zuerst 16:9, dann 9:16, es sei denn, der Eigentümer sagt etwas anderes.
  • Wo es abgespielt wird (Site-Hero, X, Reels, YouTube) und die Markenregeln (Farben, Schriftart, niemals zu verwendende Wörter, Logos).
  • Als was das Produkt niemals gezeigt werden darf (z. B. „niemals als Dock“) und jeder Wettbewerber, der gemieden werden muss.

Stufe 7 · Ausliefern

  • renders/16x9.mp4 und renders/9x16.mp4 (60 fps, Bewegungsunschärfe, Stimme und Ton gemuxt).
  • assets/CREDITS.md: jedes Hintergrundbild, Logo, jede Schriftart, jeder Sound und jeder Charakter, mit seiner Lizenz.
  • Wenn Marken erscheinen: ein Hinweis zur nominativen Verwendung auf dem Bildschirm, während sie gezeigt werden („Produktnamen und Logos gehören ihren Eigentümern …“).
  • Eine einfache Liste dessen, was nicht verifiziert ist (z. B. „die vier Anfragen wurden noch nicht in der echten App gebaut“).
  • Untertitel und ein Thumbnail, falls gewünscht (nutze die Social-Media- und Copywriting-Fähigkeiten des Eigentümers; keine KI-Ver-Räter).

Nach dem Film

Füge jede neue Korrektur, die der Eigentümer gemacht hat, in references/lessons.md hinzu, unter der Stufe, zu der sie gehört, mit dem, was falsch war, und der Regel, die es verhindert. Diese Datei ist der Grund, warum der nächste Film diesem einen voraus ist.

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

Verwandte Skills