remotion-orchestrator — Einstiegspunkt des Remotion Skills Packages
/remotion-video Ein-Kommando-Befehl
/remotion-video ist der Ein-Kommando-Pfad für Remotion-Marketingvideos. Er verwandelt ein grobes Briefing in ein einziges gesteuertes Produktionspaket, einen einzigen Render-Pfad und einen einzigen abschließenden Evidenzbericht.
Harte Regeln für diesen Befehlspfad:
- nur eine einzige Stimme; keine Mehrsprecher oder szenenbezogener Stimmentwechsel.
- ausschließlich vorhandene Synthex ElevenLabs-Zugangsdaten und Stimmkonfiguration verwenden.
- keine neuen Anbieter, keine neuen Konten, keine Connector-Plattformen.
- mit einem Trockenlauf beginnen, es sei denn der Operator fordert ausdrücklich einen Produktionsrender an.
.harness/remotion/<jobId>/production-packet.json,script.md,preflight-report.mdundrender-command.shschreiben.- generierte MP4s niemals committen.
Der Befehl durchläuft remotion-script, remotion-production, remotion-direction, remotion-editing, remotion-integrations und remotion-professionalism, während der bestehende Workflow des Remotion Skills Packages erhalten bleibt.
Einziger Einstiegspunkt für das Remotion Skills Package – eine Gruppe von 10 verwandten Skills (remotion-orchestrator, remotion-brand-research, remotion-brand-codify, remotion-designer, remotion-colour-family, remotion-motion-language, remotion-screen-storyteller, remotion-marketing-strategist, remotion-composition-builder, remotion-render-pipeline), global installiert unter ~/.claude/skills/remotion-* (symlink auf ~/Pi-Dev-Ops/skills/remotion-*). Verfügbar in jedem Projekt, nicht nur in Pi-Dev-Ops.
Discovery-Briefing-Pforte (Runde 1, obligatorisch)
Übernommen von nexu-io/open-design (Apache-2.0). Bevor ein Wellenplan erstellt wird, wird das Briefing festgehalten. Weigere dich fortzufahren, bis jedes erforderliche Feld ausgefüllt ist – vage Briefings erzeugen überlange Wellenpläne und markenfremde Render.
Erforderliche Felder
| Feld | Typ | Hinweise |
|---|---|---|
brand | BrandSlug | Muss in src/brands/ aufgelöst werden. Unbekannt → zuerst remotion-brand-research auslösen. |
composition | Explainer | Intro | SocialAd | NIRReport | ProductDemo | v1 unterstützt nur Explainer; andere mit Hinweis zurückfallen lassen. |
channel | linkedin | youtube | instagram | tiktok | training | Bestimmt Seitenverhältnis und Dauerdisziplin. |
aspectRatio | 1920x1080 | 1080x1920 | 1080x1080 | Wenn weggelassen, Standard aus channel. |
durationSec | 15 | 30 | 60 | 90 | 120 | Bestimmt die maximale Anzahl Wellen. |
topic | string | Ein Satz, der beschreibt, was das Video sagt. „Markenbekanntheitsvideo“ allein wird abgelehnt – der spezifische Punkt muss genannt werden. |
audience | string | Wenn weggelassen, von BrandConfig.audience.primary übernommen, aber der Gründer muss bestätigen. |
Optional: school (Override des visuellen Stils für den Farbgenerator), voiceoverScript (Storyteller überspringen, falls vorab geschrieben), referenceComposition (bestehender Job zum Remixen).
Harte Abbruchbedingungen
topicliest sich wie eine Kategorie („unser Produkt“, „der Launch“) statt einer konkreten Behauptung → blockieren.composition≠Explainerin v1 ohne expliziten Fallback-Hinweis → blockieren.- Mehrere Marken in einem Briefing genannt → in N parallele Jobs aufteilen (eine pro Marke); niemals mischen.
Die Pforte läuft vor der Berechnung des Wellenplans. Ein blockiertes Briefing erreicht niemals den Dispatcher.
Aufruf
Der Benutzer kann das Paket aufrufen, indem er:
- eines der folgenden sagt: „Remotion Skills Package verwenden“, „remotion package“, „remotion verwenden“.
- einen einzelnen Skill nennt (z. B. „remotion-designer verwenden, um dieses Layout zu prüfen“).
- ein Briefing einreicht, das als
intent: "video"klassifiziert wird (viaapp/server/brief.py).
Übersetzt ein Freitext-Briefing in einen strukturierten Render-Job und einen Wellenplan, den der Pi-Dev-Ops-Orchestrator (app/server/orchestrator.py) per P3-B-Fan-Out ausliefert.
Das Remotion-Projekt
Alle Kompositionen, Markenkonfigurationen, Bewegungs-/Farbhilfsmittel und der Render-Einstieg liegen unter:
../../remotion-studio/
Wenn von einem anderen Projekt aus gearbeitet wird, wechseln Sub-Skills mit cd in diesen Pfad, bevor Marken-/Kompositionsdateien gelesen oder bearbeitet werden. Der Render-Einstieg ist npx tsx render/render.ts ... innerhalb von remotion-studio.
Auslöser
Briefing enthält eines von: video, explainer, promo, ad, reel, intro, outro, cta, social cut, 60s/30s/15s, render, marketing video, training video, release video, feature video, gepaart mit einem der Markenidentifikatoren dr / disaster recovery / nrpg / ra / restoreassist / carsi / ccw / carpet cleaners warehouse.
Eingaben
Der Pi-Dev-Ops-Planer (Opus 4.7) ruft diesen Skill auf mit:
brief— ursprüngliche Freitext-Anfragerepo_url— normalerweiselocal:Pi-Dev-Ops/remotion-studiolinear_team_id,linear_project_id— vorab ausconfig/harness/projects.jsonaufgelöst
Ausgabe
Ein Wellenplan-JSON, geschrieben in remotion-studio/.research/wave-plans/{job_id}.json mit folgender Struktur:
{
"jobId": "ra-nir-explainer-2026-04-28T15-30-00",
"brand": "ra",
"composition": "Explainer",
"channel": "linkedin",
"durationSec": 60,
"topic": "RestoreAssist NIR Phase 1 standardisation",
"linear": { "teamId": "...", "projectId": "..." },
"outputPath": "output/ra-nir-explainer-2026-04-28T15-30-00.mp4",
"waves": [
{ "id": 1, "parallel": [ {"skill":"remotion-brand-research","if":"brands/ra.ts missing or stale"}, {"skill":"remotion-marketing-strategist"} ] },
{ "id": 2, "parallel": [ {"skill":"remotion-screen-storyteller"}, {"skill":"remotion-colour-family","if":"palette incomplete"}, {"skill":"remotion-motion-language","if":"motion missing"} ] },
{ "id": 3, "parallel": [ {"skill":"remotion-brand-codify","if":"any new brand artifacts"}, {"skill":"remotion-designer"} ] },
{ "id": 4, "serial": [ {"skill":"remotion-composition-builder"}, {"skill":"remotion-render-pipeline"} ] }
]
}
Wellenanzahl-Disziplin
- ≤3 Wellen für Ausgabe <30s
- ≤5 Wellen für Ausgabe ≤120s
- ≤8 Wellen für Ausgabe >120s
Übermäßige Zerlegung ist der Fehlermodus, gegen den dies schützt.
Kompositions-Routing (Briefing → Komposition)
| Briefing-Signal | Komposition |
|---|---|
| „explainer“, „feature video“, „how it works“ | Explainer |
| „intro“, „title card“, „channel opener“ | Intro (v1.1) |
| „ad“, „promo“, „reel“, „social cut“, „Instagram“, „TikTok“ | SocialAd (v1.1) |
| „NIR report“, „inspection report“, RA + „report“ | NIRReport (v1.1) |
| „demo“, „product walkthrough“ | ProductDemo (v1.1) |
v1 unterstützt nur Explainer. Andere Kompositions-IDs geben zurück: „{Composition} erscheint in v1.1 – Zurückfall auf Explainer mit kanalspezifischem Framing“.
Markenauflösung
Schlüsselwörter abgleichen → BrandSlug:
disaster recovery,dr→drnrpg→nrpgrestoreassist,ra,nir→racarsi→carsiccw,carpet cleaners warehouse→ccw
Wenn das Briefing mehrere Marken nennt, den Planer bitten, in N parallele Jobs aufzuteilen (eine pro Marke) und N Wellenpläne zu erstellen. Niemals Marken in einer Komposition mischen.
Linear-Routing
Nachdem der Render-Skill die MP4 geschrieben hat, öffnet dieser Skill (oder der Render-Skill) ein Linear-Ticket im Projekt, das aus config/harness/projects.json abgebildet wird:
| Marke | Linear-Team | Projekt |
|---|---|---|
| ra | a8a52f07-63cf-4ece-9ad2-3e3bd3c15673 (RA) | 3c78358a-b558-4029-b47d-367a65beea7b |
| dr / nrpg | 43811130-ac12-47d3-9433-330320a76205 (DR) | d2c1d63b-1e85-424d-9278-efff15b0d46b |
| carsi | 91b3cd04-... (GP) | zur Laufzeit aufgelöst |
| ccw | zur Laufzeit | zur Laufzeit |
Miniaturansicht- und Standbildgenerierung (Canva zuerst – KEINE Credential-Jagd)
Für ein Video-Thumbnail, Poster oder ein anderes Marketing-Standbild ist der zuverlässige Weg das verbundene Canva MCP, nicht ein roher Bildgen-API-Key:
generate-design(design_type: your_storyfür 9:16,youtube_thumbnailfür 16:9) mit einer detaillierten markenkonformen Abfrage – Palette/Überschrift in der Abfrage übergeben; Canva rendert Überschriftstext zuverlässig.- Die Kandidaten-Vorschauen herunterladen und das beste auswählen;
create-design-from-candidate→export-design(PNG mit Ziel-WxH,export_quality: pro).
Harte Regeln (auf die harte Tour gelernt, 2026-07-01):
- Niemals nach Bildgen-Keys suchen. Keine
.env-Dateien scannen odervercel env pullüber Projekte/Umgebungen hinweg ausführen, umGEMINI_API_KEY/OPENAI_API_KEY/AI_GATEWAY_API_KEYzu finden. Der Auto-Mode-Klassifizierer blockiert dies als Credential-Erkundung und verschwendet die gesamte Sitzung. - Vercel-„Sensitive“-Env-Vars sind schreibgeschützt –
vercel env pullgibt sie LEER zurück. Nicht versuchen, einen zu ziehen; den Wert aus seiner ursprünglichen Quelle holen oder Canva verwenden. - Wenn kein Bildtool verbunden und kein Key in EINER gezielten Prüfung erreichbar ist, stoppen und den Gründer einmal fragen – Canva sofort anbieten.
- Ein Frame-Grab aus der gerenderten MP4 (gebündeltes ffmpeg unter
node_modules/@remotion/compositor-*/ffmpeg) ist der Offline-Fallback. Hinweis: auf macOS den sibling*.dylib-Dateien ins cwd symlinken, damit das gebündelte ffprobe/ffmpeg auflöst (SIP entferntDYLD_*).
Was dieser Skill NICHT tut
- Erstellt keine Kompositionen – das macht
remotion-composition-builder. - Führt kein
npx remotion renderaus – das machtremotion-render-pipeline. - Bearbeitet keine BrandConfig-Dateien – das macht
remotion-brand-codify.
Er plant und delegiert nur.
Nutzungsmodell pro Projekt
Das Paket ist eine gemeinsame Infrastruktur; jedes aufrufende Projekt liefert seine eigene Laufzeitkonfiguration und API-Schlüssel.
| Belang | Wo es lebt |
|---|---|
| Skill-Definitionen | ~/.claude/skills/remotion-* (symlink → Pi-Dev-Ops/skills/remotion-*) – global verfügbar. |
| Remotion Node-Projekt (Kompositionen, Markenkonfigurationen, Render-Einstieg) | ../../remotion-studio/ – einzelnes gemeinsames Substrat. |
| Markenkonfigurationen | Synthex/packages/brand-config/src/brands/{slug}.ts – eine einzige Quelle der Wahrheit pro Marke, von jedem Projekt verwendet, das für diese Marke rendert. (Migriert von Pi-Dev-Ops/remotion-studio/src/brands/ gemäß RA-1985 / Synthex SYN-897.) |
| API-Schlüssel (ElevenLabs, Telegram, Supabase, Linear, Remotion-Lizenz) | .env / .env.local des aufrufenden Projekts. Skills lesen process.env zur Renderzeit. |
| Gerenderte MP4-Ausgabe | Standardmäßig das .remotion-renders/-Verzeichnis des aufrufenden Projekts. Überschreiben mit --out=. |
Hinzufügen einer neuen Marke für Ihr Projekt
Wenn Ihr Projekt (z. B. Synthex) für eine Marke rendern muss, die noch nicht in src/brands/ vorhanden ist:
remotion-brand-researchgegen die öffentlichen Quellen der Marke ausführen.remotion-brand-codifyausführen, umSynthex/packages/brand-config/src/brands/{slug}.tszu erstellen.- Die
BrandSlug-Union inSynthex/packages/brand-config/src/types.tserweitern. - In
Synthex/packages/brand-config/src/brands/index.tsregistrieren. npm run typecheckvonSynthex/packages/brand-config/ausführen (dannnpm run build, umdist/neu zu generieren).
Derzeit registrierte Marken: dr, nrpg, ra, carsi, ccw, synthex, unite.