Communitygithub.com

CleanExpo/Pi-Dev-Ops

Commande /remotion-video en un coup pour la création de vidéos Remotion. Point d'entrée unique du package Remotion Skills. Idéal pour vidéos explicatives, publicités, promos, reels, intros, extraits sociaux, marketing, formation ou lancements. Lit le brief, classifie l'intention, impose une seule voix Synthex ElevenLabs, émet un plan de production/vague et déclenche les sous-compétences dans l'ordre topologique.

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

Cette compétence est le point d'entrée unique du **Remotion Skills Package**, un ensemble de 10 compétences sœurs conçues pour la création de vidéos marketing professionnelles avec Remotion. Elle transforme un brief brut en un plan de production structuré, un chemin de rendu unique et un rapport final. Son rôle principal est de planifier et déléguer : elle analyse l'intention, extrait les champs obligatoires via un portail de découverte, classifie le type de composition (Explainer, Intro, SocialAd, etc.), résout la marque cible (dr, nrpg, ra, carsi, ccw, synthex, unite) et génère un plan par vagues ordonnancées topologiquement vers les sous-compétences spécialisées (recherche de marque, design, langage de mouvement, pipeline de rendu, etc.). Règles strictes : voix unique uniquement (pas de changement de voix par scène), utilisation exclusive des identifiants et voix Synthex ElevenLabs existants, pas de nouveaux fournisseurs ou comptes. Commence toujours par un test à sec (dry-run) sauf demande explicite de rendu production. Écrit les fichiers de planification dans `.harness/remotion/<jobId>/` et n'engage jamais le rendu lui-même — il délègue au pipeline de rendu dédié. La compétence s'appuie sur l'infrastructure partagée : les définitions des compétences sont installées globalement dans `~/.claude/skills/remotion-*`, le projet Remotion (compositions, configurations de marque, entrée de rendu) réside dans `../../remotion-studio/`, et les clés API sont fournies par le projet appelant. Pour les vignettes et images fixes, elle privilégie Canva via MCP plutôt que la chasse aux clés d'API. Idéale pour les développeurs et créateurs souhaitant produire rapidement et de manière fiable des vidéos marketing cohérentes avec la marque, sans se soucier des détails opérationnels de Remotion ou des intégrations complexes. Cette compétence est utilisable dans n'importe quel projet (pas seulement Pi-Dev-Ops) tant que les dépendances d'exécution sont disponibles.

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

Demander à votre IA préférée

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

Documentation

remotion-orchestrator — Point d'entrée du Remotion Skills Package

Commande unique /remotion-video

/remotion-video est la commande unique pour les vidéos marketing Remotion. Elle transforme un brief brut en un ensemble de production régulé, un seul chemin de rendu et un rapport final.

Règles strictes pour cette commande :

  • une seule voix uniquement ; pas de distribution multi-voix ni de changement de voix par scène.
  • utiliser uniquement les identifiants et la configuration vocale Synthex ElevenLabs existants.
  • pas de nouveaux fournisseurs, pas de nouveaux comptes, pas de plateformes de connecteurs.
  • commencer par un test à sec (dry-run) sauf si l'opérateur demande explicitement un rendu de production.
  • écrire .harness/remotion/<jobId>/production-packet.json, script.md, preflight-report.md et render-command.sh.
  • ne jamais commiter les MP4 générés.

La commande transite par remotion-script, remotion-production, remotion-direction, remotion-editing, remotion-integrations et remotion-professionalism, tout en préservant le flux de travail existant du Remotion Skills Package ci-dessous.

Point d'entrée unique du Remotion Skills Package — un ensemble de 10 compétences sœurs (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) installées globalement dans ~/.claude/skills/remotion-* (liées symboliquement vers ~/Pi-Dev-Ops/skills/remotion-*). Disponible dans tous les projets, pas seulement Pi-Dev-Ops.

Portail de découverte du brief (tour 1, obligatoire)

Adopté de nexu-io/open-design (Apache-2.0). Avant qu'un plan par vagues ne soit émis, verrouillez le brief. Refusez de continuer tant que tous les champs obligatoires ne sont pas remplis — les briefs vagues produisent des plans par vagues trop longs et des rendus hors marque.

Champs obligatoires

