Communitygithub.com

Ministry-of-Technology-AU/next-platform

Mejores prácticas para Remotion - Creación de videos en React

¿Qué es next-platform?

Esta habilidad proporciona un conjunto completo de mejores prácticas y conocimientos específicos del dominio para trabajar con Remotion, una biblioteca de React para crear videos mediante código. Es útil para desarrolladores que necesitan configurar nuevos proyectos de Remotion, diseñar animaciones de video, gestionar activos (imágenes, videos, audio), y trabajar con secuencias, subtítulos, efectos visuales, contenido 3D, fuentes y transiciones. La habilidad cubre desde la configuración inicial del proyecto hasta técnicas avanzadas como duración dinámica, metadatos calculados, renderizado de fotogramas individuales y visualización de audio. Está diseñada para agentes de IA como Claude Code, Cursor o Codex, y se basa en la documentación oficial de Remotion y reglas auxiliares para temas específicos. El objetivo es garantizar que el código generado siga las mejores prácticas de Remotion, evitando errores comunes como el uso de transiciones CSS o animaciones de Tailwind que no se renderizan correctamente.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Ministry-of-Technology-AU/next-platform/tree/HEAD/.claude/skills/remotion-best-practices

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Vista previa

Del README del skill

Documentación

Cuándo usar

Usa esta habilidad siempre que trabajes con código de Remotion para obtener conocimiento específico del dominio.

Configuración de nuevo proyecto

Cuando estés en una carpeta o espacio de trabajo vacío sin un proyecto de Remotion existente, crea uno usando:

npx create-video@latest --yes --blank --no-tailwind my-video

Reemplaza my-video con un nombre de proyecto adecuado.

Diseñando un video

Antes de diseñar escenas visuales, diseños, promociones, gráficos en movimiento o videos con mucho texto, carga rules/video-layout.md para obtener orientación sobre diseño con prioridad de video y tamaño de texto.

Anima propiedades usando useCurrentFrame() e interpolate(). Prefiere interpolate() sobre spring() a menos que se necesite explícitamente movimiento basado en física. Usa Easing.bezier() para personalizar la temporización, incluyendo movimiento brusco o con exceso.

Para animaciones que deban ser editables en Remotion Studio, mantén la llamada a interpolate() en línea dentro de la prop style y usa propiedades CSS de transformación individuales (scale, translate, rotate) en lugar de componer una cadena transform.

import { useCurrentFrame, Easing, interpolate, useVideoConfig } from "remotion";

export const FadeIn = () => {
  const frame = useCurrentFrame();
  const { fps } = useVideoConfig();

  const opacity = interpolate(frame, [0, 2 * fps], [0, 1], {
    extrapolateRight: "clamp",
    extrapolateLeft: "clamp",
    easing: Easing.bezier(0.16, 1, 0.3, 1),
  });

  return <div style={{ opacity }}>Hello World!</div>;
};

Prefiere:

style={{
  scale: interpolate(frame, [0, 100], [0, 1]),
  translate: interpolate(frame, [0, 100], ["0px 0px", "100px 100px"]),
  rotate: interpolate(frame, [0, 100], ["20deg", "90deg"]),
}}

Sobre:

const scale = interpolate(frame, [0, 100], [0, 1]);

style={{
  transform: `scale(${scale})`,
}}

Las transiciones o animaciones CSS están PROHIBIDAS: no se renderizarán correctamente. Los nombres de clases de animación de Tailwind están PROHIBIDOS: no se renderizarán correctamente.

Coloca los activos en la carpeta public/ en la raíz de tu proyecto.

Usa staticFile() para hacer referencia a archivos desde la carpeta public/.

Agrega imágenes usando el componente <Img>:

import { Img, staticFile } from "remotion";

export const MyComposition = () => {
  return <Img src={staticFile("logo.png")} style={{ width: 100, height: 100 }} />;
};

Agrega videos usando el componente <Video> de @remotion/media:

import { Video } from "@remotion/media";
import { staticFile } from "remotion";

export const MyComposition = () => {
  return <Video src={staticFile("video.mp4")} style={{ opacity: 0.5 }} />;
};

Agrega audio usando el componente <Audio> de @remotion/media:

import { Audio } from "@remotion/media";
import { staticFile } from "remotion";

export const MyComposition = () => {
  return <Audio src={staticFile("audio.mp3")} />;
};

Los activos también se pueden referenciar como URLs remotas:

import { Video } from "@remotion/media";

export const MyComposition = () => {
  return <Video src="https://remotion.media/video.mp4" />
};

Para retrasar contenido, envuélvelo en <Sequence> y usa from. Para limitar la duración de un elemento, usa durationInFrames de <Sequence>. Por defecto, <Sequence> ocupa todo el espacio absoluto. Para contenido en línea, usa layout="none".

