Communitygithub.com

CleanExpo/Pi-Dev-Ops

/remotion-video Ein-Kommando-Skill für Remotion und Einstiegspunkt für das Remotion Skills Package. Nutzbar für Videos, Erklärfilme, Werbung, Promos, Reels, Intros, SocialCuts, Marketing-, Schulungs- oder Launch-Videos. Liest das Briefing, klassifiziert die Absicht, erzwingt eine einzige Synthex ElevenLabs-Stimme, erstellt einen Produktions- und Wellenplan und delegiert die richtigen Sub-Skills in topologischer Reihenfolge. Wird immer zuerst aufgerufen.

Was ist Pi-Dev-Ops?

Dieser Skill, **remotion-orchestrator**, ist der zentrale Einstiegspunkt für das Remotion Skills Package – eine Sammlung von zehn aufeinander abgestimmten Skills zur automatisierten Erstellung von Marketing-Videos mit der Bibliothek Remotion. Er wird immer zuerst aufgerufen, wenn ein Nutzer ein Video-Kommando (z. B. `/remotion-video`) eingibt oder eine entsprechende Absicht aus einem freitextlichen Briefing erkannt wird. Der Skill nimmt das kurze Briefing entgegen, prüft es über ein zwingendes Discovery-Gate (erforderliche Felder wie Marke, Komposition, Kanal, Dauer und Thema), erstellt einen strukturierten Wellenplan (Wave Plan) und delegiert die Arbeit an die jeweils passenden Sub-Skills – darunter Markenrecherche, Drehbuch, Farbschemata, Motion Design und der finale Render-Pipeline. Wichtigste Härte-Regel: Es kommt ausschließlich eine einzige, vorab konfigurierte Synthex ElevenLabs-Stimme zum Einsatz – keine Mehrsprach- oder Szenen-Wechsel. Der Skill erzeugt keinen finalen Videoclip, sondern nur Planungsdokumente (production-packet.json, script.md, preflight-report.md, render-command.sh) und den Wellenplan als JSON. Erst nach der Render-Phase öffnet er ein Linear-Ticket im zugehörigen Projekt. Plattformunabhängig und global in `~/.claude/skills/` installiert, funktioniert er projektspezifisch: Jedes aufrufende Projekt liefert seine eigenen Konfigurationen und API-Schlüssel (z. B. für ElevenLabs, Linear, Canva). Der Skill vermeidet Über-Engineering, indem er die Wellenzahl je nach Videolänge begrenzt, und weigert sich, unspezifische oder vage Briefings zu akzeptieren, um qualitativ hochwertige Markenrender sicherzustellen.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/CleanExpo/Pi-Dev-Ops/tree/HEAD/skills/remotion-orchestrator

In Ihrer bevorzugten KI fragen

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

Dokumentation

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.md und render-command.sh schreiben.
  • 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

FeldTypHinweise
brandBrandSlugMuss in src/brands/ aufgelöst werden. Unbekannt → zuerst remotion-brand-research auslösen.
compositionExplainer | Intro | SocialAd | NIRReport | ProductDemov1 unterstützt nur Explainer; andere mit Hinweis zurückfallen lassen.
channellinkedin | youtube | instagram | tiktok | trainingBestimmt Seitenverhältnis und Dauerdisziplin.
aspectRatio1920x1080 | 1080x1920 | 1080x1080Wenn weggelassen, Standard aus channel.
durationSec15 | 30 | 60 | 90 | 120Bestimmt die maximale Anzahl Wellen.
topicstringEin Satz, der beschreibt, was das Video sagt. „Markenbekanntheitsvideo“ allein wird abgelehnt – der spezifische Punkt muss genannt werden.
audiencestringWenn 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

  • topic liest sich wie eine Kategorie („unser Produkt“, „der Launch“) statt einer konkreten Behauptung → blockieren.
  • composition ≠ Explainer in 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 (via app/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-Anfrage
  • repo_url — normalerweise local:Pi-Dev-Ops/remotion-studio
  • linear_team_id, linear_project_id — vorab aus config/harness/projects.json aufgelö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-SignalKomposition
„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 → dr
  • nrpg → nrpg
  • restoreassist, ra, nir → ra
  • carsi → carsi
  • ccw, 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:

MarkeLinear-TeamProjekt
raa8a52f07-63cf-4ece-9ad2-3e3bd3c15673 (RA)3c78358a-b558-4029-b47d-367a65beea7b
dr / nrpg43811130-ac12-47d3-9433-330320a76205 (DR)d2c1d63b-1e85-424d-9278-efff15b0d46b
carsi91b3cd04-... (GP)zur Laufzeit aufgelöst
ccwzur Laufzeitzur 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:

  1. generate-design (design_type: your_story für 9:16, youtube_thumbnail für 16:9) mit einer detaillierten markenkonformen Abfrage – Palette/Überschrift in der Abfrage übergeben; Canva rendert Überschriftstext zuverlässig.
  2. 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 oder vercel env pull über Projekte/Umgebungen hinweg ausführen, um GEMINI_API_KEY / OPENAI_API_KEY / AI_GATEWAY_API_KEY zu finden. Der Auto-Mode-Klassifizierer blockiert dies als Credential-Erkundung und verschwendet die gesamte Sitzung.
  • Vercel-„Sensitive“-Env-Vars sind schreibgeschützt – vercel env pull gibt 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 entfernt DYLD_*).

