Communitygithub.com

site-promo-film

Zeigt einem Agenten, wie ein „Site-Promo-Film“ geplant, erstellt oder geschnitten wird, sodass das konkrete Ergebnis ein fertiger Videoschnitt ist. Der Ablauf umfasst: Produkt-Promo-Film, gerendert als Code, Studio: das Briefing in einem Fenster, Geführter Modus: `?`. Verwende es, wenn eine neue Aufgabenstellung diese Disziplin erfordert.

Was ist site-promo-film?

Diese Fähigkeit befähigt einen KI-Agenten, vollständige Produkt-Promo-Filme als Code zu erstellen. Das Kernkonzept ist, dass ein Film als reine Funktion definiert wird – `seek(t)` zeichnet den Frame zum Zeitpunkt `t` von Grund auf neu. Headless Chrome erfasst mehrere Subframes pro Frame, und ffmpeg mischt und codiert sie zu einem Video. Dies macht jeden Frame überprüfbar, jede Änderung kostengünstig und die Schleife exakt. Die Fähigkeit wird mit einem umfangreichen Satz von Vorlagen ausgeliefert, darunter eine Engine (`promo.html`), ein langes Filmmuster (`reel.html`), sowie Module für Vektorteile (`parts.js`), visuelle Effekte (`fx.js`), Typografie (`type.js`) und zahlreiche Hilfsskripte zum Rendern, Vertonen, Mischen und Ausliefern. Die Einrichtung erfordert ein Arbeitsverzeichnis und die Installation von `playwright-core`. Das „Studio“ bietet eine grafische Benutzeroberfläche, um das Briefing zu erstellen, während der „Geführte Modus“ den Agenten interaktiv durch den Prozess führt. Die Fähigkeit unterstützt die Plattformen macOS (mit `playwright-core` und Chrome) und ist für Entwickler gedacht, die präzise, reproduzierbare und über Code versionierbare Produktvideos erstellen möchten.

Funktioniert mit✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/gfazioli/manovella/tree/HEAD/plugins/manovella/skills/site-promo-film

In Ihrer bevorzugten KI fragen

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

Dokumentation

Produkt-Promo-Film, gerendert als Code

Eine Seite, eine Leinwand, und seek(t) zeichnet den Frame zum Zeitpunkt t von Grund auf neu. Headless Chrome erfasst N Subframes pro Frame, ffmpeg mischt und codiert sie. Der Film ist eine Funktion; das Video ist eine Abtastung davon – was jeden Frame überprüfbar, jede Änderung kostengünstig und die Schleife exakt macht.

Diese Dateien werden mit dieser Fähigkeit ausgeliefert. Kopiere sie in den Arbeitsordner des Films; schreibe die Engine nicht neu.