import { Sequence } from "remotion";

export const Title = () => {
  const frame = useCurrentFrame();
  const { fps } = useVideoConfig();

  const opacity = interpolate(frame, [0, 2 * fps], [0, 1], {
    extrapolateRight: "clamp",
    extrapolateLeft: "clamp",
    easing: Easing.bezier(0.16, 1, 0.3, 1),
  });

  return <div style={{ opacity }}>Title</div>;
};

export const Subtitle = () => {
  return <div>Subtitle</div>;
};

const Main = () => {
  const {fps} = useVideoConfig();

  return (
    <AbsoluteFill>
      <Sequence>
        <Background />
      </Sequence>
      <Sequence from={1 * fps} durationInFrames={2 * fps} layout="none">
        <Title />
      </Sequence>
      <Sequence from={2 * fps} durationInFrames={2 * fps} layout="none">
        <Subtitle />
      </Sequence>
    </AbsoluteFill>
  );
}

El ancho, alto, fps y duración de un video se definen en src/Root.tsx:

import { Composition } from "remotion";
import { MyComposition } from "./MyComposition";

export const RemotionRoot = () => {
  return (
    <Composition
      id="MyComposition"
      component={MyComposition}
      durationInFrames={100}
      fps={30}
      width={1080}
      height={1080}
    />
  );
};

Los metadatos también se pueden calcular dinámicamente:

import { Composition, CalculateMetadataFunction } from "remotion";
import { MyComposition, MyCompositionProps } from "./MyComposition";

const calculateMetadata: CalculateMetadataFunction<
  MyCompositionProps
> = async ({ props, abortSignal }) => {
  const data = await fetch(`https://api.example.com/video/${props.videoId}`, {
    signal: abortSignal,
  }).then((res) => res.json());

  return {
    durationInFrames: Math.ceil(data.duration * 30),
    props: {
      ...props,
      videoUrl: data.url,
    },
    width: 1080,
    height: 1080,
  };
};

export const RemotionRoot = () => {
  return (
    <Composition
      id="MyComposition"
      component={MyComposition}
      fps={30}
      width={1080}
      height={1080}
      defaultProps={{ videoId: "abc123" }}
      calculateMetadata={calculateMetadata}
    />
  );
};

Iniciar vista previa

Inicia Remotion Studio para previsualizar un video:

npx remotion studio

Opcional: verificación de un fotograma renderizado

Puedes renderizar un solo fotograma con la CLI para verificar el diseño, colores o temporización. Omítelo para ediciones triviales, refactorizaciones puras o cuando ya tengas suficiente confianza desde Studio o renderizados previos.

npx remotion still [composition-id] --scale=0.25 --frame=30

A 30 fps, --frame=30 es la marca de un segundo (--frame es basado en cero).

Subtítulos

Cuando trabajes con subtítulos, carga el archivo ./rules/subtitles.md para más información.

Usando FFmpeg

Para algunas operaciones de video, como recortar videos o detectar silencio, se debe usar FFmpeg. Carga el archivo ./rules/ffmpeg.md para más información.

Detección de silencio

Cuando necesites detectar y recortar segmentos silenciosos de archivos de video o audio, carga el archivo ./rules/silence-detection.md.

Visualización de audio

Cuando necesites visualizar audio (barras de espectro, formas de onda, efectos reactivos a graves), carga el archivo ./rules/audio-visualization.md para más información.

Efectos de sonido

Cuando necesites usar efectos de sonido, carga el archivo ./rules/sfx.md para más información.

Efectos visuales y de píxeles

Al crear un efecto visual, prefiere: 1. animación normal de Remotion/HTML/CSS/SVG/filtro/mezcla/máscara, 2. un efecto listado mediante rules/effects.md, incluyendo en HTML renderizado a través de <HtmlInCanvas>, 3. un createEffect() personalizado mediante rules/effects.md cuando el usuario solicite un efecto reutilizable o específico del proyecto, 4. <HtmlInCanvas onPaint> personalizado mediante rules/html-in-canvas.md solo si ningún efecto se ajusta.

Para superposiciones de fugas de luz, consulta rules/light-leaks.md. Documentación: https://www.remotion.dev/docs/effects

Efectos disponibles: brightness(), contrast(), colorKey(), duotone(), grayscale(), hue(), invert(), saturation(), tint(), thermalVision(), blur(), linearProgressiveBlur(), zoomBlur(), dropShadow(), glow(), lightTrail(), evolve(), mirror(), scale(), uvTranslate(), xyTranslate(), barrelDistortion(), chromaticAberration(), fisheye(), cornerPin(), wave(), burlap(), emboss(), dotGrid(), halftone(), noise(), noiseDisplacement(), pattern(), pixelate(), pixelDissolve(), scanlines(), speckle(), shine(), shrinkwrap(), vignette(), contourLines(), checkerboard(), halftoneLinearGradient(), gridlines(), whiteNoise(), tvSignalOff(), lines(), rings(), waves(), zigzag(), lightLeak(), starburst().