Was dieser Skill NICHT tut

  • Erstellt keine Kompositionen – das macht remotion-composition-builder.
  • Führt kein npx remotion render aus – das macht remotion-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.

BelangWo 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.
MarkenkonfigurationenSynthex/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-AusgabeStandardmäß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:

  1. remotion-brand-research gegen die öffentlichen Quellen der Marke ausführen.
  2. remotion-brand-codify ausführen, um Synthex/packages/brand-config/src/brands/{slug}.ts zu erstellen.
  3. Die BrandSlug-Union in Synthex/packages/brand-config/src/types.ts erweitern.
  4. In Synthex/packages/brand-config/src/brands/index.ts registrieren.
  5. npm run typecheck von Synthex/packages/brand-config/ ausführen (dann npm run build, um dist/ neu zu generieren).

Derzeit registrierte Marken: dr, nrpg, ra, carsi, ccw, synthex, unite.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

CleanExpo/Pi-Dev-Ops

Produce one or many consistent, on-brand faceless marketing videos from a topic: script, ElevenLabs voiceover with timestamps, one styled illustration per beat, ffmpeg stitch to 1080p, optional Unlisted YouTube upload. The look is a named style from styles.md (flat-line, hand-doodle, bold-kinetic, cinematic-photoreal, minimal-corporate, retro-print), so one command yields repeatable output per brand. The automated pipeline; distinct from faceless-video and video-director.

CleanExpo/Pi-Dev-Ops

Produce a faceless YouTube-style video (hand-drawn doodle / simple-illustration channels like Zen, Nick Invest) end-to-end from a single topic. ASKS FACT-vs-STORY mode first (non-fiction educational vs fiction storytelling) and branches the whole run — built to serve multiple clients/channels, not one fixed format. Reverse-engineers a proven reference video's script format, writes a new script in that format, generates an ElevenLabs voiceover with timestamps, creates one styled Artlist (AI Toolkit) image per timestamp, and stitches everything with FFmpeg — fully automated, no human recording. Use when the user says "faceless video", "/faceless-video", "doodle video", "make a YouTube short/long-form in the Zen style", or wants an organic faceless-channel content piece. Composes with video-distribution-strategist (channel/launch) and video-director (when motion/edit polish is wanted instead of stills).

CleanExpo/Pi-Dev-Ops

The 15+ year brand director extension of `brand-guardian` specifically for video — frame-by-frame audit of brand-mark integrity, Gun Metal `#1a1a1a` + Candy Red `#dc143c` consistency, NO AI slop, NO Lucide icons, custom geometric marks ONLY, real logos correctly placed. PASS / FAIL gate before any client-facing video ships. Use after `video-colorist` completes the grade pass.

CleanExpo/Pi-Dev-Ops

The 15+ year Director-of-Photography persona (Roger Deakins / Emmanuel Lubezki / Hoyte van Hoytema-tier) that owns shot composition, lens psychology, motion language, and the decision of which source (Remotion / Hyperframes / stock cinematic) each scene uses. Extends the existing `remotion-designer` + `remotion-motion-language` skills with a frame-by-frame shot-language framework. Use when the user says "cinematography", "shot list", "framing", "DoP", "lens choice", or invoked by `video-director` Phase 2.

CleanExpo/Pi-Dev-Ops

The 15+ year colorist persona (Light Iron / Company 3 / The Mill-tier) that applies per-brand LUT + grade pass to every Unite-Group video. Closes the "raw Remotion render colours" gap — today Remotion outputs whatever colours BrandConfig declares with zero cinematic grade. Use when the user says "colour", "grade", "LUT", "look", "cinematic finish", or invoked by `video-director` Phase 3 (post-production) after `video-sound-designer` mixes audio.

CleanExpo/Pi-Dev-Ops

The Creative Director persona that owns brief intake, composition selection and narrative POV for every Unite-Group video. ENTRY POINT for the Video Agency: use for any video creation brief (explainer, promo, social cut, demo reel, case study, testimonial, client video). Dispatches the full production team: script-writer, cinematographer, editor, sound designer, colorist, brand-guardian.

CleanExpo/Pi-Dev-Ops

The 15+ year platform-native distribution expert (early TikTok creator economy + YouTube algorithm + LinkedIn organic reach + IG Reels native specialist) that owns per-platform aspect ratio + duration cap + caption format + hook density + thumbnail composition. Extends `remotion-marketing-strategist` with platform-native specs locked per BrandConfig. Use when the user says "which platform", "distribution", "channel-fit", "thumbnail", "captions", or invoked by `video-director` Phase 4 (QA + Delivery) for per-platform cuts.

