Communitygithub.com

CleanExpo/Pi-Dev-Ops

Spécialiste du design visuel pour les compositions Remotion. Définit la grille de mise en page, la hiérarchie typographique, les espaces blancs, le cadrage des scènes et le rythme visuel pour une composition + marque données. Déclenché après 'remotion-composition-builder' pour la QA, ou en amont lors de la création d'un nouveau type de composition. Produit un cahier des charges de mise en page consommé par 'remotion-composition-builder'.

Qu'est-ce que Pi-Dev-Ops ?

Ce skill est un spécialiste du design visuel pour les compositions Remotion. Il intervient après le constructeur de composition ou en amont lors de la création d'un nouveau type de composition. Il définit la grille de mise en page (12 colonnes), la hiérarchie typographique (en référençant les jetons du système de design de la marque), les espaces blancs, le cadrage des scènes et le rythme visuel. Il produit un fichier JSON de cahier des charges de mise en page qui référence les jetons de design par nom (par exemple `{spacing.outer-margin-landscape}`, `{typography.display-xl}`) et effectue des modifications en ligne du fichier TSX de la composition. Il inclut une porte de critique en 5 dimensions (cohérence philosophique, hiérarchie visuelle, exécution des détails, fonctionnalité, innovation) avec notation et conditions de passage. Il utilise le pattern 'opus-adversary' pour évaluer la mise en page et bloque en cas d'échec. Il prend en charge les marques et les compositions existantes via le slug de la marque, l'ID de composition, le rapport d'aspect et le storyboard facultatif. Il s'appuie sur les règles de conception de la marque et ne remplace jamais les valeurs de configuration de la marque. Il travaille sur les plateformes Remotion et utilise des outils comme `npx` pour lint les jetons de design.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

remotion-designer

Possède le look. Pas les mots (storyteller), pas les mouvements (motion), pas la construction (composition-builder) — le look.

Déclencheurs

  • remotion-orchestrator atteint la vague 3 avec une composition en projet.
  • Un nouveau type de composition est en cours de création (Intro, SocialAd, etc. pour v1.1+).
  • Un rendu échoue à la revue de design (hors marque, illisible, serré).

