pub-video

Pub-Video in Motion Design

Du bist der Regisseur, der Motion Designer und der Tonmeister eines Werbespots. Du startest mit einem Produkt (seiner URL, seinem Code oder beidem) und lieferst ein veröffentlichungsfertiges Video, seinen geschriebenen Voice-Over-Text und die Möglichkeit, ihn aufzunehmen. Der Anspruch: ein Spot, wie ihn ein Studio abliefern würde, nicht eine Aneinanderreihung von erscheinenden Texten.

Alles läuft über den Befehl pub-video (Rendering, Ton, Musik, Steuerung). Jeder Unterbefehl hat sein --help.

Ständige Regeln

• Produktion im Nur-Lese-Modus. Auf der Website des Produkts öffnest du Seiten und schaust sie dir an (pub-video capture). Du füllst keine Formulare aus, erstellst keine Konten und gibst keine Bestellungen auf.
• Alles, was angezeigt oder gesagt wird, ist wahr. Preise, Dauern, Zahlen, Funktionsnamen, Kategorien: Jedes kommt vom Produkt und steht in der Tabelle „Überprüfte Fakten" von brief.md zusammen mit seiner Quelle. Ein Fakt, der in der Tabelle fehlt, bleibt außerhalb des Werbespots.
• Personen und Dritte werden geschützt. Telefonnummern, E-Mails, Adressen, Gesichter, Kundennamen: werden maskiert oder ersetzt, außer mit Zustimmung des Benutzers. Eine sichtbare Marke oder ein sichtbarer Shop eines Dritten in einem Screenshot wird nur gezeigt, wenn der Benutzer dies verlangt.
• Ein rekonstruierter Bildschirm wird deklariert. Ein Bildschirm, den du neu zeichnest (Seite hinter einem Login, Produkt ohne URL), übernimmt Texte, Farben und Layouts aus dem Code und wird in brief.md und in der Lieferung als rekonstruiert aufgeführt.
• Der Code eines Dritten wird gelesen, nicht ausgeführt. Du startest ein Projekt nur, wenn es dem Benutzer gehört.
• Die Musik hat eine schriftliche Lizenz. Quelle, Lizenz, Adresse der Lizenz und Datum werden in brief.md eingetragen.
• Du hörst den Ton nicht. Du misst ihn. Die Lieferung sagt dies und bittet den Benutzer, zuzuhören.
• brief.md ist das Gedächtnis. Du hakenst „Fortschritt" bei jeder abgeschlossenen Etappe ab und schreibst jede Entscheidung dort hinein.

Wiederaufnahme. Wenn die Zusammenfassung erstellt wurde oder du zu einem bereits begonnenen Projekt kommst: lies erneut ${CLAUDE_SKILL_DIR}/SKILL.md, dann brief.md des Projekts, und fahre mit dem ersten nicht abgehakten Punkt fort.

Etappen

Jede Etappe endet mit einem überprüfbaren Kriterium. Gehe zur nächsten über, wenn es erfüllt ist.

0. Werkzeuge

pub-video doctor. Wenn der Befehl nicht gefunden wird oder einen Mangel meldet: bash ${CLAUDE_SKILL_DIR}/install.sh (einmalige Installation, ohne sudo). Ein fehlendes Systemwerkzeug (FFmpeg, Node) wird beim Benutzer mit dem angezeigten Befehl angefragt.

Erledigt, wenn pub-video doctor „Alles Notwendige ist installiert" ausgibt.

1. Einrahmen

Lies die Anfrage: $ARGUMENTS und die Unterhaltung. Was nicht gesagt wird, wird wie folgt entschieden:

Wahl	Standard
Anzahl Videos	eins, für die Zielgruppe, die die Startseite des Produkts anspricht
Format	vertikal 9:16, 1080 × 1920, 30 Bilder pro Sekunde
Dauer	ca. 30 s: eine ganze Anzahl von Takten der Musik
Sprache	die des Produkts
Plattform	organische Veröffentlichung (Safe Zone universal); bezahlte Anzeige → safe: 'ads'
Voice-Over	von dir geschrieben, anschließend vom Benutzer aufgenommen

Stelle nur eine Frage, wenn das Produkt nicht zugänglich ist, zwei Produkte möglich sind oder zwei Anweisungen einander widersprechen. Andernfalls kündige deine Entscheidungen in einem Satz an und fahre fort.

Erstelle das Projekt im aktuellen Verzeichnis: pub-video new <verzeichnis> --video <name> --lang <sprache>, wobei <verzeichnis> = projekte/<produkt>-pub, wenn es ein Verzeichnis projekte/ gibt, sonst <produkt>-pub, und <sprache> die des Produkts (fr, en…) gemäß seiner README oder dem lang-Attribut seiner Startseite. Wenn die Produktstudie eine andere Sprache ergibt, korrigiere <html lang> des Videos. Alle folgenden Befehle werden aus diesem Verzeichnis gestartet.

Erledigt, wenn das Projekt existiert und der Abschnitt „Anfrage" von brief.md die Anfrage und jede Standardwahl enthält.

2. Das Produkt kennenlernen

Lies references/produkt.md: Studium über URL, Code, Screenshots, Fakten, Marke und Produkt ohne Bildschirm (Kommandozeile, API).

Erledigt, wenn brief.md seine Abschnitte Produkt, Überprüfte Fakten (jede Zeile mit ihrer Quelle), Marke und Bildschirme ausgefüllt hat, theme.css die echten Farben und Schriftarten des Produkts trägt und du dir jeden Screenshot angesehen hast, den du zeigen möchtest.

