Communitygithub.com

Remotion Compose

Transforma um briefing em linguagem natural em uma composição Remotion completa, pronta para pré-visualização – com React/TypeScript, animações baseadas em quadros e registro automático no projeto.

O que é Remotion Compose?

O Remotion Compose é um skill para agentes de IA que converte descrições como 'crie um vídeo de demonstração de 20 segundos' em uma composição Remotion totalmente funcional. Ele extrai automaticamente duração, cenas, cores da marca, proporção e texto real; planeja o orçamento de quadros; e escreve código React/TypeScript usando APIs como `useCurrentFrame`, `interpolate`, `spring`, `AbsoluteFill` e `Sequence`. O resultado é registrado em `Root.tsx` e pode ser imediatamente manipulado no Remotion Studio, sem necessidade de renderização ou scaffolding manual. Ideal para demos de produtos, walkthroughs de funcionalidades, anúncios e vídeos de marketing, este skill garante animações previsíveis e determinísticas, evitando práticas como CSS transitions ou `Math.random()` que quebram a renderização paralela.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/SkillMedev/skills/tree/HEAD/skills/remotion-compose

Perguntar na sua IA favorita

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

Documentação

O que Remotion Compose faz?

Você transforma um briefing em linguagem natural em uma composição Remotion completa e pronta para pré-visualização – React/TypeScript real com animação baseada em quadros. A saída é um arquivo .tsx em src/compositions/, registrado em src/Root.tsx, que o usuário pode imediatamente manipular no Studio ou passar para remotion-render.

Ative ao receber qualquer solicitação para criar, gerar, animar ou "escrever o código do vídeo para" uma demo de produto, walkthrough, destaque de funcionalidade ou animação de marketing – incluindo "construa um vídeo de 20 segundos mostrando X".

Passo 1 – Extrair o briefing

Não comece a codificar até ter estas informações. Pergunte em um bloco compacto; preencha lacunas óbvias com padrões sensatos em vez de travar:

  1. Duração em segundos e fps (padrão 30 – o padrão para vídeos de produto e marketing, e metade do custo de renderização de 60. Use 60fps apenas ao animar movimentos finos de cursor ou UI de rolagem onde 30 trava visivelmente).
  2. Cenas – o que acontece, em ordem. Peça uma lista de momentos: "logotipo, três funcionalidades e um CTA" é melhor que "uma demonstração do meu app".
  3. Marca – cores hexadecimais primária/de destaque/fundo, e a fonte (um nome de família do @remotion/google-fonts).
  4. Proporção / plataforma – 16:9 paisagem (1920×1080), 9:16 retrato (1080×1920) para redes sociais, ou 1:1 quadrado (1080×1080).
  5. Texto – os títulos reais, nomes de funcionalidades, texto do CTA. Nunca invente alegações sobre o produto; pergunte pelas palavras reais.

Converta segundos para quadros em todo lugar: durationInFrames = seconds * fps. Durações típicas: 15-60s para uma demo social/produto, 6-15s para um anúncio.

Passo 2 – Criar um plano de cenas

Uma <Composition> por vídeo, um componente por cena, costurados na linha do tempo com <Sequence>. Defina o orçamento de quadros antes de codificar:

Total: 20s @ 30fps = 600 quadros
  Introdução (logotipo)   quadros   0-90    (Sequence from=0   durationInFrames=90)
  Funcionalidade 1        quadros  90-240   (Sequence from=90  durationInFrames=150)
  Funcionalidade 2        quadros 240-390   (Sequence from=240 durationInFrames=150)
  Funcionalidade 3        quadros 390-540   (Sequence from=390 durationInFrames=150)
  CTA final               quadros 540-600   (Sequence from=540 durationInFrames=60)

