Communitygithub.com

remotion-orchestrator — Ponto de Entrada do Pacote de Skills Re…

Comando único (/remotion-video) para gerar vídeos de marketing com Remotion. Lê o briefing, valida informações, define um plano de produção e orquestra as skills filhas na ordem correta.

O que é remotion-orchestrator — Ponto de Entrada do Pacote de Skills Re…?

Esta skill é o ponto de entrada obrigatório para o Pacote de Skills Remotion, uma suíte de 10 skills complementares (como `remotion-designer`, `remotion-composition-builder`, `remotion-render-pipeline`) instaladas globalmente em `~/.claude/skills/remotion-*`. Ela é ativada automaticamente quando o usuário menciona "vídeo", "explainer", "promo" ou similares, e exige que o briefing seja completo e específico (com campos obrigatórios como marca, composição, canal, tópico e público). A partir do briefing, a skill gera um plano de produção (wave plan) em JSON, que organiza as tarefas em ondas paralelas ou seriais (no máximo 8 ondas para vídeos longos) e delega cada wave para as skills apropriadas. Além disso, ela gerencia o roteamento de marcas (como `dr`, `ra`, `ccw`), a criação de tickets no Linear e a geração de thumbnails via Canva MCP, seguindo regras rígidas para evitar buscas ineficientes por chaves de API. Sua principal utilidade é garantir que cada vídeo siga um fluxo padronizado e controlado, evitando desvios e garantindo consistência de marca e qualidade de produção.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

remotion-orchestrator — Ponto de Entrada do Pacote de Skills Remotion

Comando único /remotion-video

/remotion-video é o comando único para vídeos de marketing com Remotion. Ele transforma um briefing simples em um pacote de produção governado, um caminho de renderização e um relatório de evidências finais.

Regras rígidas para este comando:

  • apenas uma voz; sem elenco com múltiplas vozes e sem troca de voz por cena.
  • usar apenas as credenciais e configuração de voz existentes do Synthex ElevenLabs.
  • nenhum novo fornecedor, nenhuma nova conta, nenhuma plataforma de conectores.
  • começar com simulação (dry-run) a menos que o operador solicite explicitamente a renderização de produção.
  • escrever .harness/remotion/<jobId>/production-packet.json, script.md, preflight-report.md e render-command.sh.
  • nunca fazer commit de MP4s gerados.

O comando roteia através de remotion-script, remotion-production, remotion-direction, remotion-editing, remotion-integrations e remotion-professionalism, preservando o fluxo de trabalho existente do Pacote de Skills Remotion.

Ponto de entrada único para o Pacote de Skills Remotion — um conjunto de 10 skills irmãs (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) instaladas globalmente em ~/.claude/skills/remotion-* (link simbólico para ~/Pi-Dev-Ops/skills/remotion-*). Disponível em todos os projetos, não apenas no Pi-Dev-Ops.

Portão de validação do briefing (turno 1, obrigatório)

Adotado de nexu-io/open-design (Apache-2.0). Antes de qualquer plano de ondas ser emitido, fixe o briefing. Recuse-se a prosseguir até que todos os campos obrigatórios estejam preenchidos — briefings vagos produzem planos de ondas excessivamente longos e renderizações fora da marca.

Campos obrigatórios

CampoTipoNotas
brandBrandSlugDeve ser resolvido em src/brands/. Desconhecido → despachar remotion-brand-research primeiro.
compositionExplainer | Intro | SocialAd | NIRReport | ProductDemov1 suporta apenas Explainer; outros retornam com aviso.
channellinkedin | youtube | instagram | tiktok | trainingDefine proporção de aspecto + disciplina de duração.
aspectRatio1920x1080 | 1080x1920 | 1080x1080Padrão derivado do channel se omitido.
durationSec15 | 30 | 60 | 90 | 120Define o limite de número de ondas.
topicstringUma frase sobre o que o vídeo diz. "Vídeo de conscientização de marca" sozinho é recusado — deve nomear o ponto específico.
audiencestringHerdado de BrandConfig.audience.primary se omitido, mas o fundador deve confirmar.

Opcionais: school (substituição de estilo visual para o gerador de cores), voiceoverScript (pular storyteller se pré-escrito), referenceComposition (trabalho existente para remixar).

Condições de parada obrigatórias

  • topic lê como uma categoria ("nosso produto", "o lançamento") em vez de uma afirmação específica → bloqueio.
  • composition ≠ Explainer na v1 sem aviso explícito de fallback → bloqueio.
  • Múltiplas marcas nomeadas em um único briefing → dividir em N trabalhos paralelos (uma por marca); nunca misturar.

O portão é executado antes do plano de ondas ser calculado. Um briefing bloqueado nunca chega ao despachante.

Invocação

O usuário pode invocar o pacote:

  • Dizendo: "use o Pacote de Skills Remotion", "pacote remotion", "use remotion".
  • Nomeando qualquer skill individual (ex.: "use remotion-designer para revisar este layout").
  • Enviando um briefing que classifica como intent: "video" via app/server/brief.py.

Traduz um briefing em texto livre em um trabalho de renderização estruturado e um plano de ondas que o orquestrador Pi-Dev-Ops (app/server/orchestrator.py) despacha via fan-out P3-B.

O projeto Remotion

Todas as composições, configurações de marca, helpers de movimento/cores e o ponto de entrada de renderização estão em:

../../remotion-studio/

Ao trabalhar de qualquer outro projeto, as sub-skills mudam (cd) para esse caminho antes de ler ou editar arquivos de marca/composição. O ponto de entrada da renderização é npx tsx render/render.ts ... dentro de remotion-studio.