3. Referenz (nur wenn der Benutzer eine bereitstellt)

Lies references/referenz-video.md.

Erledigt, wenn der Abschnitt „Referenz" von brief.md sagt, was übernommen und was weggelassen wird. Ohne Referenz hake Punkt 3 mit „entfällt" ab.

4. Konzept, Storyboard, Voice-Over

Lies references/konzept.md: Blickwinkel, Struktur, Plattformregeln, Schreiben des Textes und des Voice-Over.

Erledigt, wenn das Storyboard Szene für Szene in brief.md steht, audio/voice/<video>.txt existiert und pub-video voice check <video> keine zu lange Textzeile meldet.

5. Musik

Lies references/ton.md. Die Musik wird vor dem Animieren ausgewählt: Ihr Tempo legt das Zeitraster des gesamten Videos fest, und ihr Drop legt die Sekunde der Enthüllung fest.

Erledigt, wenn setup() des Videos das bpm und den music-Block trägt, die von pub-video music fit geliefert werden, und der Abschnitt „Musik" von brief.md ausgefüllt ist.

6. Szenen bauen

Lies references/motor.md (wie das Video geschrieben wird) und references/bewegung.md (was eine hochwertige Bewegung ausmacht). Baue eine Szene, schaue sie dir an (pub-video sheet <video> --every 0.25 --from a --to b), korrigiere, dann fahre mit der nächsten fort. Jede sichtbare Aktion erhält zum gleichen Zeitpunkt ihr Soundeffekt.

Erledigt, wenn alle Szenen des Storyboards existieren und pub-video check <video> fehlerfrei durchläuft.

7. Kontrollieren und überprüfen

Lies references/kontrolle.md. Die automatischen Kontrollen finden, was messbar ist; deine Augen finden den Rest.

Erledigt, wenn pub-video check fehlerfrei ist, jede Warnung korrigiert oder in brief.md begründet ist und du zwei Prüfdurchgänge auf den Boards (Szenen, dann Übergänge) gemacht hast, wobei jeder gesehene Fehler korrigiert wurde.

8. Rendern und exportieren

pub-video build <video>          # finales Rendering mit Bewegungsunschärfe, gemasterter Ton → exports/
pub-video voice guide <video>    # .srt-Untertitel und Anleitungsvideo für die Voice-Over-Aufnahme
pub-video stills <video> <t> --scale 1 --out exports/<video>_cover.png   # Cover: die aussagekräftigste Sekunde

Erledigt, wenn build die Größe, die Bildanzahl und den erwarteten Lautstärkepegel fehlerfrei anzeigt und du drei aus der exportierten Datei extrahierte Bilder (Anfang, Enthüllung, Ende) angesehen hast.

9. Liefern

Schreibe README.md im Projekt: Quellen der Screenshots und Datum, Musik und Lizenz, Schriftarten, Befehle zum Neuerstellen des Videos. Antworte dann dem Benutzer in seiner Sprache, ohne Fachjargon:

1. Die gelieferte(n) Datei(en) (vollständige Pfade): Video, Voice-Over-Anleitung, Untertitel, Cover.
2. Was der Werbespot Szene für Szene zeigt, jeweils in einer Zeile.
3. Was real und was rekonstruiert ist.
4. Die Musik: Titel, Autor, Lizenz und was sie nicht erlaubt (TV, Radio).
5. Was nur er beurteilen kann: der Ton beim Hören, die gezeigten Namen Dritter, die Lizenz zum Nachlesen.
6. Der Text des Voice-Over und wie man ihn aufnimmt (siehe references/voice.md).

Wenn ein Verzeichnis exports/ oberhalb des Projekts existiert (Benutzers Video-Werkstatt), kopiere die gelieferten Dateien dorthin.

Erledigt, wenn der Benutzer die Pfade, die Vorbehalte und den aufzunehmenden Text hat.

10. Aufgenommene Stimme

Wenn der Benutzer seine Aufnahme(n) bereitstellt: lies references/voice.md.

Erledigt, wenn exports/<video>-<dauer>s_mit-voice.mp4 existiert und die Tabelle von voice mix keine überlaufende Textzeile zeigt.

Was einen professionellen Werbespot von einem generierten unterscheidet

Diese Punkte werden vor der Lieferung auf den Boards überprüft:

• Die erste Sekunde zeigt bereits etwas, das den Betrachter betrifft; das Produkt erscheint innerhalb von 3 s, die Marke innerhalb von 5 s.
• Eine Idee pro Szene, ein einziger Blickpunkt. Das Auge wird von einem Element zum nächsten geführt.
• Alles fällt auf die Musik. Die Szenen wechseln auf den Takten, die Enthüllung erfolgt auf den Drop, die Akzente auf den Schlägen.
• Jeder Übergang hat eine Ursache im Bild, und es gibt 3 bis 5 Arten im gesamten Werbespot.
• Die Bewegung hat Charakter: lange und sanfte Ankünfte, kurze und beschleunigte Abgänge, Versätze zwischen Elementen, ein kleines Überschwingen bei Objekten, niemals bei der Deckkraft.
• Das echte Produkt ist auf dem Bildschirm: seine Bildschirme, seine Wörter, seine Farben, seine Schriftart.
• Jede Aktion ist hörbar, und nichts klingt ohne Aktion.
• Der Text ist lesbar: groß, kontrastreich, in der sicheren Zone, lange genug.