Remotion Shorts Skill

Was macht Remotion Shorts Skill?

Du schreibst einen Kurzfilm als JSON-Datei mit Szenen. Das gebündelte Remotion-Projekt legt die Wörter aus, taktet jede Szene nach 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 für jedes Video keinen Remotion-Code. Die Vorlagen sind festgelegt und getestet; deine Aufgabe ist das Drehbuch: was jeder Bildschirm sagt, in welcher Reihenfolge und wie schnell.

0. Einrichtung (einmal pro Rechner)

Erfordert 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, mit dem Remotion rendert (100 bis 150 MB). Es dauert beim ersten Mal 1 bis 3 Minuten. Führe es erneut aus, nachdem das Skill aktualisiert wurde: es aktualisiert die Vorlagendateien (vom Benutzer geänderte Dateien werden als .bak behalten) 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 und deutlich, vor dem ersten Rendern mit.

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, die du belegen 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 Kernaussage. Ein Kurzfilm sagt eine Sache.
• Aussehen. Ein Theme (ink, paper, volt, ocean, clean) oder deren Markenfarben und ein Handle für den Endbildschirm.
• Audio. Integrierte Soundeffekte sind standardmäßig aktiviert (ein Treffer beim Hook, ein Whoosh bei jedem Schnitt, ein Pop bei Highlights, Ticks bei Zä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.md fü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 Kurzversion:

• Szene 1 ist ein Hook, der den Nutzen in etwa 10 Wörtern oder weniger angibt: eine Zahl, eine Behauptung oder das Listenversprechen ("5 kostenlose Tools, die ... ersetzen"). Es ist ab Frame 0 vollständig auf dem Bildschirm. Wenn der Hook eine Zahl hat, setze sie in big, damit sie das Erste ist, worauf das Auge fällt.
• Eine Idee pro Szene. Eine Szene ist ein Moment, kein Absatz. Statistik-Szenen tragen eine Zahl und deren Bedeutung. Listenelemente zählen auf- oder abwärts; gib im Hook an, welches.
• Echte Informationen in jeder Szene. Ein Video mit vorgefertigtem Text ohne neue Inhalte ist das, was YouTube als unauthentischen Content und Instagram als unoriginell bezeichnet. Füge niemals Füllmaterial hinzu.
• Zahlen sind exakt und belegt. Setze die Quelle in footer ("Daten: USGS"). Runde niemals eine Zahl zu einer anderen Aussage.
• Ende mit einer Aktion oder einem Satz, der zum Hook zurückführt, damit die Schleife kontinuierlich wirkt. Kein "Danke fürs Zuschauen".
• Länge: 15 bis 45 Sekunden ist das Ziel; der Renderer warnt ab 59 Sekunden.

Schreibe short.json im Projektordner. Das vollständige Format, jeder Szenentyp und jede Option befindet sich 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 Süßwasser" },
    { "type": "stat", "value": "96,5", "suffix": "%", "label": "ist Salzwasser in den Ozeanen" },
    { "type": "stat", "value": "68,7", "suffix": "%", "label": "des Süßwassers ist Eis und Gletscher", "highlight": "Eis und Gletscher" },
    { "type": "end", "text": "Merke dir das für den Quizabend", "highlight": "Merke dir" }
  ]
}

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 des sicheren Bereichs, die mit einer dünnen gestrichelten Linie markiert sind (Text muss innerhalb dieser Linie 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 Hook, sobald er angekommen ist (lade ihn als Cover für Reels hoch).
• out/short/report.json: Zeitsteuerungen, Zeilenumbrüche und Warnungen.

Öffne beide Blätter und schau 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 Hook. 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 zu langer Hook, ein Highlight, das nicht im Text ist, eine zu schnell zu lesende Szene, ein Tempo außerhalb von 0,85 bis 1,25 oder ein Kurzfilm über 59 Sekunden. Korrigiere das Drehbuch; verwende --force nur, wenn der Benutzer die Warnung gesehen hat und sie trotzdem möchte. Einige Probleme sind Fehler, die --force nicht überschreiben kann, z. B. ein Wort, das bei keiner Größe auf den Bildschirm passt: diese würden Text außerhalb des Bildschirms anzeigen.

4. Rendern

node render.mjs short.json

Schreibt out/short/short.mp4: 1080x1920, 30 fps, H.264, yuv420p, AAC (eine Stille-Spur, 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. Rechner mit 8 GB Arbeitsspeicher rendern 2 Frames gleichzeitig; wenn ein Render-Vorgang wegen Speichermangels abgebrochen wird, führe ihn erneut mit --concurrency 1 aus.

Bevor du es zeigst, nimm drei Frames und schau sie dir an (Anfang, Mitte, Ende), oder spiele es ab, wenn dein Client dies kann. Zeige dann dem Benutzer das Cover, das Blatt und den MP4-Pfad.

Mehrere Konten: Poste niemals dieselbe Datei auf mehrere Konten. Erstelle eine Variante pro Konto (ein anderer Hook, 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:

1. social_accounts_list um die Konten zu finden (verbinde sie zuerst, falls nötig).
2. Für TikTok: social_accounts_get_platform_inputs für das Konto: die Datenschutzoptionen und das längste Video, das es erlaubt. Der Benutzer wählt den Datenschutz; es gibt keinen Standard.
3. Hochladen: media_uploads_create_session mit der genauen Byte-Größe aus report.json, speichere die Antwort als session.json, führe node upload.mjs session.json out/short/short.mp4 aus, dann media_uploads_complete_session bis es READY ist.
4. Schreibe die Bildunterschrift pro Plattform (TikTok und Reels: ein Satz, der das Video ergänzt, plus 3 bis 5 spezifische Hashtags; YouTube: ein Titel unter 100 Zeichen plus eine Beschreibung). Verwende contentOverride für plattformspezifische Texte.
5. posts_validate, dann zeige dem Benutzer: Konten, Bildunterschrift pro Plattform, Datenschutz, Zeitplan mit Zeitzone, das Cover. Warte auf ein klares Ja. Dann posts_create und posts_get.

Angabefelder: isYourBrand: true bei 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 nach, rate niemals.

6. Rückmeldung geben

Zeige: den MP4-Pfad, die 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 und melde das Datum, an dem sie gesammelt wurden.

Das Aussehen bearbeiten

• Markenfarben: Übergib theme als Objekt (bg, fg, accent, accentText, font, uppercase). Halte den Textkontrast bei 7:1 oder besser; überprüfe auch die Akzentfarbe auf dem Hintergrund.
• Fotos oder Videos hinter den Szenen: image pro Szene oder background für den gesamten Kurzfilm. Sie werden unter der Themenfarbe abgedunkelt, damit der Text lesbar bleibt. Verwende Dateien, die der Benutzer besitzt oder für die er eine Lizenz hat, und gib sie in der Bildunterschrift an, wenn die Lizenz dies verlangt.
• Gebündelte Schriftarten: Anton (kondensiert, Großbuchstaben, laut), Poppins, Inter. Alle OFL.
• Um die Vorlagen selbst zu ändern, bearbeite src/Short.tsx und erstelle eine Vorschau mit npm run studio.

Randfälle

• Keine Quelle für eine Zahl: verwende sie nicht. Sage, was fehlt.
• Text, der nicht passt: teile die Szene auf; verkleinere die Schrift nicht unter die Mindestgröße (der Renderer wird es nicht zulassen).
• Rechts-nach-links- oder CJK-Text oder Emojis: Die gebündelten Schriftarten decken diese nicht ab und sie werden möglicherweise als leere Kästchen angezeigt. Sage dies und lasse sie weg (Emojis können in die Bildunterschrift).
• Benutzer möchte einen trendigen Sound: API-Beiträge können keinen hinzufügen. Poste auf TikTok mit postMode: MEDIA_UPLOAD, damit es im TikTok-Posteingang des Benutzers landet, um es in der App fertigzustellen.
• Render-Vorgang schlägt unter Linux mit fehlenden Bibliotheken fehl: Installiere die in references/platform-specs.md aufgeführten Pakete.
• Windows: Übergib Eigenschaften immer in der JSON-Datei, niemals inline in der Befehlszeile.

Qualitätskriterien

Bevor du es als erledigt bezeichnest, sollte es all diese Punkte erfüllen:

• Frame 0 zeigt den gesamten Hook (überprü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 --force gewählt.
• Beide Blätter überprüft: kein Text außerhalb der gestrichelten Sicherheitslinie, Highlights auf den richtigen Wörtern.
• 15 bis 59 Sekunden.
• Eine eindeutige Version für jedes Konto.
• Der Benutzer hat vor dem Posten bestätigt.