DateiWas es ist
template/promo.htmlDie Engine plus eine 8-Sekunden-Demo: geschlossene Formfedern, Summen-von-Federn-Tracks, eine Kamera, Texthilfsprogramme (tabellarische Ziffern, Flip), Schlagzeilen, einen echten Cursor, eine Ein-Objekt-Morph-Kette und einen WebGL-Compositor für echtes 3D. Öffnet und rendert sofort.
template/reel.htmlEin langer Film auf einer Zeitleiste: sechs Szenen, sechs Formate (kinetischer Text, ein Browser, ein Bento-Raster mit Fokusverlagerung, ein Terminal, ein 3D-Coverflow von Geräten, eine Endkarte), fünf Übergänge, ein Look pro Szene, Kapitel. ~56 s, kein Loop. Der Katalog von §2, in Aktion.
template/film.jsDie Engine, die die Seiten gemeinsam nutzen: die Bühne (Subpixel-Jitter pro Subframe, sodass bei langsamen Bewegungen nichts stufenweise oder flimmert), FILM.draw für Raster, Federn und Kameras, die Zeitleiste (Szenen, Kapitel, Checkpunkte und vierundzwanzig Übergänge: sechzehn auf der 2D-Leinwand, acht als Fragment-Shader in einem WebGL2-Kontext) und Effekte (Tiefenschärfe, Ausschnitt-Text, Schreibmaschineneffekt). Oben dokumentiert.
template/parts.jsVektorteile: ein macOS-Fenster, ein Browser, ein Terminal, ein iPhone, ein iPad, ein MacBook, ein iMac, Tastenkappen, ein Schalter, ein Ring, eine Schaltfläche, der Zeiger. Jedes gibt das Rechteck zurück, in das sein Inhalt passt.
template/parts.htmlJedes Teil auf einem 16:10-Blatt, eine Seite wie die anderen: PAGE=parts.html node render.mjs stills parts 0 erstellt das PNG, aus dem docs/parts.jpg konvertiert wird (sips -s format jpeg -s formatOptions 92).
template/fx.jsDer Look, geladen von der Seite: ein Hintergrund (einfarbig, Verlauf, Feld oder Bild; sanftes Markenlicht; Punkte, Raster oder Linien in Parallaxe; ein Boden in Perspektive; ein Scheinwerfer), ein Finish (Vignette, Körnung) und die darauf aufbauenden Effekte (Milchglas, Klickwellen, Fokus-Pull-Schlagzeilen). Dreiundzwanzig Voreinstellungen und photo, jedes Feld überschreibbar, oben in der Datei dokumentiert. Geteilt mit release-film.
template/type.jsSchlagzeilen und kinetischer Text (§3): TYPE.draw(ctx, t, spec) in dreizehn Stilen – rise, focus, settle, track, wipe, cascade, weight, split, flap, type, swap, odometer, decode – mit einem Betonungszeichen, einem Tempo und TYPE.load für die Schriften einer Familie. Eine reine Funktion von t, wie der Rest.
template/fonts/Zwanzig frei lizenzierte Familien (latin + latin-ext woff2, jeweils mit OFL.txt) und fonts.json, ihre Schriften. Ein Film kopiert nur das, was er verwendet, nach src/fonts/; scripts/fonts.mjs add holt eine weitere.
scripts/render.mjsstills <dir> t…, sheet <dir> (die Checkpunkte der Zeitleiste), looks <dir> <t>, loopcheck, video <out> [workers]. Liest Größe, fps, Dauer und Kapitel aus der Seite; jittert jeden Subframe; rendert in fortsetzbaren Blöcken; FROM/TO, PREVIEW=1, RESUME=1, KEEP=1, AUDIO=, SHUTTER=; die Erweiterung wählt das Format (.mp4, .mov ProRes, .webm, .gif; HEVC=1; ALPHA=1 für ein transparentes .mov oder .webm); prüft den Track vor dem Rendern und die Datei danach; schlägt fehl bei einer Aufnahme, deren Seite einen WebGL-Kontext verloren hat, und bei einem zweiten Rendern eines Schnitts, während einer läuft. Oben dokumentiert.
scripts/narrate.mjsDie Geschichte eines Films (story.json: ein Satz pro Schritt, das Tutorial oder das Promo, das spricht) in eine Stimme, eine Uhr und Untertitel: voice/*.aiff, narration.wav (das AUDIO des Films), narration.js (die Zeit jedes Schrittes, für die Seite) und captions.srt / .vtt. Das say des Macs, oder --from einen Ordner mit eigenen Aufnahmen. "human": "natural" variiert die Pausen wie bei einem Menschen; die Laute eines Modells ([chuckle]) bleiben aus den Untertiteln. Oben dokumentiert.
scripts/voice.mjsDieselbe Geschichte, erzählt von einem Sprachmodell, das auf dem Mac läuft ("mlx" in story.json: Chatterbox für eine Lektion, Orpheus für ein Promo, Kokoro für einen schnellen Entwurf oder einen Film auf Italienisch), näher an einem Menschen als say: es sagt jeden Schritt (voice-mlx.py, über mlx-audio), taktet und pegelt es, ruft dann narrate.mjs auf. Ein Take ist ein Seed; "tone" (calm, warm, bright) bestimmt, wie frei das Modell liest, "human" variiert das Tempo jeder Zeile innerhalb von 3 % und lässt eine Zeile einen Laut machen ([chuckle], [sigh]: die eigene Schreibweise jedes Modells, oder weggelassen). --audition vergleicht Takes, --recordings stoppt bei den Aufnahmen, --setup erstellt das Python und holt die Modelle einmal auf jedem Mac (voice-constraints.txt fixiert, was es installiert) und sagt, ob dieser Mac die hier aufgenommenen Takes wiederholt. Oben dokumentiert.
scripts/mix.mjsEine Stimme und eine Musikspur zu einem Soundtrack, für AUDIO=: beide gemessen (EBU R128), die Musik --under LU unter der Stimme, während sie spricht, --lift dB zwischen den Zeilen an, herunter vor jeder Zeile; gibt aus, was dabei herauskam, gemessen am Ergebnis. Oben dokumentiert.
scripts/contact.mjsEin beschriftetes Kontaktblatt eines Stills- oder Looks-Ordners (Beschriftungen aus labels.json darin); --size BxH macht es genau diese Größe (--font, --gap, --pad; Stills werden nie beschnitten; eine .jpg wird als JPEG geschrieben); --dark für ein dunkles Blatt. --compare A=<verz> B=<verz> [C=<verz>] <aus.png>: zwei oder drei Ordner nebeneinander, eine beschriftete Spalte pro Ordner und eine Zeile pro Still, das sie gemeinsam haben, für eine A/B-Auswahl an einem Bild.
scripts/beats.mjsDer Beat eines Soundtracks, aus seinen Samples: Tempo, ob er durchhält, jeder Beat, die Takte, die Abschnitte und die bpm und AUDIO_AT für die Seite; --out beats.js für eine Seite, die einem drifternden Track folgt (FILM.beats). render.mjs importiert es, um die Beats der Seite gegen die des Tracks zu messen. --selftest.
scripts/clickcheck.mjsWird jeder Klick gesehen: für jeden der CLICKS der Seite, wie schnell sich der angeklickte Punkt auf dem Bildschirm bewegt und wie weit der Cursor vor dem Drücken und währenddessen reist. Beende mit 1 bei einem Klick, den niemand sehen wird (release-film §3b), mit 2 bei einer Seite ohne Cursor.
scripts/layoutcheck.mjsIst jede Schlagzeile im Rahmen, getrennt und lesbar: an jedem Checkpunkt, jede Schlagzeile, die TYPE.draw zeichnet, gegen den Safe-Bereich, die anderen Schlagzeilen und den Hintergrund darum (die Grenzen sind im Header). Beende mit 1 bei einer Schlagzeile, die nicht besteht, mit 2 bei einer Seite, die keine durch TYPE.draw zeichnet.
scripts/deliver.mjsDer letzte Schritt (§8): Die fertigen Videos und ihre Cover verlassen den Arbeitsordner für einen eigenen Ordner; sobald der Film draußen ist, wirft trash den Arbeitsordner weg, nachdem überprüft wurde, dass seine Quelle sicher im Kit ist. --selftest.
scripts/fonts.mjsDie Schriftarten des Kits: add "<Familie>" [Achsen] von Google Fonts mit seiner Lizenz, check, list.

Daneben befinden sich studio/ (das Studio, unten), guide.md (der geführte Modus, unten) und README.md (der Katalog in Bildern und Beispielanfragen für jeden Moment eines Films).

Einrichtung: ein Arbeitsordner, ~/Downloads/<name>-work/ (~/Downloads ist das Arbeitsstammverzeichnis, sofern nicht workRoot in der Einstellungsdatei (unten) etwas anderes angibt), mit der Seite und diesen Dateien in seinem src/ und npm i playwright-core dort. Es steuert das installierte Chrome über channel: 'chrome', sodass nichts anderes heruntergeladen wird. <name> ist <produkt>-<was> (acme-promo, acme-2.4-whats-new) und benennt auch den Auslieferungsordner und jede ausgelieferte Datei (§8).

Studio: das Briefing in einem Fenster

Der visuelle Einstieg. Ein Assistent in einem eigenen Fenster: Rezepte, Formate, Looks, Bilder vom Mac, Schrift und Bewegung, die auf der echten Engine in Bewegung gezeigt werden, in der Farbe und dem Seitenverhältnis des Produkts, der Ton (die Titel der Musikbibliothek werden abgespielt, die Stimme eines Sprachmodells wird gehört, die eine Zeile sagt, bevor sie ausgewählt wird), und jede Wahl wird in eine einzige brief.json geschrieben. Nichts wird installiert und nichts gerendert. /manovella:studio öffnet es ebenfalls.

  • Wann: aufgerufen mit studio, oder mit nichts, während nichts im Gespräch sagt, welcher Film gemacht werden soll. Ein Benutzer, der in Worten gesagt hat, was er will, geht direkt zu §0.
  • Ausführen node <verzeichnis dieser fähigkeit>/studio/studio.mjs vom Arbeitsbereich aus, im Hintergrund (die Geschwister seiner Repositories sind die angebotenen Produkte), und sagen Sie in einer Zeile, dass das Fenster offen ist. Es beendet sich von selbst, gibt eine Zeile aus, und der Exit weckt Sie: BRIEF <pfad>, oder CANCELLED, CLOSED, TIMEOUT (sagen Sie es und stoppen Sie). Das Fenster ist die eigene App des Studios, wo sie auf diesem Mac erstellt wurde (~/Applications/Manovella.app, ihr Name, Version und Symbol im Dock), sonst ein Chrome-App-Fenster; MANOVELLA_WINDOW=chrome behält Chrome bei. Ohne beides öffnet es den Standardbrowser; --no-open gibt stattdessen die URL aus, für eine Sitzung, deren Bildschirm woanders ist.
  • Die Musikbibliothek ist optional: ein Ordner mit der Musik der Filme des Benutzers, aufbewahrt wo immer sie wollen (ein synchronisiertes Laufwerk, ein Projektordner). Sie ist dort, wo MANOVELLA_MUSIC für einen Lauf zeigt, sonst musicLibrary in ~/Library/Application Support/manovella/settings.json (~/.config/manovella/settings.json außerhalb von macOS; ein führendes ~ wird expandiert); musicLibraryIgnore in derselben Datei listet Ordnernamen darin auf, die übersprungen werden sollen, und deliverToLibrary (true oder false, Standard false) sagt, ob fertige Filme auch darin abgelegt werden sollen. Nichts wird automatisch erkannt. Eine ältere Datei mit brandLibrary und brandLibraryIgnore wird als musicLibrary und musicLibraryIgnore mit deliverToLibrary an gelesen, was sie zuvor tat, und wird bei der ersten Änderung in den Studio-Einstellungen mit den neuen Schlüsseln neu geschrieben. Dieselbe Datei akzeptiert projectFolders (wo das Studio nach Produkten sucht), pictureFolders (seine Hintergrundbilder; nicht gesetzt: ~/Pictures) und workRoot (wo <name>-work und, sofern der Film nicht in die Bibliothek oder das Projekt keine Anweisung hat, <name>/ hingehen; nicht gesetzt: ~/Downloads); das Einstellungsfenster des Studios (das Zahnrad neben dem Logo, oder ⌘, in Manovella.app) schreibt sie alle, und deliver.mjs liest auch workRoot. Nichts sonst im Code liest die Bibliotheksschlüssel: für einen ohne Studio gemachten Film ist dieser Absatz die Anweisung für mich.
    • Das Studio bietet jede Audiodatei (mp3, m4a, aac, wav, aiff, flac, ogg) auf der obersten Ebene der Bibliothek und in jedem Ordner darin, direkt oder in dessen audio/-Ordner; Punkt-Ordner und die Namen in musicLibraryIgnore werden übersprungen. Ein Ordner pro Marke ist optional und gruppiert seine Titel; der nach dem Produkt benannte Ordner wird zuerst aufgelistet („dieses Produkts“). Eine optionale Notizdatei neben den Titeln (…notes.txt oder .md: ein Absatz pro Titel, beginnend mit dem Dateinamen des Titels: was es ist, seine Stimmung, wo es passt) sagt, wofür jeder ist, und das Studio zeigt sie an.
    • Fertige Filme: mit deliverToLibrary an und einer gesetzten Bibliothek, <Bibliothek>/<Marke>/video/<name>/ (§8); sonst dort, wo die eigenen Anweisungen des Projekts fertige Medien aufbewahren, sonst <name>/ im Arbeitsstammverzeichnis (standardmäßig ~/Downloads/<name>/).
    • Ein neuer Titel, der erstellt wurde (unten), wird in der Bibliothek gespeichert, im Ordner des Produkts, wenn die Bibliothek einen pro Marke führt, mit seinem Absatz in der Notizdatei dieses Ordners, wenn eine Bibliothek existiert; sonst geht er einfach in das src/audio/ des Films. Ein Ordner in einem Dateianbieter (Google Drive, iCloud Drive, Dropbox) kann seine Dateien „dataless“ halten, bis sie geöffnet werden, also öffnen oder kopieren Sie eine Datei, bevor Sie sie messen. Dateien, die eine Bibliothek aufbewahrt, werden kopiert, niemals daraus verschoben.
  • brief <pfad>, als Argument oder von einer BRIEF-Zeile: das Briefing lesen; es beantwortet §0.
    • formats: [] ist meine Auswahl von drei. Für ein Promo oder einen Film in Kapiteln sind ein, zwei oder drei benannte die Storyboard-Formate, in dieser Reihenfolge, und ich wähle den Rest aus, jedes ein anderes; das Format eines Releases und eines Tutorials ist ihres (whatsnew, tutorial), niemals ausgefüllt. look: null ist das Looks-Blatt (§4).

    • frame: worin das Produkt gezeigt wird, unabhängig vom Format; null ist das eigene jedes Formats (ein Browser für einen Walkthrough, ein Terminal für eine Befehlszeile, ein Mac-Fenster für ein Tutorial), meine Wahl.

      • window: die App in ihrem macOS-Fenster (PARTS.window).
      • macbook: ein MacBook von vorne, das App-Fenster oder der Browser der Website auf seinem Bildschirm (PARTS.laptop, PARTS.notch zuletzt gezeichnet).
      • imac: ein iMac von vorne, auf seinem Ständer, das App-Fenster oder der Browser der Website auf seinem Desktop (PARTS.desktop: sein Rechteck ist der Körper, 547 : 375, und der Ständer wird darunter gezeichnet; color ist eine von Apples sieben Farben oder der Akzent der Marke für die nächste davon). Keine Kerbe: Die Kamera ist im weißen Rahmen.
      • iphone, ipad: das Gerät (PARTS.phone mit PARTS.island zuletzt gezeichnet; PARTS.tablet, liegend oder aufrecht durch sein Rechteck, die Kamera an seiner langen Kante), das eigene Layout des Produkts darauf (§1), und jeder Klick eine Berührung: eine weiche Scheibe, die drückt, mit der Welle des Looks, niemals PARTS.ARROW; ein Tutorial sagt tippen.
      • browser: das Produkt als Seite in PARTS.browser, seine echte Adresse im Feld.
      • terminal: PARTS.terminal, getippt mit FILM.typed.
      • bare (das Studio Nur die Benutzeroberfläche): die Benutzeroberfläche des Produkts für sich allein, ein schwebendes Panel mit abgerundeten Ecken und einem Schatten, kein Fenster-Chrom und kein Gerät darum. Das Produkt ist immer noch auf dem Bildschirm: ein Film ohne ist das Format Kinetischer Text, nicht dies.

      Der Rahmen gilt für jede Szene, die das Produkt zeigt, in jedem Storyboard: ein Tutorial einer iPhone-App wird auf einem iPhone von seinem ersten Schritt bis zu seinem letzten erzählt. Ein Format, das selbst eine Oberfläche ist, beugt sich ihm: Browser-Walkthrough mit iphone ist die Website im Telefon bei dieser Breite; Terminal mit macbook oder imac ist das Terminalfenster auf dem Mac-Desktop. Geräte in 3D ist das eine Format, das mehrere zeigt: das gewählte Gerät führt den Coverflow an (die erste Karte, die der Kamera zugewandt ist, und die, zu der es zurückkommt), und die anderen folgen ihm. Wo der Rahmen und ein fo…

… [für die Übersetzung gekürzt]

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Verwandte Skills