Was macht Reels-Vorlagen?
Fünfzehn datengetriebene Remotion-Vorlagen (1080x1920, 60 fps) werden mit diesem Skill im Ordner assets/reels-kit/ ausgeliefert. Ein Video ist eine einzige JSON-Jobdatei: Wähle eine Vorlage aus, fülle ihre Eigenschaften aus und rendere. Für normale Jobs musst du kein React schreiben.
Pfade, die unten mit reels/ beginnen, befinden sich im Arbeitsordner, nicht in diesem Skill. Bearbeite niemals Dateien innerhalb des Skill-Ordners für einen Job.
Läuft unbeaufsichtigt ab. Dieser Skill ist für autonome Agenten konzipiert. Der Anforderer ist derjenige, der den Job gestartet hat: ein orchestrierender Agent, eine Pipeline oder eine Person. Triff jede Entscheidung gemäß den Regeln in dieser Datei und frage niemals nach einer Genehmigung für einen Schritt. Halte nur bei einem Problem an, das du nicht lösen kannst (fehlendes Tool, fehlende oder unlesbare Medien, ein Render, das immer wieder fehlschlägt), und melde es. Jeder Job endet mit einem Bericht (Abschnitt 4).
0. Arbeitsbereich einrichten
Führe dies einmal pro Projekt aus, vor dem ersten Job.
- Überprüfe die Werkzeuge: Node.js 18 oder neuer (
node -v), sowieffmpegundffprobeim Pfad (PATH). Wenn eines fehlt, halte an und melde es als Problem. Installiere selbst keine Systemsoftware. - Wenn der Arbeitsordner bereits
reels/render.mjsenthält, verwende diesen Arbeitsbereich und fahre mit Abschnitt 1 fort. - Andernfalls kopiere den Ordner
assets/reels-kit/dieses Skills in den Ordnerreels/im Arbeitsordner (z. B.cp -R <skill-verz>/assets/reels-kit reels), führe dannnpm installinnerhalb vonreels/aus. - Erstelle die Ordner
reels/public/(Medien) undreels/jobs/_local/(temporäre Jobs). Wenn der Arbeitsordner ein Git-Repository ist, fügereels/node_modules/,reels/public/,reels/out/,reels/exports/undreels/jobs/_local/zu dessen.gitignorehinzu.
Der Arbeitsbereich enthält render.mjs (rendert einen Job), clean.mjs (gibt Speicherplatz frei, siehe Abschnitt 6), src/ (Vorlagen und das gemeinsame Kit), jobs/examples/ (ein Beispiel-Job pro Vorlage), public/<name>/ (Eingabemedien jedes Jobs), out/stills/ (QA-Standbilder) und exports/<name>/ (fertige Videos jedes Jobs).
Präferenzen
Dieses Repository enthält niemandes Geschmack. Textstil, Schriftart, Akzentfarbe, Ton des Textes, Sprachen, Musik und das Format, mit dem begonnen wird, stammen aus dem Briefing des Anforderers und aus dem, was du bereits über die Marke weißt, niemals aus einem in die Vorlagen oder diese Datei geschriebenen Wert. Wenn das Briefing eine Präferenz angibt, wende sie in der Jobdatei an. Wenn nicht, verwende die Vorlagen-Standardwerte und liste sie im Bericht auf. Schreibe keine Präferenz einer Person oder Marke in die Vorlagen, die Beispiel-Jobs oder diesen Skill.
1. Vorlage auswählen
Beginne mit der sozial-nativen Serie, wenn sich das Video anfühlen soll wie etwas, das eine Person gepostet hat. Verwende die Werbeserie, wenn das Filmmaterial selbst das Video trägt.
Sozial-nativ (eine Oberfläche, die der Betrachter bereits kennt, ist der Aufhänger)
| Vorlage | Verwenden, wenn | Benötigt |
|---|---|---|
ChatStory | Eine Geschichte, die als SMS-Thread erzählt wird, dann die Produkt-Enthüllung | Nachrichten (+ ein Produktfoto zum Senden), Auszahlungsclips |
NotesList | Eine Notizen-App-Liste, die sich selbst tippt: „Geschenke, die gefloppt sind vs. das, was sie behalten hat“ | Titel + 1 bis 7 Zeilen, Auszahlungsclips |
SearchHook | Die Frage des Kunden, die in eine Suchleiste eingegeben wird, beantwortet durch das Filmmaterial | Eine Suchanfrage (+ Vorschläge), 1+ Clips |
NotificationStack | Sperrbildschirm, der sich mit Bestellungen, Nachrichten, Bewertungen füllt: sozialer Beweis und FOMO | 1 bis 6 Benachrichtigungen, Hintergrund, Auszahlungsclips |
PolaroidDump | Sammelalbum-Fotodump mit handschriftlichen Bildunterschriften | 2 bis 8 Fotos |
Ranking | Blindes Ranking: Artikel fallen in eine nummerierte Liste, #1 zuletzt | 2 bis 6 Clips, jeweils ein Label und Rang |
PollSticker | Ein Story-Umfrage-Sticker über Filmmaterial: zwei Optionen, ein Tippen, das Ergebnis | Eine Frage, 2 Optionen mit Prozenten, Clips |
Werbeformate (Filmmaterial zuerst, Text darüber)
| Vorlage | Verwenden, wenn | Benötigt |
|---|---|---|
BeatCutAd | Standard für einen aus Filmmaterial geschnittenen Produkt-Werbespot: mehrere Einstellungen, Aufhänger, CTA | 1+ Videoclips |
UgcCaptions | Eine Person spricht zur Kamera; Wort-für-Wort-Untertitel | 1 Clip mit Sprache + Wortzeitangaben |
Listicle | „3 Gründe warum“, Tipps, Funktionen, Schritte | 2 bis 7 Clips, einer pro Punkt |
BeforeAfter | Eine Verwandlung oder ein Vergleich (mode: wipe oder split) | 2 Clips oder Fotos |
ProductSlideshow | Es existieren nur Produktfotos, oder ein schneller Katalog; optionaler Preisanhänger | 2+ Fotos oder Clips |
Testimonial | Sozialer Beweis: Bewertungskarten mit Sternen | 1 Hintergrundclip + Bewertungstexte |
CommentReply | Beantwortung eines Einwands oder einer FAQ; die Kommentarblase ist der Aufhänger | 1+ Clips + der Kommentar |
OfferPromo | Sale, Rabattcode, Frist | 1+ Clips + das Angebot |
Wenn das Briefing auf keine davon passt, siehe Abschnitt 7. Zwinge keine Vorlage zu etwas, was sie nicht ist.
Der offizielle Remotion-Skill (remotion-best-practices, separat installiert mit npx skills add remotion-dev/skills --skill remotion-best-practices) ist die Referenz zum Schreiben von Remotion-Code. Wenn er nicht installiert ist, verwende stattdessen die Remotion-Dokumentation unter https://www.remotion.dev/docs/. Für die Erstellung eines Videos in diesem Repository gewinnt dieser Skill, wo sie sich unterscheiden: Erstelle eine Jobdatei anstelle eines neuen Projekts oder einer neuen Komposition, überprüfe Standbilder anstelle des Öffnens von Studio und rendere mit render.mjs, sobald die Standbilder bestanden haben, ohne darauf zu warten, gefragt zu werden.
2. Job erstellen
- Wähle den Jobnamen (Kleinbuchstaben, Ziffern und
-, z. B.xmas-ornament). Er ist dernameder Jobdatei, der Eingabeordnerreels/public/<name>/und der Ausgabeordnerreels/exports/<name>/. Kopiere nur die Dateien, die dieser Job verwendet, nachreels/public/<name>/und belasse die Originale an ihrem Platz. Vermerke im Bericht, woher jede Eingabe stammt und ob die Kopie inpublic/die einzige ist (heruntergeladene oder generierte Dateien). Schreibe jedessrcals<name>/<datei>. Führeffprobefür jede Datei aus, um ihre Länge zu erhalten. Medien werden nie committet:public/wird von git ignoriert, daher sind die Pfade in den Beispiel-Jobs (footage.mp4,music.m4a,demo/…) Platzhalter, bis du deine eigenen Dateien dort ablegst. - Betrachte das Filmmaterial, bevor du Text platzierst: Extrahiere einen Frame pro Einstellung (
ffmpeg -ss <t> -i <datei> -frames:v 1) und notiere, wo das Produkt sitzt. - Lese
reels/jobs/examples/<Vorlage>.json. Es listet jede Eigenschaft auf, die diese Vorlage akzeptiert. Kopiere es nachreels/jobs/<job>.jsonund bearbeite es. Verwendereels/jobs/_local/für einen Job, der nicht in git landen soll.
Jobdatei:
{ "template": "BeatCutAd", "name": "xmas-ornament", "lang": "en",
"props": { },
"i18n": { "ja": { "hook": { "lines": ["…", "…"] }, "cta": { "lines": ["…"], "button": "…" } } } }
i18n.<sprache> wird über props gemergt, enthält also nur die übersetzten Zeichenfolgen. Arrays von Objekten werden Element für Element gemergt (null behält das Basiselement); Arrays von Zeichenfolgen werden ersetzt.
Eigenschaften, die jede Vorlage gemeinsam hat:
hook:{ lines (1-3), band, size, duration }. Wird ab 0 s angezeigt, Standard 2,2 s.cta:{ lines, button, band, size, duration }. Wird für die letztendurationSekunden angezeigt, Standard 2,5. Andere Untertitel enden, wenn es beginnt.music:{ src, volume }. Blendet am Ende aus. Verwende etwa 0,15 unter Sprache.brand:{ accent (hex), font: poppins | montserrat | anton, textStyle: outline | box | caption }.outline(Standard) undboxsind laute Werbestile.captionist der native In-App-Untertitellook: weißer Text in Satzform in einer einzigen dunklen abgerundeten Box, oben in seinem Band, einblendend; schreibe es als Ich-Erzählung, 2 Zeilen mit bis zu 30 Zeichen.- Ein Clip:
{ src, start (s im Quellmaterial), duration (s auf dem Bildschirm), speed, focus (center | top | bottom | "50% 30%"), transition (cut | flash | zoom | whip | focus) }.transitionist die Art, wie dieser Clip ankommt.
Ein Clip hat auch eine simulierte Kamera: zoom (1-2,5, Hereinzoomen, das den focus-Punkt an Ort und Stelle hält), tilt (Grad, -15 bis 15, ein holländischer Winkel) und push (0-0,6, die Kamera stößt mit einer kurzen Unschärfe herein, wenn der Clip ankommt, und setzt sich dann ab).
Eine Eigenschaft, die der Job weglässt, ist aus: Ein Job ohne hook hat keinen Hook, was auch immer das Beispiel zeigt.
src ist ein Pfad innerhalb von public/ oder eine HTTPS-URL. Ein .jpg/.png/.webp erhält einen langsamen Hereinzoom anstelle des Abspielens.
3. Regeln
- Sicherheitszone. Aller Text bleibt in x 140-940, y 288-1248. Die Vorlagen erzwingen dies durch drei Bänder:
top(y 288-600),middle(600-930),lower(930-1248). Du wählst nur das Band. - Halte Text vom Produkt fern, es sei denn, das Briefing möchte es dort. Wähle jedes Band aus den von dir extrahierten Frames. Wenn jedes Band in einer Einstellung das Produkt abdeckt, verkürze die
durationdes Textes oder ändere die Einstellung. - Kurze Zeilen. Text schrumpft, um in 800 px zu passen, also wird eine lange Zeile klein. Ziel sind 22 lateinische Zeichen oder 12 japanische Zeichen pro Zeile. Umbreche ein Wort in
*Sternchen*, um es mit der Akzentfarbe zu färben. - Clips-Längen.
start + duration * speeddarf nicht über das Ende der Quelle hinausgehen. Die Länge des Videos ist die Summe der Clip-Dauern (BeforeAfterverwendetduration;Testimonialsind die Bewertungen plus der CTA). - Auf den Beat schneiden, wenn es Musik gibt: Die Clip-Dauern sollten zu Beat-Positionen addieren.
- Schriftarten. Lateinisch, Vietnamesisch (montserrat oder anton, sowie alle Oberflächenkarten) und Japanisch funktionieren. Koreanisch, Thailändisch, Arabisch und andere benötigen eine Schriftart, die zuerst in
reels/src/lib/kit.tsxhinzugefügt wird.
Wenige statische Clips, viele Winkel. Wenn das Filmmaterial aus ein oder zwei festen Einstellungen besteht und das Briefing ein schneller Multi-Winkel-Schnitt ist (ein Showroom-Rundgang oder ein Trend-Tanz-Schnitt), verwende BeatCutAd und verwende jede Quelle mehrmals mit einem anderen focus, zoom, tilt und push: Beginne mit einer Totalen (zoom etwa 1,02), dann ein Detail pro Beat (Text, Charakter, Name, Hände, Saum), wechsle das Vorzeichen von tilt, halte zoom bei 1,7 oder weniger bei 768 px-Quellen und ende weit. Verwende cut-Übergänge; der Push ist der Übergang. Dies bildet das Filmmaterial neu ein; es kann keinen echten neuen Kamerawinkel erzeugen.
Vorlagennotizen:
ChatStory,NotesList,NotificationStack: Die Oberfläche spielt zuerst, dann blitzenclips(der Auszahlungsclips) ein und der CTA wird über ihnen angezeigt. Ihre Länge ist der Oberflächenteil plus die Clips. Lassehookweg: Die Karte füllt die Sicherheitszone.backgroundist das abgedunkelte Medium hinter der Karte.ChatStory: Nachrichten tempoieren sich durch die Lesezeit; setzeat(Sekunden) nur, um einen Beat zu erzwingen. Eine Nachricht kannimage(ein Produktfoto) anstelle von oder zusammen mittextenthalten.NotesList:check: truehakt eine Zeile ab, nachdem sie getippt wurde,highlight: truemarkiert sie. Setze die Produktzeile zuletzt.SearchHook:pickist der Vorschlag, der ausgewählt wird. Halte die Suchanfrage unter 34 Zeichen.NotificationStack:iconist ein Emoji,colorseine Kachelfarbe. Übersetzenowunddatepro Sprache.PolaroidDump: Quadratische Fotos funktionieren am besten.titleist handschriftlich; Bildunterschriften bleiben unter 20 Zeichen. Es gibt keine Clips: Die Fotos sind das Video.Ranking:itemsspielen in der geschriebenen Reihenfolge ab, schreibe also den niedrigsten Rang zuerst und Rang 1 zuletzt. Labels bleiben unter 20 Zeichen.PollSticker:percent-Werte kannst du selbst festlegen; verwende echte Zahlen, wenn das Briefing sie hat, und präsentiere nie erfundene als Umfragedaten.- Schreibe den Text in diesen Oberflächen so, wie Leute texten und posten: Kleinbuchstaben sind in Ordnung, kurze Zeilen, ein Emoji, wo eine Person eines verwenden würde. Namen, Nachrichten und Bewertungen darin sind illustrativ, es sei denn, das Briefing liefert echte, schreibe sie also nicht realen Personen zu.
UgcCaptions:wordssind{ text, start, end }in Sekunden auf der Ausgabe-Zeitleiste. Hole sie aus einem Transkript mit Wort-Zeitstempeln; rate keine Zeitangaben.keepAudioist standardmäßig true. Ein „Wort“ kann eine kurze Phrase mitwordsPerPage: 1sein.CommentReplyundOfferPromo: Lassehookweg. Die Blase oder Überschrift verwendet bereits das obere Band.OfferPromo: Der CTA ist standardmäßig im unteren Band.Testimonial: Setze das CTA-Band aufmiddle.ProductSlideshow:badgeakzeptiert\nfür zwei Zeilen; platziere es mitbadgeBand.
4. Überprüfen, dann rendern
Führe diese Befehle von reels/ aus.
node render.mjs jobs/<job>.json --still=1,6,12 --guides # Sicherheitszonen-Bänder oben eingezeichnet
node render.mjs jobs/<job>.json --still=1,6,12 --lang=en,ja
node render.mjs jobs/<job>.json # jede Sprache -> exports/<name>/
Standbilder gehen in out/stills/ in halber Größe. Öffne sie und überprüfe: Text ist nicht auf dem Produkt, nichts wird abgeschnitten, jede Sprache passt. Wähle Standbildzeiten innerhalb des Hooks, eines mittleren Untertitels und des CTA. Dateien mit dem Namen _GUIDES dienen nur zur Überprüfung; gib sie niemals als Ergebnis weiter.
Rendere die Videos erst, nachdem die Standbilder bestanden haben. Wenn ein Standbild fehlschlägt, repariere den Job und überprüfe erneut; nach drei fehlgeschlagenen Versuchen melde es als Problem. Ein Render gibt eine Zeile pro Datei mit ihrem Pfad und ihrer Länge aus. Veröffentliche oder lade die Videos nicht hoch, es sei denn, das Briefing sagt es.
Beende jeden Job mit einem Bericht an den Anforderer. Er enthält:
- die Ausgabepfade und -längen;
- die Vorlage und die verwendeten Standardwerte, wo das Briefing nichts sagte;
- die Quelle jeder Eingabe und ob
public/die einzige Kopie enthält; - was die Bereinigung in Abschnitt 6 entfernt hat und den freigegebenen Speicherplatz.
5. Instagram-Größe
Die Renderings haben etwa 16 Mbps. Um eines für den Upload zu komprimieren:
ffmpeg -i in.mp4 -c:v libx264 -crf 20 -maxrate 10M -bufsize 20M -c:a aac -ar 48000 -b:a 192k -movflags +faststart out.mp4
6. Medien und Speicherplatz
Medien sind das, was die Festplatte füllt. Eingaben (Filmmaterial, Fotos, Musik, kopiert nach public/<name>/) und Ausgaben (Videos in exports/<name>/, etwa 30 MB pro Sprache für 15 s) gehören beide zu einem Job, unter demselben Namen. Behalte das bei, da die Bereinigung pro Job funktioniert. Alles andere ist temporär: QA-Standbilder in out/ und die temporären Pakete, die Remotion in den OS-Temp-Ordner schreibt (jedes enthält eine vollständige Kopie von public/; render.mjs löscht seine eigenen, aber abgestürzte Läufe und Studio hinterlassen einige). Der Webpack-Cache in node_modules/.cache wächst auf mehrere hundert MB. node_modules/ (etwa 1,3 GB, einschließlich des Headless-Browsers) ist eine einmalige Kosten. Das erneute Rendern eines Jobs überschreibt seine Dateien unter denselben Namen, sodass wiederholte Renderings eines Jobs sich nicht anhäufen.
Wenn reels/clean.mjs fehlt (der Arbeitsbereich wurde aus einem älteren Kit erstellt), kopiere zuerst clean.mjs und render.mjs aus dem Ordner assets/reels-kit/ dieses Skills nach reels/.
Führe diese Befehle von reels/ aus, niemals während ein Render läuft:
node clean.mjs --auto --keep=<anzahl> --name=<job>
--auto entfernt temporäre Dateien aus public/ für Jobs, die keine Ausgaben mehr in exports/ haben, löscht Standbilder in out/ und leert den Remotion-Temp-Ordner. --keep=<anzahl> behält die letzten <anzahl> Renderings jedes Jobs (Standard 1). --name=<job> schränkt die Bereinigung auf einen bestimmten Job ein. Führe dies aus, bevor eine Warnung wegen niedrigen Speicherplatzes zu erwarten ist. Berichte über die freigegebene Menge nach der Ausführung.
7. Neue Vorlage hinzufügen
Wenn ein Briefing keinem der fünfzehn Formate entspricht, erstelle eine neue Vorlage. Dafür braucht der Agent Schreibzugriff auf den Skill-Ordner.
- Erstelle eine Remotion-Komposition, die
TemplatePropsausreels/src/lib/kit.tsximportiert. Sie erhält{ hook, cta, music, brand, clips, ...rest }. Verwende dieuseSafeZone-Hook für die Textplatzierung. Jede Vorlage muss einen eindeutigentemplate-Namen exportieren. - Füge die Komposition zu
reels/src/Root.tsxhinzu. - Erstelle eine Beispiel-Jobdatei in
reels/jobs/examples/. - Füge die Vorlage zur Tabelle in Abschnitt 1 dieses Skills hinzu. Schreibe sie in derselben Tabellenstruktur.
Füge diese Dateien nach dem Hinzufügen mit node render.mjs ... hinzu und rendere das Beispiel, um es zu testen. Mache dann einen Build (node bundle.mjs im Skill-Ordner, falls vorhanden, oder starte npx skills process im Skill-Ordner).
Entferne keine vorhandene Vorlage oder Beispiel-Jobdatei.
8. Nach Abschluss
Wenn der Job abgeschlossen ist, gib eine Zusammenfassung zurück.