Was macht Remotion-Shorts-Skill?
Du schreibst einen Kurzfilm als JSON-Datei mit Szenen. Das gebündelte Remotion-Projekt legt die Wörter aus, timet jede Szene an die Lesegeschwindigkeit, hält den Text innerhalb des Bereichs, den keine App-Schaltfläche abdeckt, rendert ein Prüfblatt, ein Cover und das MP4, und der Benutzer kann es mit WoopSocial veröffentlichen.
Du schreibst nicht für jedes Video neuen Remotion-Code. Die Vorlagen sind fest und getestet; deine Aufgabe ist das Drehbuch: was jeder Bildschirm sagt, in welcher Reihenfolge und wie schnell.
0. Einrichtung (einmal pro Maschine)
Benötigt Node 20 oder neuer. Überprüfe mit node -v; falls es fehlt, schicke den Benutzer zu https://nodejs.org. Remotion unterstützt macOS 15 oder neuer, Windows x64 und Linux mit glibc 2.35+ (Ubuntu 22.04, Debian 12 oder neuer).
node <skill-dir>/scripts/setup.mjs remotion-shorts
Dies kopiert das Projekt in ./remotion-shorts, installiert festgelegte Pakete (ca. 260 MB) und lädt den Headless-Browser herunter, den Remotion zum Rendern verwendet (100 bis 150 MB). Es dauert beim ersten Mal 1 bis 3 Minuten. Führe es erneut aus, wenn das Skill aktualisiert wird: Es aktualisiert die Vorlagendateien (alle vom Benutzer geänderten werden als .bak gespeichert) und berührt niemals deren Skripte, Assets oder Ausgaben.
Lizenz. Remotion ist kostenlos für Einzelpersonen und Unternehmen mit bis zu 3 Personen. Unternehmen mit 4 oder mehr Personen benötigen eine Remotion-Unternehmenslizenz, und das Rendern über Skripte gilt als Automatisierung (remotion.pro/license). Wenn der Benutzer für ein größeres Unternehmen rendert, teile ihm dies einmal klar mit, vor dem ersten Rendern.
1. Frage, was du brauchst (eine Nachricht, überspringe bereits Bekanntes)
- Das Material. Ein Thema, Artikel, URL, Notizen, Daten, Changelog oder Liste. Du schreibst nur Fakten, auf die du verweisen kannst. Wenn der Benutzer ein Thema ohne Quelle angibt, finde eine Primärquelle (offizielle Statistiken, Dokumentationen, das eigene Changelog des Produkts) und nenne sie.
- Für wen es ist und die eine Kernbotschaft. Ein Kurzfilm sagt eine Sache.
- Das Aussehen. Ein Theme (
ink,paper,volt,ocean,clean) oder deren Markenfarben, und einen Handle für den Endbildschirm. - Audio. Eingebaute Soundeffekte sind standardmäßig aktiviert (ein Treffer beim Aufhänger, ein Whoosh bei jedem Schnitt, ein Pop bei Highlights, Ticks bei Hochzählern); sie sind für diese Vorlage gemacht und auf jeder App sicher. Musik nur aus einer Datei, für die sie die Nutzungsrechte haben (siehe
references/writing-shorts.mdfür den Grund, warum keine kostenlose Bibliothek auf allen drei Apps sicher ist). - Wohin es geht. TikTok, Reels, Shorts oder alle drei.
2. Schreibe das Drehbuch
Lies references/writing-shorts.md vor dem ersten Drehbuch einer Sitzung. Die Kurzfassung:
- Szene 1 ist ein Aufhänger, der den Nutzen in etwa 10 Wörtern oder weniger nennt: eine Zahl, eine Behauptung oder das Listenversprechen („5 kostenlose Tools, die ersetzen...“). Es ist ab Frame 0 vollständig auf dem Bildschirm. Wenn der Aufhänger eine Zahl hat, setze sie in
big, damit sie als Erstes ins Auge fällt. - Eine Idee pro Szene. Eine Szene ist ein Schlag, kein Absatz. Stat-Szenen tragen eine Zahl und was sie bedeutet. Listenelemente zählen herunter oder hoch; sag im Aufhänger, welches.
- Echte Informationen in jeder Szene. Ein vorlagenbasierter Textclip ohne neuen Inhalt ist das, was YouTube als unauthentischen Inhalt und Instagram als unoriginell bezeichnet. Niemals aufblähen.
- Zahlen sind exakt und belegt. Setze die Quelle in
footer(„Daten: USGS“). Runde niemals eine Zahl in eine andere Behauptung. - Ende mit einer Aktion oder einer Zeile, die zum Aufhänger zurückführt, damit sich die Schleife kontinuierlich anfühlt. Kein „Danke fürs Zuschauen“.
- Länge: 15 bis 45 Sekunden ist das Ziel; der Renderer warnt ab 59.
Schreibe short.json im Projektordner. Das vollständige Format, jeder Szenentyp und jede Option ist in references/short-json.md. Ein minimales Drehbuch:
{
"theme": "ink",
"footer": "Daten: USGS",
"handle": "@deinhandle",
"scenes": [
{ "type": "hook", "big": "2.5%", "text": "des Erdwassers ist frisch" },
{ "type": "stat", "value": "96.5", "suffix": "%", "label": "ist Salzwasser in den Ozeanen" },
{ "type": "stat", "value": "68.7", "suffix": "%", "label": "des Frischwassers ist Eis und Gletscher", "highlight": "Eis und Gletscher" },
{ "type": "end", "text": "Speichere dies für den Quizabend", "highlight": "Speichere dies" }
]
}
3. Überprüfe es vor dem Rendern des Videos
cd remotion-shorts
node render.mjs short.json --stills
In wenigen Sekunden gibt dies den Plan aus (Sekunden und Schriftgröße pro Szene) und schreibt:
out/short/sheet.jpg: der letzte Frame jeder Szene (alles auf dem Bildschirm), mit den Bereichen, die der sichere Bereich mit einer dünnen gestrichelten Linie markiert hat (Text muss innerhalb bleiben).out/short/cuts.jpg: Frame 0 und die Frames um jeden Schnitt herum, um die Bewegung zu überprüfen.out/short/cover.jpg: der Aufhänger, sobald er gelandet ist (lade ihn als Reels-Cover hoch).out/short/report.json: Zeitsteuerungen, Zeilenumbrüche und Warnungen.
Öffne beide Blätter und sieh sie dir an. Prüfe: Ist jede Szene in Telefongröße lesbar, sagt jede eine Sache, sind die Highlights auf den wichtigen Wörtern, sieht etwas gequetscht aus, ist die Reihenfolge richtig, und zeigt Frame 0 den gesamten Aufhänger. Korrigiere das JSON und führe --stills erneut aus, bis du es posten würdest.
Warnungen stoppen das Video-Rendering (Exit-Code 2): Text zu lang für einen Bildschirm, ein Aufhänger, der zu lang ist, ein Highlight, das nicht im Text ist, eine Szene, die zu schnell zum Lesen ist, ein Tempo außerhalb von 0,85 bis 1,25, oder ein Kurzfilm über 59 Sekunden. Korrigiere das Skript; verwende --force nur, wenn der Benutzer die Warnung gesehen hat und sie trotzdem möchte. Einige Probleme sind Fehler, die --force nicht überschreiben kann, wie z. B. ein Wort, das bei keiner Größe auf den Bildschirm passt: Diese würden Text außerhalb des Bildschirms platzieren.
4. Rendern
node render.mjs short.json
Schreibt out/short/short.mp4: 1080x1920, 30 fps, H.264, yuv420p, AAC (eine stille Tonspur, wenn es keine Musik gibt), was TikTok, Reels und Shorts alle akzeptieren. Ein 30-Sekunden-Kurzfilm rendert in etwa einer Minute auf einem aktuellen Laptop. Maschinen mit 8 GB Arbeitsspeicher rendern 2 Frames gleichzeitig; falls ein Render trotzdem wegen Speichermangel beendet wird, führe ihn erneut mit --concurrency 1 aus.
Bevor du es zeigst, schnappe dir drei Frames und sieh sie dir an (Anfang, Mitte, Ende), oder spiele es ab, wenn dein Client es kann. Zeige dann dem Benutzer das Cover, das Blatt und den MP4-Pfad.
Mehrere Konten: Poste niemals dieselbe Datei auf viele Konten. Erstelle eine Variante pro Konto (ein anderer Aufhänger, ein anderes Theme oder eine andere Szenenreihenfolge, gespeichert als eigenes JSON), damit keine zwei Konten ein nahezu identisches Video posten.
5. Posten (WoopSocial, mit Bestätigung)
Lies references/woopsocial.md. Kurz gefasst:
social_accounts_listum die Konten zu finden (verbinde sie zuerst, falls nötig).- Für TikTok,
social_accounts_get_platform_inputsfür das Konto: die Datenschutzoptionen und das längste Video, das es erlaubt. Der Benutzer wählt den Datenschutz; es gibt keine Voreinstellung. - Hochladen:
media_uploads_create_sessionmit der genauen Byte-Größe ausreport.json, speichere die Antwort alssession.json, führenode upload.mjs session.json out/short/short.mp4aus, dannmedia_uploads_complete_sessionbis esREADYist. - Schreibe die Bildunterschrift pro Plattform (TikTok und Reels: eine Zeile, die das Video ergänzt, plus 3 bis 5 spezifische Hashtags; YouTube: ein Titel unter 100 Zeichen plus eine Beschreibung). Verwende
contentOverridefür plattformspezifischen Text. posts_validate, dann zeige dem Benutzer: Konten, Bildunterschrift pro Plattform, Datenschutz, Zeitplan mit Zeitzone, das Cover. Warte auf ein klares Ja. Dannposts_createundposts_get.
Angabefelder: isYourBrand: true auf TikTok, wenn der Kurzfilm das eigene Produkt des Benutzers bewirbt; isAiGeneratedContent nur für realistische KI-Bilder, -Videos oder -Stimmen (kinetischer Text benötigt es nicht). YouTube madeForKids ist eine rechtliche Erklärung: frage, rate niemals.
6. Rückmeldung geben
Zeige: den MP4-Pfad, Länge, das Blatt, wo es gepostet wurde (Links von posts_get) oder den Zeitplan, und alles, was du nicht tun konntest. Erfinde niemals Aufrufe oder Ergebnisse; lies sie später mit social_account_posts_list aus und melde das Datum, an dem sie gesammelt wurden.
Das Aussehen bearbeiten
- Markenfarben: Übergib
themeals Objekt (bg,fg,accent,accentText,font,uppercase). Halte den Textkontrast bei 7:1 oder besser; überprüfe auch Akzent auf Hintergrund. - Fotos oder Videos hinter Szenen:
imagepro Szene oderbackgroundfür den gesamten Kurzfilm. Sie werden unter der Themenfarbe abgedunkelt, damit der Text lesbar bleibt. Verwende Dateien, die dem Benutzer gehören oder für die er eine Lizenz hat, und gib sie in der Bildunterschrift an, wenn die Lizenz es verlangt. - Gebündelte Schriftarten: Anton (kondensiert, Großbuchstaben, laut), Poppins, Inter. Alle OFL.
- Um die Vorlagen selbst zu ändern, bearbeite
src/Short.tsxund siehe mitnpm run studioeine Vorschau.
Randfälle
- Keine Quelle für eine Zahl: verwende sie nicht. Sage, was fehlt.
- Text, der nicht passt: teile die Szene; verkleinere die Schrift nicht unter die Mindestgröße (der Renderer wird es nicht tun).
- Rechts-nach-links- oder CJK-Text oder Emoji: die gebündelten Schriftarten decken sie nicht ab und sie können als leere Kästchen erscheinen. Sage dies und lasse sie weg (Emoji können in die Bildunterschrift).
- Benutzer möchte einen trendigen Sound: API-Posts können keinen hinzufügen. Poste auf TikTok mit
postMode: MEDIA_UPLOAD, damit es in ihrem TikTok-Posteingang landet, um es in der App fertigzustellen. - Render schlägt auf Linux fehl aufgrund fehlender Bibliotheken: Installiere die Pakete, die in
references/platform-specs.mdaufgeführt sind. - Windows: Übergib Props immer in der JSON-Datei, niemals inline in der Befehlszeile.
Qualitätsbarriere
Bevor du es als erledigt bezeichnest, sollte es all dies erfüllen:
- Frame 0 zeigt den gesamten Aufhänger (prüfe cuts.jpg); etwa 10 Wörter oder weniger, die den Nutzen nennen.
- Jede Szene sagt eine Sache; keine Szene über etwa 14 Wörter.
- Jede Zahl stimmt mit ihrer Quelle überein; die Quelle ist auf dem Bildschirm oder in der Bildunterschrift.
- Keine Warnungen, oder der Benutzer hat sie gesehen und sich für
--forceentschieden. - Beide Blätter überprüft: kein Text außerhalb der gestrichelten Sicherheitslinie, Highlights auf den richtigen Wörtern.
- 15 bis 59 Sekunden.
- Eine eigene Version für jedes Konto.
- Der Benutzer hat bestätigt, bevor etwas gepostet wurde.