Limiares de ritmo ao planejar:

  • Dê a qualquer momento que contenha texto pelo menos 2 segundos (60 quadros a 30fps) – animação de entrada mais pausa. Um título precisa de aproximadamente 150-200ms de pausa por palavra para ser legível; um título de 6 palavras quer ~1s de pausa após aparecer.
  • Animações de entrada: 10-20 quadros. Cross-fades e saídas: 12-15 quadros. Mais longo parece lento; mais curto parece falha.
  • Nenhuma cena com menos de ~45 quadros, a menos que seja um corte flash intencional.

<Sequence from={F}> desloca o relógio local do filho para que dentro desse componente useCurrentFrame() comece em 0. Anime cada cena como se começasse no quadro 0.

Passo 3 – Referência da API principal

  • useCurrentFrame() – o quadro atual (o relógio). Tudo anima como função disto.
  • useVideoConfig() – { fps, width, height, durationInFrames }.
  • interpolate(frame, [inFrames], [outValues], opts) – mapeamento linear. Sempre passe { extrapolateLeft: "clamp", extrapolateRight: "clamp" } para entrada/saída, para que os valores não ultrapassem seu intervalo.
  • spring({ frame, fps, config }) – 0→1 baseado em física (levemente ultrapassa). Use para qualquer coisa que deva parecer viva (pops, slides, escalas).
  • AbsoluteFill – uma div de quadro completo posicionada absolutamente; a camada base de cada cena.
  • Sequence – desloca no tempo e limita temporalmente os filhos (o agendador de cenas).
  • Series / Series.Sequence – cenas consecutivas sem calcular deslocamentos from manualmente.
  • Img, staticFile – veja o Passo 6.

Passo 4 – spring() vs interpolate()

Use spring() quando…Use interpolate() quando…
O movimento deve parecer físico – pops, saltos, escalas, deslizamentosVocê precisa de controle linear preciso entre quadros exatos
Você quer um assentamento/ultrapassagem naturalFades (opacidade 0→1), mudanças de cor, barras de progresso, qualquer coisa sincronizada ao quadro
Entradas de cartões, logotipos, badgesCross-fades e saídas onde ultrapassagem pareceria errada

Padrão – use uma mola para transformação, interpolate para opacidade:

const { fps } = useVideoConfig();
const frame = useCurrentFrame();
const pop = spring({ frame, fps, config: { damping: 200 } });   // 0 → 1, vivo
const opacity = interpolate(frame, [0, 15], [0, 1], { extrapolateRight: "clamp" });
const scale = interpolate(pop, [0, 1], [0.8, 1]);

damping: 200 é a configuração padrão de trabalho – um assentamento rápido com ultrapassagem quase invisível. Damping menor (~10-20) salta visivelmente; use apenas quando o salto for o objetivo.

Passo 5 – Estrutura padrão de demo de produto

Codifique esta forma a menos que o briefing diga o contrário: introdução do logotipo/marca → N destaques de funcionalidades → CTA final. Torne-o orientado a dados (Passo 6) para que variações sejam gratuitas.

// src/compositions/ProductDemo.tsx
import {
  AbsoluteFill, Sequence, useCurrentFrame, useVideoConfig,
  interpolate, spring,
} from "remotion";
import { loadFont } from "@remotion/google-fonts/Inter";

const { fontFamily } = loadFont();

export type Feature = { title: string; body: string };
export type ProductDemoProps = {
  brand: string;
  colors: { bg: string; fg: string; accent: string };
  logoText: string;
  features: Feature[];
  cta: string;
};

const Intro: React.FC<{ text: string; colors: ProductDemoProps["colors"] }> = ({ text, colors }) => {
  const frame = useCurrentFrame();
  const { fps } = useVideoConfig();
  const s = spring({ frame, fps, config: { damping: 200 } });
  const scale = interpolate(s, [0, 1], [0.7, 1]);
  const opacity = interpolate(frame, [0, 12], [0, 1], { extrapolateRight: "clamp" });
  return (
    <AbsoluteFill style={{ backgroundColor: colors.bg, justifyContent: "center", alignItems: "center" }}>
      <h1 style={{ fontFamily, fontSize: 120, color: colors.fg, transform: `scale(${scale})`, opacity }}>
        {text}
      </h1>
    </AbsoluteFill>
  );
};

