Communitygithub.com

CleanExpo/Pi-Dev-Ops

Visueller Design-Spezialist für Remotion-Kompositionen. Legt Layout-Raster, Typografie-Hierarchie, Weißraum, Szenenrahmung und visuellen Rhythmus für eine gegebene Komposition und Marke fest. Wird nach dem remotion-composition-builder zur Qualitätssicherung oder vorab beim Erstellen eines neuen Kompositionstyps ausgelöst. Erzeugt ein Layout-Spezifikation, das vom remotion-composition-builder verwendet wird.

Was ist Pi-Dev-Ops?

Dieses Skill, genannt 'remotion-designer', ist ein visueller Design-Spezialist für Remotion-Kompositionen. Es wird typischerweise von einem Orchestrator-Skill ausgelöst, sobald ein erster Entwurf vorliegt, oder wenn ein neuer Kompositionstyp (z. B. Intro, SocialAd) erstellt wird. Das Ziel ist es, das visuelle Erscheinungsbild zu definieren: Layout-Raster, Typografie-Hierarchie, Farbanwendung, Weißraum und die Platzierung von Komponenten wie Logos. Es arbeitet streng auf Basis der Design-Token einer Marke (definiert in einer design.md-Datei) und gibt keine Pixelwerte oder Hex-Codes direkt aus. Stattdessen verweist es auf die Token-Namen, die erst zur Build-Zeit vom remotion-composition-builder aufgelöst werden. Das Skill unterstützt die Plattformen Claude Code, Cursor, Codex und GitHub Copilot. Es beinhaltet einen obligatorischen Qualitäts-Check (5-D-Kritik-Gate), bei dem ein Unter-Agent (Opus 4.7) die Layout-Vorschläge in fünf Dimensionen (Philosophie, Hierarchie, Ausführung, Funktionalität, Innovation) bewertet und nur bei Bestehen die finale Spezifikation ausgibt. Die Ausgabe besteht aus einer JSON-Layout-Spezifikation und optionalen Inline-Bearbeitungen der TSX-Datei der Komposition. Das Skill stellt sicher, dass Layout-Entscheidungen konsistent mit der Marke sind und die visuelle Kommunikation optimiert wird, bevor die eigentliche technische Umsetzung beginnt.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

remotion-designer

Besitzt den Look. Nicht die Worte (Storyteller), nicht die Bewegungen (Motion), nicht den Bau (composition-builder) — den Look.

Auslöser

  • remotion-orchestrator erreicht Welle 3 mit einer Entwurfskomposition.
  • Ein neuer Kompositionstyp wird erstellt (Intro, SocialAd, etc. für v1.1+).
  • Ein Rendering fällt beim Design-Review durch (nicht markenkonform, unleserlich, überfüllt).

Eingaben

  • brandSlug — zum Lesen sowohl der BrandConfig (Laufzeit, via brands[slug]) als auch {slug}.design.md (visuelle Token, via loadDesign(slug))
  • compositionId — Explainer | Intro | SocialAd | …
  • aspectRatio — 1920x1080 | 1080x1920 | 1080x1080
  • storyboard (optional) — zur Größenbestimmung von Textblöcken
  • Vorhandene Kompositionsdatei (bei QA einer bestehenden)

Methode

Wende diese Regeln in der angegebenen Reihenfolge an. Wenn ein Wert aus dem Designsystem der Marke stammt, referenziere den design.md-Token namentlich (z. B. {spacing.outer-margin-landscape}, {typography.display-xl}, {colors.primary}), anstatt einen Pixel-Literal auszugeben — remotion-composition-builder löst dies zur Build-Zeit auf.

  1. Raster — 12-spaltig. Äußerer Rand: {spacing.outer-margin-landscape} für 1920×1080, {spacing.outer-margin-portrait} für 1080×1920. Sicherheitszone: {spacing.safe-area} (Standard 5%).
  2. Typografie-Hierarchie — wähle aus der Typografie-Skala der design.md der Marke. Rollen werden den Skalenstufen zugeordnet:
    • Hook / CTA-Held → {typography.display-xl}
    • Titel des Hauptinhalts → {typography.display-md} oder {typography.headline}
    • Fließtext → {typography.body-lg} oder {typography.body-md}
    • Bildunterschrift / Kicker → {typography.caption}
    • Code / Bezeichner → {typography.mono-md} oder {typography.mono-lg} (falls definiert)
  3. Farbanwendung — Hintergründe von Helden: {colors.primary}. CTA-Flächen: {colors.accent} für Akzent-CTAs, {colors.secondary} für untergeordnete. Textfarbe: wähle Token vom Typ on-{role} (z. B. {colors.on-primary}), wenn Text auf einer bekannten Fläche liegt; andernfalls verwende colour/readableOn() für WCAG-AA-Kontrast.
  4. Komponenten-Slots — wenn das Layout eine bekannte Komponente verwendet (CTA, Karte, Mono-Chip, Signal-Chip, Preisschild, Netzwerk-Badge), gib {component: cta-primary} aus und lasse componentRecipe() das vollständige Paket zur Build-Zeit auflösen. Erfinde keine Ad-hoc-Stile, wenn ein Rezept existiert.
  5. Weißraum — jeder Textblock hat mindestens 0,5 × Schriftgröße vertikalen Freiraum darüber und darunter.
  6. Logo-Platzierung — oben links oder unten rechts, niemals zentriert. Sicherheitszone = BrandConfig.logo.safeAreaPx (bleibt in .ts, durch Motion erzwungen).