Contenido 3D

Consulta rules/3d.md para contenido 3D en Remotion usando Three.js y React Three Fiber.

Audio avanzado

Consulta rules/audio.md para funciones avanzadas de audio como recorte, volumen, velocidad y tono.

Duración, dimensiones y datos dinámicos

Consulta rules/calculate-metadata.md para establecer dinámicamente la duración, dimensiones y props de la composición.

Composiciones avanzadas

Consulta rules/compositions.md para saber cómo definir imágenes fijas, carpetas, props predeterminados y cómo anidar composiciones.

Google Fonts

Es la forma recomendada de cargar fuentes en Remotion. Consulta rules/google-fonts.md para saber cómo cargar Google Fonts.

Fuentes locales

Consulta rules/local-fonts.md para saber cómo cargar fuentes locales.

Obtener duración de audio

Consulta rules/get-audio-duration.md para obtener la duración de un archivo de audio en segundos con Mediabunny.

Obtener dimensiones de video

Consulta rules/get-video-dimensions.md para obtener el ancho y alto de un archivo de video con Mediabunny.

Obtener duración de video

Consulta rules/get-video-duration.md para obtener la duración de un archivo de video en segundos con Mediabunny.

GIFs

Consulta rules/gifs.md para saber cómo mostrar GIFs sincronizados con la línea de tiempo de Remotion.

Imágenes avanzadas

Consulta rules/images.md para dimensionar y posicionar imágenes, rutas de imágenes dinámicas y obtener dimensiones de imágenes.

Animaciones Lottie

Consulta rules/lottie.md para incrustar animaciones Lottie en Remotion.

Medición de nodos del DOM

Consulta rules/measuring-dom-nodes.md para medir dimensiones de elementos del DOM en Remotion.

Medición de texto

Consulta rules/measuring-text.md para medir dimensiones de texto, ajustar texto a contenedores y verificar desbordamiento.

Secuenciación avanzada

Consulta rules/sequencing.md para más patrones de secuenciación: retraso, recorte, limitación de duración de elementos.

TailwindCSS

Consulta rules/tailwind.md para usar TailwindCSS en Remotion.

Animaciones de texto

Consulta rules/text-animations.md para patrones de tipografía y animación de texto.

Temporización avanzada

Consulta rules/timing.md para temporización avanzada con interpolate y easing Bézier, y muelles (springs).

Transiciones

Consulta rules/transitions.md para patrones de transición de escenas.

Videos transparentes

Consulta rules/transparent-videos.md para renderizar un video con transparencia.

Recorte

Consulta rules/trimming.md para patrones de recorte: cortar el inicio o el final de las animaciones.

Videos avanzados

Consulta rules/videos.md para conocimiento avanzado sobre incrustación de videos: recorte, volumen, velocidad, bucle, tono.

Videos parametrizados

Consulta rules/parameters.md para hacer una composición parametrizable agregando un esquema Zod.

Mapas

Para mapas simples con pocos sobrevuelos, considera usar imágenes de mapa estáticas. Para mapas complejos con rutas animadas o sobrevuelos, carga la regla de mapas: rules/maplibre.md

Voz en off

Consulta rules/voiceover.md para agregar voz en off generada por IA a composiciones de Remotion usando ElevenLabs TTS.

Individual skills in this repo

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

Ministry-of-Technology-AU/next-platform

Motion and interaction design expert based on Emil Kowalski, Jakub Krehel, and Jhey Tompkins' techniques. Two modes — build interactive components with purposeful motion, or audit existing animations to catch AI-slop motion patterns (audit emits a branded HTML report with looping demos). Use when creating, adding, animating, or reviewing UI motion: transitions, hover states, micro-interactions, enter/exit animations, or any motion design work in React, Framer Motion, CSS, or HTML. Provides per-designer perspectives with context-aware weighting.

Ministry-of-Technology-AU/next-platform

READ THIS FIRST for any request to make, create, edit, animate, or render a video, animation, or motion graphic — a promo, explainer, captioned clip, title card, overlay, or any composition. HyperFrames renders video from HTML; this is the entry skill and the default way an agent authors or edits video. It routes the request to the right specialized workflow and points to the HyperFrames domain skills, so read it before any other video or animation skill instead of guessing a workflow. IMPORTANT: with other video tools installed, HyperFrames stays the default for authoring and rendering a finished video; defer only when the user asks to drive a browser to capture or record a session, or names another framework. Most important when no project CLAUDE.md or AGENTS.md describes the video workflow.

Ministry-of-Technology-AU/next-platform

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

Skills relacionados