const FeatureCallout: React.FC<{ feature: Feature; colors: ProductDemoProps["colors"] }> = ({ feature, colors }) => {
  const frame = useCurrentFrame();
  const { fps } = useVideoConfig();
  const slide = spring({ frame, fps, config: { damping: 200 } });
  const x = interpolate(slide, [0, 1], [-60, 0]);
  const opacity = interpolate(frame, [0, 15], [0, 1], { extrapolateRight: "clamp" });
  return (
    <AbsoluteFill style={{ backgroundColor: colors.bg, justifyContent: "center", paddingLeft: 160 }}>
      <div style={{ transform: `translateX(${x}px)`, opacity }}>
        <div style={{ fontFamily, fontSize: 32, color: colors.accent, fontWeight: 700, letterSpacing: 2 }}>
          {feature.title.toUpperCase()}
        </div>
        <div style={{ fontFamily, fontSize: 64, color: colors.fg, maxWidth: 1100, marginTop: 16 }}>
          {feature.body}
        </div>
      </div>
    </AbsoluteFill>
  );
};

const Outro: React.FC<{ cta: string; colors: ProductDemoProps["colors"] }> = ({ cta, colors }) => {
  const frame = useCurrentFrame();
  const opacity = interpolate(frame, [0, 18], [0, 1], { extrapolateRight: "clamp" });
  return (
    <AbsoluteFill style={{ backgroundColor: colors.accent, justifyContent: "center", alignItems: "center" }}>
      <h2 style={{ fontFamily, fontSize: 84, color: colors.bg, opacity }}>{cta}</h2>
    </AbsoluteFill>
  );
};

export const ProductDemo: React.FC<ProductDemoProps> = ({ colors, logoText, features, cta }) => {
  const intro = 90;
  const per = 150;
  const outro = 60;
  return (
    <AbsoluteFill>
      <Sequence durationInFrames={intro}>
        <Intro text={logoText} colors={colors} />
      </Sequence>
      {features.map((f, i) => (
        <Sequence key={i} from={intro + i * per} durationInFrames={per}>
          <FeatureCallout feature={f} colors={colors} />
        </Sequence>
      ))}
      <Sequence from={intro + features.length * per} durationInFrames={outro}>
        <Outro cta={cta} colors={colors} />
      </Sequence>
    </AbsoluteFill>
  );
};

Registre em src/Root.tsx, calculando durationInFrames a partir dos mesmos números e fornecendo defaultProps:

<Composition
  id="ProductDemo"
  component={ProductDemo}
  durationInFrames={90 + 3 * 150 + 60}
  fps={30}
  width={1920}
  height={1080}
  defaultProps={{
    brand: "Acme",
    colors: { bg: "#0B0B0F", fg: "#FFFFFF", accent: "#6C5CE7" },
    logoText: "Acme",
    features: [
      { title: "Rápido", body: "Envie em segundos, não em sprints." },
      { title: "Simples", body: "Um prompt, um vídeo." },
      { title: "Seu", body: "Sua marca, seu texto." },
    ],
    cta: "Comece grátis →",
  }}
/>

Para vertical/redes sociais, defina width={1080} height={1920}; para quadrado, 1080×1080. Mantenha os componentes idênticos – apenas a tela muda.

Passo 6 – Props orientadas a dados e ativos estáticos

A composição acima é totalmente orientada a dados: cada palavra e cor é uma prop. Esse é o objetivo – variações (novo texto, nova paleta, texto localizado) não precisam de nova solicitação; basta passar props diferentes (remotion-render faz isso a partir de um arquivo JSON para lotes).

Ativos estáticos (logotipos, capturas de tela, áudio) ficam em public/assets/ e são referenciados com staticFile() – nunca como import ou caminho bruto:

import { Img, staticFile } from "remotion";
<Img src={staticFile("assets/logo.png")} />