ChampTypeNotes
brandBrandSlugDoit être résolu dans src/brands/. Inconnu → déclencher remotion-brand-research d'abord.
compositionExplainer | Intro | SocialAd | NIRReport | ProductDemov1 prend en charge Explainer uniquement ; les autres se replient avec une note.
channellinkedin | youtube | instagram | tiktok | trainingDéfinit le ratio d'aspect et la discipline de durée.
aspectRatio1920x1080 | 1080x1920 | 1080x1080Par défaut selon channel si omis.
durationSec15 | 30 | 60 | 90 | 120Définit le nombre maximal de vagues.
topicchaîneUne phrase sur ce que dit la vidéo. "Vidéo de notoriété de marque" seul est refusé — le point spécifique doit être nommé.
audiencechaîneHérité de BrandConfig.audience.primary si omis, mais le fondateur doit confirmer.

Optionnel : school (remplacement de l'école visuelle pour le générateur de couleurs), voiceoverScript (sauter le storyteller si pré-écrit), referenceComposition (tâche existante à remixer).

Conditions d'arrêt strict

  • topic se lit comme une catégorie ("notre produit", "le lancement") plutôt qu'une affirmation spécifique → bloquer.
  • composition ≠ Explainer en v1 sans accusé de réception explicite de repli → bloquer.
  • Plusieurs marques nommées dans un même brief → diviser en N tâches parallèles (une par marque) ; ne jamais mélanger.

Le portail s'exécute avant que le plan par vagues ne soit calculé. Un brief bloqué n'atteint jamais le répartiteur.

Invocation

L'utilisateur peut invoquer le package en :

  • disant n'importe lequel de : "utiliser le Remotion Skills Package", "package remotion", "utiliser remotion".
  • nommant une compétence individuelle (ex : "utiliser remotion-designer pour QA cette mise en page").
  • soumettant un brief qui se classifie comme intent: "video" via app/server/brief.py.

Traduit un brief en texte libre en une tâche de rendu structurée et un plan par vagues que l'orchestrateur Pi-Dev-Ops (app/server/orchestrator.py) répartit via P3-B fan-out.

Le projet Remotion

Toutes les compositions, configurations de marque, aides au mouvement/couleur et le point d'entrée de rendu se trouvent dans :

../../remotion-studio/

Lorsque vous travaillez depuis un autre projet, les sous-compétences exécutent cd vers ce chemin avant de lire ou modifier les fichiers de marque / composition. Le point d'entrée de rendu est npx tsx render/render.ts ... depuis remotion-studio.

Déclencheurs

Le brief contient l'un des mots suivants : video, explainer, promo, ad, reel, intro, outro, cta, social cut, 60s/30s/15s, render, marketing video, training video, release video, feature video, associé à l'un des identifiants de marque dr / disaster recovery / nrpg / ra / restoreassist / carsi / ccw / carpet cleaners warehouse.

Entrées

Le planificateur Pi-Dev-Ops (Opus 4.7) appelle cette compétence avec :

  • brief — la requête originale en texte libre
  • repo_url — généralement local:Pi-Dev-Ops/remotion-studio
  • linear_team_id, linear_project_id — pré-résolus depuis config/harness/projects.json

Sortie

Un plan par vagues JSON écrit dans remotion-studio/.research/wave-plans/{job_id}.json avec cette structure :

{
  "jobId": "ra-nir-explainer-2026-04-28T15-30-00",
  "brand": "ra",
  "composition": "Explainer",
  "channel": "linkedin",
  "durationSec": 60,
  "topic": "Standardisation de la phase 1 NIR de RestoreAssist",
  "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 manquant ou obsolète"}, {"skill":"remotion-marketing-strategist"} ] },
    { "id": 2, "parallel": [ {"skill":"remotion-screen-storyteller"}, {"skill":"remotion-colour-family","if":"palette incomplète"}, {"skill":"remotion-motion-language","if":"mouvement manquant"} ] },
    { "id": 3, "parallel": [ {"skill":"remotion-brand-codify","if":"nouveaux artefacts de marque"}, {"skill":"remotion-designer"} ] },
    { "id": 4, "serial":   [ {"skill":"remotion-composition-builder"}, {"skill":"remotion-render-pipeline"} ] }
  ]
}

Discipline du nombre de vagues

  • ≤3 vagues pour une sortie <30s
  • ≤5 vagues pour une sortie ≤120s
  • ≤8 vagues pour une sortie >120s

La sur-décomposition est le mode de défaillance contre lequel cela protège.

Routage de composition (brief → composition)

Signal du briefcomposition
"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 prend en charge Explainer uniquement. Les autres identifiants de composition renvoient : "{Composition} sera disponible en v1.1 — repli sur Explainer avec un cadrage spécifique au canal".

Résolution de marque

Faire correspondre les mots-clés → BrandSlug :

  • disaster recovery, dr → dr
  • nrpg → nrpg
  • restoreassist, ra, nir → ra
  • carsi → carsi
  • ccw, carpet cleaners warehouse → ccw

