Communitygithub.com

Reels-Vorlagen

Erstelle mit einem Befehl ein 9:16 Reels / TikTok Video aus Filmmaterial, Fotos oder einem Briefing – mit fünfzehn fertigen Remotion-Vorlagen, die in diesem Skill enthalten sind.

Was ist Reels-Vorlagen?

Dieser Skill ermöglicht es KI-Agenten (z. B. Claude Code, Cursor, Codex), autonom kurze vertikale Videos im 9:16-Format zu erstellen, wie sie für Reels, TikTok oder ähnliche Plattformen typisch sind. Er enthält fünfzehn vorgefertigte, datengetriebene Remotion-Vorlagen, die sowohl sozial-native Formate (z. B. Chatverlauf, Notiz-App, Suchleiste, Sperrbildschirm-Benachrichtigungen, Polaroid-Fotodump, Ranking, Umfrage-Sticker) als auch Werbeformate (z. B. Beat-Schnitt, UGC mit Untertiteln, Liste, Vorher/Nachher, Produkt-Diashow, Testimonials, Kommentar-Antwort, Verkaufsaktion) abdecken. Der Workflow ist vollständig automatisiert: Der Agent wählt eine Vorlage basierend auf der Benutzeranfrage aus, erstellt eine JSON-Jobdatei mit den erforderlichen Eigenschaften (z. B. Videoclips, Text, Musik, Markenfarben), überprüft die Ausgabe mit Standbildern und rendert das endgültige Video. Der Skill ist für unbeaufsichtigten Betrieb ausgelegt und erfordert keine manuelle Genehmigung oder React-Programmierkenntnisse für Standard-Jobs.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/du-nguyen-IT007/remotion-reels-skills/tree/HEAD/skills/reels-templates

In Ihrer bevorzugten KI fragen

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

Dokumentation

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.

  1. Überprüfe die Werkzeuge: Node.js 18 oder neuer (node -v), sowie ffmpeg und ffprobe im Pfad (PATH). Wenn eines fehlt, halte an und melde es als Problem. Installiere selbst keine Systemsoftware.
  2. Wenn der Arbeitsordner bereits reels/render.mjs enthält, verwende diesen Arbeitsbereich und fahre mit Abschnitt 1 fort.
  3. Andernfalls kopiere den Ordner assets/reels-kit/ dieses Skills in den Ordner reels/ im Arbeitsordner (z. B. cp -R <skill-verz>/assets/reels-kit reels), führe dann npm install innerhalb von reels/ aus.
  4. Erstelle die Ordner reels/public/ (Medien) und reels/jobs/_local/ (temporäre Jobs). Wenn der Arbeitsordner ein Git-Repository ist, füge reels/node_modules/, reels/public/, reels/out/, reels/exports/ und reels/jobs/_local/ zu dessen .gitignore hinzu.

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)

VorlageVerwenden, wennBenötigt
ChatStoryEine Geschichte, die als SMS-Thread erzählt wird, dann die Produkt-EnthüllungNachrichten (+ ein Produktfoto zum Senden), Auszahlungsclips
NotesListEine Notizen-App-Liste, die sich selbst tippt: „Geschenke, die gefloppt sind vs. das, was sie behalten hat“Titel + 1 bis 7 Zeilen, Auszahlungsclips
SearchHookDie Frage des Kunden, die in eine Suchleiste eingegeben wird, beantwortet durch das FilmmaterialEine Suchanfrage (+ Vorschläge), 1+ Clips
NotificationStackSperrbildschirm, der sich mit Bestellungen, Nachrichten, Bewertungen füllt: sozialer Beweis und FOMO1 bis 6 Benachrichtigungen, Hintergrund, Auszahlungsclips
PolaroidDumpSammelalbum-Fotodump mit handschriftlichen Bildunterschriften2 bis 8 Fotos
RankingBlindes Ranking: Artikel fallen in eine nummerierte Liste, #1 zuletzt2 bis 6 Clips, jeweils ein Label und Rang
PollStickerEin Story-Umfrage-Sticker über Filmmaterial: zwei Optionen, ein Tippen, das ErgebnisEine Frage, 2 Optionen mit Prozenten, Clips

Werbeformate (Filmmaterial zuerst, Text darüber)