Passo 7 – Saída

Salve o arquivo final em src/compositions/<VideoName>.tsx, registre em src/Root.tsx e diga ao usuário para pré-visualizar com npx remotion studio (http://localhost:3000). Em seguida, passe adiante: "Manipule no Studio. Diga-me o que mudar – muito rápido, cor errada, texto diferente – e eu edito e re-renderizo (remotion-render)."

NÃO FAÇA

  • NÃO anime com transições/animações CSS ou setTimeout/setInterval. O Remotion renderiza quadros independentemente e em paralelo; qualquer coisa não derivada de useCurrentFrame() fica invisível ou inconsistente na renderização final, mesmo que pareça correta na prévia do navegador.
  • NÃO use Math.random() para efeitos dispersos/de partículas – cada worker de renderização obtém valores diferentes e os quadros param de corresponder. Use random(seed) do Remotion para pseudo-aleatoriedade determinística.
  • NÃO busque dados ou espere trabalho assíncrono sem delayRender() / continueRender() – o renderizador captura o quadro antes dos dados chegarem.
  • NÃO codifique fps, largura ou altura dentro dos componentes de cena – leia-os de useVideoConfig() para que alternar entre 30↔60fps ou paisagem↔retrato não quebre cada temporização e layout.
  • NÃO omita extrapolateLeft/Right: "clamp" em interpolações de entrada/saída – a opacidade ultrapassa 1 e elementos flutuam para fora da tela após o fim do intervalo.
  • NÃO invente títulos, alegações de funcionalidades ou CTAs – use o texto real do usuário e peça por ele se estiver faltando.

Padrão de qualidade

  • Todo valor animado é uma função pura de useCurrentFrame() (mais props) – manipular para trás no Studio parece idêntico a avançar.
  • O orçamento de quadros no plano soma exatamente durationInFrames em Root.tsx, e nenhum momento de texto segura por menos que seu mínimo legível.
  • Todo texto e cores chegam via props tipadas com defaultProps fornecidas – sem literais enterrados em componentes de cena.
  • Ativos carregam via staticFile(); o arquivo registra limpo e pré-visualiza no Studio sem erros no console.

Individual skills in this repo

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

SkillMedev/skills

Designs REST API surfaces - resource naming, HTTP method and status-code semantics, error shapes, pagination, and filtering - and delivers an endpoint spec a consumer can build against without asking questions. Use when someone asks "how should I name this endpoint", "what status code should this return", "should this be PUT or PATCH", "how do I paginate this list", or is reviewing an API before it ships to external consumers. Do NOT use for planning breaking-change rollouts and deprecation windows - use api-versioning-strategist instead; for GraphQL type and resolver design - use graphql-schema instead; for generating client SDKs from an existing spec - use api-client-generator instead; for designing inbound webhook endpoints - use webhook-receiver-hardener instead.

SkillMedev/skills

Produce an accurate, properly timed caption track (SRT or WebVTT) from a video's audio - transcribing or aligning to the voiceover script, timing cues to speech, and enforcing line-length and reading-speed rules so captions are readable and in sync. Use when someone says "generate captions", "make subtitles from the audio", "transcribe and caption this", "export an SRT or VTT", "the captions are out of sync", or "the subtitles flash by too fast to read". Do NOT use to burn-in, style, reframe, or position an existing caption track for a platform (9:16, brand styling, safe areas) - that is social-video-formatter; do NOT use to animate text word-by-word as a motion graphic - that is kinetic-typography; do NOT use to write the spoken script in the first place - that is narration-script.

SkillMedev/skills

Turns data and charts into a decision-driving narrative structured as headline finding, trend, implication, and recommended action - with finding-led chart titles, context for every number, annotation guidance, and honest flags on any conclusion the data cannot support. Use when someone says "turn these numbers into a story", "what's the takeaway from this data", "help me present these results to leadership", or has charts but no narrative. Do NOT use for compressing a long document into a one-pager - use executive-summary instead - or for running the analysis that produces the findings - use eda-playbook instead.

SkillMedev/skills

Use when a task needs live or historical money data - "convert USD to EUR", "current/past exchange rate", "FX rate on this date / over this range", or "current price of Bitcoin/Ethereum, market cap, 24h change". Frankfurter (ECB reference rates, no key) is the FX default; CoinGecko's free keyless tier covers crypto. Do NOT use for stock quotes or equities - no keyless stock API survives verification, say so instead of guessing; do NOT use for country economic indicators like GDP or inflation series - use government-open-data instead; if the request is a vague "I need live data", route through public-data-api-picker.

SkillMedev/skills

Builds a driver-based FP&A operating model linking business inputs to P&L, balance sheet, and cash flow outputs. Use when building an annual plan, preparing investor materials, running scenario analysis, or stress-testing the business.

SkillMedev/skills

Use when a task needs live geographic lookups - "geocode this address", "what's at these coordinates" (reverse geocoding), "lat/lon for this city", "which country/state is this ZIP or postal code in", or "country facts: capital, currency, population, flag". Nominatim (OpenStreetMap) is the geocoding default; Zippopotam for postal codes; APICountries for country facts. All keyless. Do NOT use for weather at a location - use weather-climate instead; do NOT use for country-level statistics over time (GDP, population trends) - use government-open-data instead; if the request is a vague "I need live data", route through public-data-api-picker.

SkillMedev/skills

Runs the full Getting Things Done loop - capture, clarify, organize, reflect, engage - building a trusted system of context lists, a projects list with defined next actions, and a weekly review habit. Use when someone says "I'm overwhelmed and things are slipping through the cracks", "set up GTD for me", "help me do a brain dump and organize it", or "my to-do list is a mess". Do NOT use for just running the weekly review ritual itself - use weekly-review instead - or for clearing an email backlog - use inbox-zero.

SkillMedev/skills

Processes any email backlog to zero using the 4Ds - Delete, Delegate, Defer, Do - with a mass-archive strategy for the obvious, a touch-each-email-once discipline, and a keep-it-clear system of batched processing windows, ruthless unsubscribing, filters, and a minimal folder setup. Use when someone says "I have 5,000 unread emails", "help me get to inbox zero", "email is eating my whole day", or treats their inbox as a to-do list. Do NOT use for drafting the reply emails themselves or prioritization rules for an ongoing support queue - use email-triage instead - or for protecting focus time around the email windows - use deep-work-planner instead.

SkillMedev/skills

Write landing-page copy section by section - hero, social proof, features-as-benefits, objections, CTA - leading with one promise and proving it down the page. Use when someone asks "write my landing page", "improve my hero headline", "what should the homepage say", "turn these features into benefits", or is shipping a new page for a launch or campaign. Do NOT use for testing and optimizing an existing page's conversion rate - use landing-page-cro instead; for the one-line claim itself use positioning-statement; for the full message ladder use messaging-hierarchy.

SkillMedev/skills

Improves an existing landing page's conversion rate through evidence-first CRO - audit heatmaps and recordings, write structured hypotheses, prioritize with ICE scoring, and run one-variable tests to statistical significance. Use when someone asks "why isn't my landing page converting", "audit this page before we scale spend", "which A/B test should we run first", or after a CVR drop or ahead of a paid-traffic push. Do NOT use for writing a new landing page from scratch - use landing-page-copy instead. Do NOT use for auditing the ad accounts sending the traffic - use paid-acquisition-audit instead. Do NOT use for reading the results of a finished experiment - use ab-test-analyzer instead.

SkillMedev/skills

Runs structured coaching sessions using values clarification and the GROW model, ending every session with one committed action, a deadline, and an if-then plan for the likely obstacle. Use when someone says "I feel stuck in my life", "help me figure out what I want", "hold me accountable to my goals", or "coach me through this decision". Do NOT use for building a stress toolkit - use stress-management instead - or a journaling practice - use journal-framework; for a standing goal-tracking system, use goals-accountability. Coaching, not therapy: signs of clinical distress route to a licensed professional.

SkillMedev/skills

Adapts English content for a target language and region - swapping idioms, setting the right formality register, replacing cultural references, converting dates, units, and currency - and delivers the localized text with a notes column explaining each adaptation and flagging what needs a native reviewer. Use when someone asks "localize this copy for the Japanese market", "adapt our marketing copy for the Mexican market", "make this translation sound native instead of literal", or a literal translation reads foreign, stiff, or risky. Do NOT use for auditing in-product UI text quality - use ux-writing-audit instead.

SkillMedev/skills

Scaffolds a new Remotion video project wired for Claude Code Agent Skills - Node check, create-video scaffold, skills install, folder conventions, Google Fonts, and a smoke-test render. Use whenever someone wants to start making videos with Remotion and Claude, even just "make product videos with Claude.

SkillMedev/skills

Classifies incident severity (SEV1-4) using impact, scope, and urgency signals and decides who to page. Use when an alert fires or a report comes in and a severity call must be made quickly.

SkillMedev/skills

Use the Skill Me catalog from inside any conversation - discover, install, and manage Claude skills through the Skill Me MCP, and load installed skills automatically each session.

SkillMedev/skills

Write one platform-native caption from a topic and brand voice, with a front-loaded hook, native length, and a single earned CTA. Use when the user gives a topic (and optionally brand voice or a described image/video) and asks for an Instagram, LinkedIn, X/Twitter, or TikTok caption. Do NOT use when the user wants a dedicated standalone LinkedIn post - use linkedin-post-writer instead; or a multi-post X thread - use tweet-thread-builder instead; or to adapt one existing piece of content into versions for several channels - use cross-platform-reformatter instead.

SkillMedev/skills

Reframe and export a finished video for social platforms - 9:16 ↔ 16:9 cropping, burned-in captions, a platform-native first frame, loop design, and per-platform specs (aspect, length, safe areas) for TikTok, Reels, Shorts, X, and LinkedIn. Use when someone says "make this vertical", "crop to 9:16", "format for TikTok/Reels/Shorts", "add captions/subtitles", "why is my video cut off on mobile", "resize for Instagram", or "export for social". Do NOT use when the question is about the storyboard or shot order before any video exists (use video-storyboard); the animation craft of how elements move (use motion-design-principles); animated word-by-word caption styling (use kinetic-typography); palette, contrast, or lighting (use motion-color-and-light); directing the product-demo content and screen choreography (use product-demo-director); or scoring, beat-syncing, or audio (use sound-and-music-sync) - this is the craft layer that decides WHAT to format for the feed, then hands a concrete spec to remotion-compo...

SkillMedev/skills

Writes and tunes PySpark jobs - join strategy and broadcast size limits, shuffle-partition sizing, skew diagnosis and salting, UDF avoidance, caching, and output file layout - with concrete size and skew thresholds. Use when someone asks "why is my Spark job slow", "should I broadcast this join", "one task takes forever while the rest finish", "my job OOMs during a join", or is writing a new PySpark ETL job. Do NOT use for Kafka topic, consumer-group, or streaming-pipeline design - use kafka-pipelines instead; do NOT use for single-machine dataframe work that fits in memory - use pandas-expert instead.

SkillMedev/skills

Builds clean, performant, accessible SwiftUI views with correct state ownership, scoped invalidation, and smooth list scrolling, and reviews existing SwiftUI code against a concrete frame-time and re-render budget. Use when someone asks "why does my SwiftUI list stutter", "should this be @State or @Observable", "my whole screen re-renders when one row changes", "how do I animate this transition", or wants a SwiftUI view built or refactored. Do NOT use for cross-platform React Native apps - use react-native-pro instead; do NOT use for Flutter widget trees - use flutter-widget-architect instead; do NOT use for Android Compose UIs - use jetpack-compose-builder instead.

Habilidades Relacionadas