Gatilhos

Briefing contém qualquer um de: video, explainer, promo, ad, reel, intro, outro, cta, social cut, 60s/30s/15s, render, marketing video, training video, release video, feature video, combinado com um dos identificadores de marca dr / disaster recovery / nrpg / ra / restoreassist / carsi / ccw / carpet cleaners warehouse.

Entradas

O planejador Pi-Dev-Ops (Opus 4.7) chama esta skill com:

  • brief — solicitação original em texto livre
  • repo_url — geralmente local:Pi-Dev-Ops/remotion-studio
  • linear_team_id, linear_project_id — pré-resolvidos de config/harness/projects.json

Saída

Um plano de ondas JSON escrito em remotion-studio/.research/wave-plans/{job_id}.json com esta estrutura:

{
  "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"} ] }
  ]
}

Disciplina de número de ondas

  • ≤3 ondas para saída <30s
  • ≤5 ondas para saída ≤120s
  • ≤8 ondas para saída >120s

A superdecomposição é o modo de falha contra o qual isso protege.

Roteamento de composição (brief → composição)

Sinal do briefingcomposition
"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 suporta apenas Explainer. Outros ids de composição retornam: "{Composition} chega na v1.1 — usando Explainer com enquadramento específico do canal".

Resolução de marca

Corresponder palavras-chave → BrandSlug:

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

Se o briefing nomear várias marcas, peça ao planejador para dividir em N trabalhos paralelos (uma por marca) e emitir N planos de ondas. Nunca misturar marcas em uma única composição.

Roteamento Linear

Após a skill de renderização escrever o MP4, esta skill (ou a skill de renderização) abre um ticket Linear no projeto mapeado de config/harness/projects.json:

MarcaTime Linearprojeto
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)resolvido em tempo de execução
ccwtempo de execuçãotempo de execução

Geração de thumbnail e imagem estática (Canva primeiro — NÃO caçar credenciais)

Para um thumbnail de vídeo, pôster ou qualquer imagem estática de marketing, o caminho confiável é o Canva MCP conectado, não uma chave de API bruta de geração de imagem:

  1. generate-design (design_type: your_story para 9:16, youtube_thumbnail para 16:9) com uma consulta detalhada alinhada à marca — passe a paleta/título na consulta; o Canva renderiza texto de título de forma confiável.
  2. Baixar as visualizações candidatas e escolher a melhor; create-design-from-candidate → export-design (PNG no tamanho alvo WxH, export_quality: pro).

Regras rígidas (aprendidas da pior forma, 2026-07-01):

  • Nunca caçar credenciais para chaves de geração de imagem. Não escanear arquivos .env ou executar vercel env pull em projetos/ambientes procurando por GEMINI_API_KEY / OPENAI_API_KEY / AI_GATEWAY_API_KEY. O classificador de modo automático bloqueia isso como exploração de credenciais, e desperdiça toda a sessão.
  • Variáveis de ambiente "Sensíveis" do Vercel são somente escrita — vercel env pull retorna VAZIO. Não tentar puxar uma; obter o valor de sua fonte original ou usar Canva.
  • Se nenhuma ferramenta de imagem estiver conectada e nenhuma chave estiver acessível em UMA verificação direcionada, parar e perguntar ao fundador uma vez — oferecer Canva antecipadamente.
  • Um quadro extraído do MP4 renderizado (ffmpeg incluído em node_modules/@remotion/compositor-*/ffmpeg) é o fallback offline. Nota: no macOS, criar link simbólico dos arquivos *.dylib irmãos para o diretório atual para que o ffprobe/ffmpeg incluído funcione (SIP remove DYLD_*).

O que esta skill NÃO faz

  • Não cria composições — isso é com remotion-composition-builder.
  • Não executa npx remotion render — isso é com remotion-render-pipeline.
  • Não edita arquivos BrandConfig — isso é com remotion-brand-codify.

Ela apenas planeja + delega.

Modelo de uso por projeto

O pacote é infraestrutura compartilhada; cada projeto chamador fornece sua própria configuração de tempo de execução e chaves de API.

AspectoOnde reside
Definições de skill~/.claude/skills/remotion-* (link simbólico → Pi-Dev-Ops/skills/remotion-*) — disponível globalmente.
Projeto Node Remotion (composições, configurações de marca, ponto de entrada de renderização)../../remotion-studio/ — substrato compartilhado único.
Configurações de marcaSynthex/packages/brand-config/src/brands/{slug}.ts — uma fonte de verdade por marca, usado por todos os projetos que renderizam para essa marca. (Migrado de Pi-Dev-Ops/remotion-studio/src/brands/ conforme RA-1985 / Synthex SYN-897.)
Chaves de API (ElevenLabs, Telegram, Supabase, Linear, licença Remotion).env / .env.local do projeto chamador. Skills leem process.env no momento da renderização.
Saída MP4 renderizadaDiretório .remotion-renders/ do projeto chamador por padrão. Substituir com --out=.

Adicionando uma nova marca para seu projeto

Se seu projeto (ex.: Synthex) precisar renderizar para uma marca que ainda não está em src/brands/:

  1. Executar remotion-brand-research nas fontes públicas da marca.
  2. Executar remotion-brand-codify para produzir Synthex/packages/brand-config/src/brands/{slug}.ts.
  3. Estender a união BrandSlug em Synthex/packages/brand-config/src/types.ts.
  4. Registrar em Synthex/packages/brand-config/src/brands/index.ts.
  5. Executar npm run typecheck de Synthex/packages/brand-config/ (depois npm run build para regenerar dist/).

Marcas atualmente registradas: 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.

Habilidades Relacionadas