Ausgabe

Zwei Artefakte:

  1. Eine JSON-Layout-Spezifikation, geschrieben nach .research/design/{compositionId}-{brandSlug}.json, deren Werte auf Token von {slug}.design.md verweisen (z. B. { "outer-margin": "{spacing.outer-margin-landscape}", "hook-type": "{typography.display-xl}" }) — keine Pixel-Literale oder Hex-Codes inline.
  2. Inline-Bearbeitungen der TSX-Datei der Komposition (bei QA).

Nach dem Schreiben der Layout-Spezifikation führe npx --prefix Pi-Dev-Ops/remotion-studio design.md lint Synthex/packages/brand-config/src/brands/{slug}.design.md aus, um zu bestätigen, dass jeder in der Spezifikation referenzierte Token in der design.md der Marke existiert. Blockiere bei Lint-Fehlern; Warnungen sind nur Hinweise.

5-D-Kritik-Gate (obligatorisch vor dem Ausgeben der Layout-Spezifikation)

Übernommen von nexu-io/open-design (Apache-2.0). Erzeuge einen Opus 4.7-Unteragenten über das opus-adversary-Muster, um den vorgeschlagenen Layout-Entwurf in fünf orthogonalen Dimensionen zu bewerten, jede 0–10 mit zitierten Belegen. Schreibe das Urteil nach .research/design/{compositionId}-{brandSlug}.critique.json zusammen mit der Layout-Spezifikation.

Dimensionen

  1. Philosophie-Konsistenz — argumentiert das Layout für eine Richtung (z. B. Tech-Utility, Editorial-Monokel) oder sind es drei Stile in einem Mantel? Nenne konkrete Elemente.
  2. Visuelle Hierarchie — kann ein Fremder erkennen, was zuerst/zweitens/drittens gelesen wird, ohne es zu erklären? Nenne das größte Element vs. das wichtigste Element.
  3. Detailausführung — Ausrichtung, Zeilenabstand, Kerning bei großen Größen, Bildrahmung, Randfall-Abstände. Nenne konkrete Frames.
  4. Funktionalität — funktioniert es für den vorgesehenen Kanal? Vertikales 9:16-Heldenbild auf einem Handy lesbar? CTA innerhalb der Sicherheitszone? Nenne Frame-Nummern + Maße.
  5. Innovation — eine unerwartete Bewegung, die durch das Briefing verdient ist, oder 100% generisch? Eine Akzentsetzung, die nicht erforderlich war, aber die Identität festigt? Nenne die Bewegung.

Bereiche

0–4 Mangelhaft · 5–6 Funktionell · 7–8 Stark · 9–10 Außergewöhnlich. Keine Noteninflation — ein Gesamtmittelwert über 8 ist verdächtig; überprüfe.

Bestanden / nicht bestanden

  • Bestanden: jede Dimension ≥ 6, UND Mittelwert ≥ 7.
  • Nicht bestanden: irgendeine Dimension ≤ 5, ODER Mittelwert < 7. Zurück an remotion-composition-builder mit den Listen pro Dimension (Behalten/Reparieren/Schnelle Erfolge) zur Überarbeitung vor erneuter Durchführung des Gates.
  • Override: Der Gründer kann durch explizite Nachricht erzwingen ("ship it anyway"). Der Override wird mit Zeitstempel und Grund in .research/design/{compositionId}-{brandSlug}.critique.json protokolliert.

Wiederverwendetes Muster

Verwende das opus-adversary-Skill — denselben Opus 4.7-Unteragenten-Spawn, dieselbe Disziplin der Belegszitierung. Schreibe kein paralleles Kritik-Werkzeug.

Grenzen

  • Überschreibe niemals BrandConfig-Werte — schlage Änderungen über remotion-brand-codify vor.
  • Verwende niemals Animation für das Layout (kein Skalieren von Text beim Überfahren) — das ist das Terrain von remotion-motion-language.
  • Verwende nicht mehr als 3 Farben pro Szene; die dritte ist nur für Akzente reserviert.

Übergabe an

remotion-composition-builder übernimmt die Layout-Spezifikation und wendet sie an.

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

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

/remotion-video one-shot Remotion command skill and ENTRY POINT for the Remotion Skills Package. Use for video, explainer, ad, promo, reel, intro, social cut, marketing, training, or launch videos. Reads the brief, classifies intent, enforces one single Synthex ElevenLabs voice, emits a production/wave plan, and dispatches the right sub-skills in topological order. Always invoked first.

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