VorlageVerwenden, wennBenötigt
BeatCutAdStandard für einen aus Filmmaterial geschnittenen Produkt-Werbespot: mehrere Einstellungen, Aufhänger, CTA1+ Videoclips
UgcCaptionsEine Person spricht zur Kamera; Wort-für-Wort-Untertitel1 Clip mit Sprache + Wortzeitangaben
Listicle„3 Gründe warum“, Tipps, Funktionen, Schritte2 bis 7 Clips, einer pro Punkt
BeforeAfterEine Verwandlung oder ein Vergleich (mode: wipe oder split)2 Clips oder Fotos
ProductSlideshowEs existieren nur Produktfotos, oder ein schneller Katalog; optionaler Preisanhänger2+ Fotos oder Clips
TestimonialSozialer Beweis: Bewertungskarten mit Sternen1 Hintergrundclip + Bewertungstexte
CommentReplyBeantwortung eines Einwands oder einer FAQ; die Kommentarblase ist der Aufhänger1+ Clips + der Kommentar
OfferPromoSale, Rabattcode, Frist1+ 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

  1. Wähle den Jobnamen (Kleinbuchstaben, Ziffern und -, z. B. xmas-ornament). Er ist der name der Jobdatei, der Eingabeordner reels/public/<name>/ und der Ausgabeordner reels/exports/<name>/. Kopiere nur die Dateien, die dieser Job verwendet, nach reels/public/<name>/ und belasse die Originale an ihrem Platz. Vermerke im Bericht, woher jede Eingabe stammt und ob die Kopie in public/ die einzige ist (heruntergeladene oder generierte Dateien). Schreibe jedes src als <name>/<datei>. Führe ffprobe fü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.
  2. 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.
  3. Lese reels/jobs/examples/<Vorlage>.json. Es listet jede Eigenschaft auf, die diese Vorlage akzeptiert. Kopiere es nach reels/jobs/<job>.json und bearbeite es. Verwende reels/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 letzten duration Sekunden 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) und box sind laute Werbestile. caption ist 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) }. transition ist 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 duration des 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 * speed darf nicht über das Ende der Quelle hinausgehen. Die Länge des Videos ist die Summe der Clip-Dauern (BeforeAfter verwendet duration; Testimonial sind 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.tsx hinzugefü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 blitzen clips (der Auszahlungsclips) ein und der CTA wird über ihnen angezeigt. Ihre Länge ist der Oberflächenteil plus die Clips. Lasse hook weg: Die Karte füllt die Sicherheitszone. background ist das abgedunkelte Medium hinter der Karte.
  • ChatStory: Nachrichten tempoieren sich durch die Lesezeit; setze at (Sekunden) nur, um einen Beat zu erzwingen. Eine Nachricht kann image (ein Produktfoto) anstelle von oder zusammen mit text enthalten.
  • NotesList: check: true hakt eine Zeile ab, nachdem sie getippt wurde, highlight: true markiert sie. Setze die Produktzeile zuletzt.
  • SearchHook: pick ist der Vorschlag, der ausgewählt wird. Halte die Suchanfrage unter 34 Zeichen.
  • NotificationStack: icon ist ein Emoji, color seine Kachelfarbe. Übersetze now und date pro Sprache.
  • PolaroidDump: Quadratische Fotos funktionieren am besten. title ist handschriftlich; Bildunterschriften bleiben unter 20 Zeichen. Es gibt keine Clips: Die Fotos sind das Video.
  • Ranking: items spielen 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: words sind { text, start, end } in Sekunden auf der Ausgabe-Zeitleiste. Hole sie aus einem Transkript mit Wort-Zeitstempeln; rate keine Zeitangaben. keepAudio ist standardmäßig true. Ein „Wort“ kann eine kurze Phrase mit wordsPerPage: 1 sein.
  • CommentReply und OfferPromo: Lasse hook weg. Die Blase oder Überschrift verwendet bereits das obere Band.
  • OfferPromo: Der CTA ist standardmäßig im unteren Band. Testimonial: Setze das CTA-Band auf middle.
  • ProductSlideshow: badge akzeptiert \n für zwei Zeilen; platziere es mit badgeBand.

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.

  1. Erstelle eine Remotion-Komposition, die TemplateProps aus reels/src/lib/kit.tsx importiert. Sie erhält { hook, cta, music, brand, clips, ...rest }. Verwende die useSafeZone-Hook für die Textplatzierung. Jede Vorlage muss einen eindeutigen template-Namen exportieren.
  2. Füge die Komposition zu reels/src/Root.tsx hinzu.
  3. Erstelle eine Beispiel-Jobdatei in reels/jobs/examples/.
  4. 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.

Verwandte Skills