CleanExpo/Pi-Dev-Ops

The 15+ year screenwriter persona (Pixar / Apple keynote / Nike spot tier) that engineers hooks (0-3s), retention beats (7-15s), narrative tension curves, and CTA placement. Extends the existing `remotion-screen-storyteller` skill with a structural framework lifted from Pixar's 22 Rules + Apple keynote architecture. Use when the user says "script", "voiceover", "narration", "hook", "story arc", or invoked by `video-director` Phase 2.

CleanExpo/Pi-Dev-Ops

The 15+ year sound designer persona (Skywalker Sound / Sound Lounge / Audio Network-tier) that mixes ElevenLabs voiceover with music bed, sound effects, ambient texture, and audio polish. Closes the single biggest gap in the existing Remotion pipeline — today voiceover is the ONLY audio; this skill adds music + SFX + mix. Use when the user says "sound design", "audio mix", "music bed", "SFX", "score this", or invoked by `video-director` Phase 3 (post-production).

CleanExpo/Pi-Dev-Ops

Converts a BrandResearch dossier into THREE artifacts — (1) typed BrandConfig TypeScript at Synthex/packages/brand-config/src/brands/{slug}.ts (runtime/behaviour — voice, voiceover, motion, audience, channel, forbiddenWords); (2) spec-conformant {slug}.design.md at Synthex/packages/brand-config/src/brands/{slug}.design.md (visual tokens — colour, typography, spacing, components, layout, elevation); (3) human-readable 9-section .md projection at Pi-Dev-Ops/remotion-studio/src/brands/{slug}.md derived from BOTH. Boundary contract at Pi-Dev-Ops/remotion-studio/src/brands/CONTRACT.md. Triggered after remotion-brand-research, or when the user pastes brand assets and says "codify". PRs are auto-merge:false — a human reviews before merge.

CleanExpo/Pi-Dev-Ops

Researches a portfolio company's visual identity from public sources (homepage, about page, marketing copy, GitHub README) and produces a structured BrandResearch dossier. Triggered when `Synthex/packages/brand-config/src/brands/{slug}.ts` (canonical home per RA-1985 / Synthex SYN-897) is missing, older than 90 days, or the user explicitly says "refresh brand for {brand}". Output feeds remotion-brand-codify.

CleanExpo/Pi-Dev-Ops

Generates a complete, accessible palette (primary, secondary, accent, 4-step neutral, semantic, and dark variant) from one to three hex anchors plus a colour-family classification. Validates WCAG-AA contrast for all text-on-background pairs. Triggered when a BrandConfig has fewer than 5 defined colours or contrast fails.

CleanExpo/Pi-Dev-Ops

Authors or extends a Remotion composition (.tsx) wired to BrandConfig + Storyboard + layout spec + motion. The actual builder skill — runs as a Sonnet-tier worker. Triggered after brand, storyboard, designer, and motion-language outputs are ready. Produces the file under remotion-studio/src/compositions/ and registers it in src/Root.tsx.

CleanExpo/Pi-Dev-Ops

Visual-design specialist for Remotion compositions. Sets layout grid, typography hierarchy, white-space, scene framing, and visual rhythm for a given composition + brand. Triggered after remotion-composition-builder for QA, or upfront when authoring a new composition type. Produces a layout spec consumed by remotion-composition-builder.

CleanExpo/Pi-Dev-Ops

Use when a Remotion video needs creative direction — hook, visual sequence, scene purpose, motion restraint, and CTA direction before render.

CleanExpo/Pi-Dev-Ops

Use when a Remotion video has timing, sync, transition, caption, pacing, or audio-fit risk and needs editing discipline before render.

CleanExpo/Pi-Dev-Ops

Use when /remotion-video needs existing Synthex ElevenLabs, brand-config, Remotion, output storage, Claude, or Hermes integration without adding vendors.

CleanExpo/Pi-Dev-Ops

Tunes a video's format and message for the target channel — LinkedIn, YouTube, Instagram Reel, internal training. Sets aspect ratio, total duration, hook timing, CTA timing, and pacing. Triggered when the brief mentions a specific channel or campaign goal. Output feeds remotion-screen-storyteller and remotion-composition-builder.

CleanExpo/Pi-Dev-Ops

Designs a brand-specific motion vocabulary — easing curves, default scene durations, signature entry/exit, transition frames. Each brand gets one signature move (rise / sweep / pulse / iris / whip) that recurs across compositions to build motion-recognition. Triggered when BrandConfig.motion is empty.

CleanExpo/Pi-Dev-Ops

Use when a Remotion video job needs production gates, render evidence, output discipline, and pass/fail validation before it can be called shippable.

Verwandte Skills