Si le brief nomme plusieurs marques, demandez au planificateur de diviser en N tâches parallèles (une par marque) et d'émettre N plans par vagues. Ne jamais mélanger les marques dans une seule composition.

Routage Linear

Après que la compétence de rendu ait écrit le MP4, cette compétence (ou la compétence de rendu) ouvre un ticket Linear dans le projet mappé depuis config/harness/projects.json :

MarqueÉquipe Linearprojet
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)résolu à l'exécution
ccwexécutionexécution

Génération de vignettes et d'images fixes (Canva d'abord — NE PAS chercher des identifiants)

Pour une vignette vidéo, une affiche ou toute image marketing statique, le chemin fiable est le Canva MCP connecté, pas une clé d'API de génération d'image brute :

  1. generate-design (design_type: your_story pour 9:16, youtube_thumbnail pour 16:9) avec une requête détaillée alignée sur la marque — passer la palette/le titre dans la requête ; Canva rend le texte du titre de manière fiable.
  2. Télécharger les aperçus candidats et choisir le meilleur ; create-design-from-candidate → export-design (PNG aux dimensions cibles, export_quality: pro).

Règles strictes (apprises à la dure, 2026-07-01) :

  • Ne jamais chercher des identifiants pour les clés de génération d'images. Ne pas analyser les fichiers .env ni exécuter vercel env pull dans les projets/environnements à la recherche de GEMINI_API_KEY / OPENAI_API_KEY / AI_GATEWAY_API_KEY. Le classifieur en mode automatique le bloque comme exploration d'identifiants, et cela gaspille toute la session.
  • Les variables d'environnement Vercel "Sensibles" sont en écriture seule — vercel env pull les renvoie VIDES. Ne pas essayer d'en récupérer une ; obtenir la valeur de sa source d'origine ou utiliser Canva.
  • Si aucun outil d'image n'est connecté et qu'aucune clé n'est accessible en UNE vérification dirigée, arrêtez-vous et demandez une fois au fondateur — proposez Canva dès le départ.
  • Une capture d'écran du MP4 rendu (ffmpeg fourni dans node_modules/@remotion/compositor-*/ffmpeg) est le repli hors ligne. Note : sur macOS, créez un lien symbolique des fichiers *.dylib frères dans le répertoire de travail pour que ffprobe/ffmpeg fournis se résolvent (SIP supprime DYLD_*).

Ce que cette compétence NE fait PAS

  • N'écrit pas de compositions — c'est remotion-composition-builder.
  • N'exécute pas npx remotion render — c'est remotion-render-pipeline.
  • Ne modifie pas les fichiers BrandConfig — c'est remotion-brand-codify.

Elle ne fait que planifier + déléguer.

Modèle d'utilisation par projet

Le package est une infrastructure partagée ; chaque projet appelant fournit sa propre configuration d'exécution et ses propres clés API.

ÉlémentEmplacement
Définitions des compétences~/.claude/skills/remotion-* (lié symboliquement → Pi-Dev-Ops/skills/remotion-*) — disponibles globalement.
Projet Node Remotion (compositions, configs de marque, point d'entrée de rendu)../../remotion-studio/ — substrat unique partagé.
Configurations de marqueSynthex/packages/brand-config/src/brands/{slug}.ts — une source de vérité par marque, utilisée par chaque projet qui rend pour cette marque. (Migré depuis Pi-Dev-Ops/remotion-studio/src/brands/ selon RA-1985 / Synthex SYN-897.)
Clés API (ElevenLabs, Telegram, Supabase, Linear, licence Remotion)Le fichier .env / .env.local du projet appelant. Les compétences lisent process.env au moment du rendu.
Sortie MP4 rendueLe répertoire .remotion-renders/ du projet appelant par défaut. Remplacez avec --out=.

Ajouter une nouvelle marque pour votre projet

Si votre projet (ex : Synthex) a besoin de rendre pour une marque qui n'est pas encore dans src/brands/ :

  1. Exécutez remotion-brand-research sur les sources publiques de la marque.
  2. Exécutez remotion-brand-codify pour produire Synthex/packages/brand-config/src/brands/{slug}.ts.
  3. Étendez l'union BrandSlug dans Synthex/packages/brand-config/src/types.ts.
  4. Enregistrez dans Synthex/packages/brand-config/src/brands/index.ts.
  5. Exécutez npm run typecheck depuis Synthex/packages/brand-config/ (puis npm run build pour régénérer dist/).

Marques actuellement enregistrées : 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.

Skills associés