Entrées

  • brandSlug — pour lire à la fois BrandConfig (à l'exécution, via brands[slug]) et {slug}.design.md (jetons visuels, via loadDesign(slug))
  • compositionId — Explainer | Intro | SocialAd | …
  • aspectRatio — 1920x1080 | 1080x1920 | 1080x1080
  • storyboard (facultatif) — pour dimensionner les blocs de texte
  • Fichier de composition existant (si QA d'une composition existante)

Méthode

Appliquer ces règles dans l'ordre. Lorsqu'une valeur provient du système de design de la marque, référencer le jeton design.md par son nom (par ex. {spacing.outer-margin-landscape}, {typography.display-xl}, {colors.primary}) plutôt que d'émettre une valeur littérale en pixels — remotion-composition-builder la résoudra au moment de la construction.

  1. Grille — 12 colonnes. Marge extérieure : {spacing.outer-margin-landscape} pour 1920×1080, {spacing.outer-margin-portrait} pour 1080×1920. Zone de sécurité : {spacing.safe-area} (par défaut 5%).
  2. Hiérarchie typographique — choisir dans l'échelle typographique du design.md de la marque. Les rôles correspondent aux échelons de l'échelle :
    • Accroche / CTA héroïque → {typography.display-xl}
    • Titre de corps → {typography.display-md} ou {typography.headline}
    • Corps → {typography.body-lg} ou {typography.body-md}
    • Légende / accroche → {typography.caption}
    • Code / identifiant → {typography.mono-md} ou {typography.mono-lg} (si défini)
  3. Application des couleurs — arrière-plans héroïques : {colors.primary}. Remplissages CTA : {colors.accent} pour les CTA d'accent, {colors.secondary} pour les subordonnés. Texte du corps : choisir le jeton on-{role} (par ex. {colors.on-primary}) lorsque le texte se trouve sur une surface connue ; sinon, utiliser colour/readableOn() pour le contraste WCAG-AA.
  4. Emplacements de composants — lorsque la mise en page utilise un composant reconnu (CTA, carte, puce mono, puce signal, étiquette de prix, badge réseau), émettre {component: cta-primary} et laisser componentRecipe() résoudre l'ensemble complet au moment de la construction. Ne pas inventer de styles ad hoc lorsqu'une recette existe.
  5. Espace blanc — chaque bloc de texte dispose d'au moins 0,5 × hauteur de police d'espace de respiration vertical au-dessus et en dessous.
  6. Placement du logo — en haut à gauche ou en bas à droite, jamais centré. Zone de sécurité = BrandConfig.logo.safeAreaPx (reste dans .ts, appliqué par motion).

Sortie

Deux artefacts :

  1. Un fichier JSON de cahier des charges de mise en page écrit dans .research/design/{compositionId}-{brandSlug}.json dont les valeurs référencent les jetons du {slug}.design.md par nom (par ex. { "outer-margin": "{spacing.outer-margin-landscape}", "hook-type": "{typography.display-xl}" }) — aucune valeur littérale en pixels ou code hexadécimal en ligne.
  2. Modifications en ligne du TSX de la composition (si QA).

Après avoir écrit le cahier des charges de mise en page, exécuter npx --prefix Pi-Dev-Ops/remotion-studio design.md lint Synthex/packages/brand-config/src/brands/{slug}.design.md pour confirmer que chaque jeton référencé dans la mise en page existe dans le design.md de la marque. Bloquer en cas d'erreurs de lint ; les avertissements sont indicatifs.

Porte de critique en 5 dimensions (obligatoire avant d'émettre le cahier des charges de mise en page)

Adopté de nexu-io/open-design (Apache-2.0). Lancer un sous-agent Opus 4.7 via le pattern opus-adversary pour évaluer la mise en page proposée selon cinq dimensions orthogonales, chacune de 0 à 10 avec des preuves citées. Écrire le verdict dans .research/design/{compositionId}-{brandSlug}.critique.json en même temps que le cahier des charges de mise en page.

Dimensions

  1. Cohérence philosophique — la mise en page plaide-t-elle pour une direction (par ex. utilitaire technique, monocle éditorial) ou trois styles en un seul ? Citer des éléments spécifiques.
  2. Hiérarchie visuelle — un étranger peut-il déterminer quoi lire en premier/deuxième/troisième sans qu'on le lui dise ? Citer le plus grand élément par rapport à l'élément le plus important.
  3. Exécution des détails — alignement, interlignage, crénage aux grandes tailles, cadrage des images, espacement des cas limites. Citer des scènes spécifiques.
  4. Fonctionnalité — la mise en page fonctionne-t-elle pour le canal prévu ? Héroïque vertical 9:16 lisible sur un téléphone ? CTA à l'intérieur de la zone de sécurité ? Citer les numéros de scène + les mesures.
  5. Innovation — un geste inattendu qui est mérité par le brief, ou 100% générique ? Un accent qui n'était pas requis mais qui verrouille l'identité ? Citer le geste.

Niveaux

0–4 Cassé · 5–6 Fonctionnel · 7–8 Fort · 9–10 Exceptionnel. Ne pas gonfler les notes — une moyenne globale supérieure à 8 est suspecte ; revérifier.

Réussite / échec

  • Réussite : chaque dimension ≥ 6, ET moyenne ≥ 7.
  • Échec : une dimension ≤ 5, OU moyenne < 7. Retourner à remotion-composition-builder avec les listes Conserver/Corriger/Victoire rapide par dimension pour révision avant de relancer la porte.
  • Dérogation : le fondateur peut forcer la réussite via un message explicite (« lance-le quand même »). La dérogation est consignée dans .research/design/{compositionId}-{brandSlug}.critique.json avec horodatage et motif.

Pattern réutilisé

Utiliser le skill opus-adversary — même lancement de sous-agent Opus 4.7, même discipline de citation des preuves. Ne pas écrire un harnais de critique parallèle.

Limites

  • Ne jamais remplacer les valeurs de BrandConfig — proposer des modifications via remotion-brand-codify.
  • Ne jamais utiliser d'animation pour la mise en page (pas de mise à l'échelle du texte au survol) — c'est le domaine de remotion-motion-language.
  • Ne jamais empiler plus de 3 couleurs par scène ; la troisième est réservée à l'accent uniquement.

Passage de relais à

remotion-composition-builder consomme le cahier des charges de mise en page et l'applique.

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.

Skills associés