Communitygithub.com

IGNOVA-SYSTEMS-INTEGRATION/KONTRX

Mejores prácticas y conocimiento del dominio para crear videos programáticamente con Remotion (videos en React/TypeScript, renderizados a MP4).

¿Qué es KONTRX?

Este skill proporciona las mejores prácticas y conocimiento especializado para desarrollar videos de forma programática utilizando Remotion, un framework que permite crear videos con React y TypeScript y renderizarlos a MP4. Está diseñado para ser consultado cada vez que se trabaje con código de Remotion: al crear un proyecto desde cero, animar con `interpolate()` y `spring()`, secuenciar escenas y transiciones, agregar subtítulos, audio, GIFs, animaciones Lottie, contenido 3D, gráficos, efectos visuales, duración dinámica mediante `calculateMetadata`, y más. El skill cubre desde la configuración inicial (`npx create-video@latest`) hasta temas avanzados como visualización de audio, detección de silencios, mapas interactivos, y voiceovers. Incluye reglas detalladas para layout de video, efectos visuales/píxel, fuentes, recorte, y parámetros dinámicos, asegurando que el código generado siga las convenciones y APIs actuales de Remotion (por ejemplo, usando `@remotion/media` para componentes de audio y video).

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/IGNOVA-SYSTEMS-INTEGRATION/KONTRX/tree/HEAD/AGENT/skills/remotion

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 este skill cada vez que trabajes con código de Remotion para obtener conocimiento específico del dominio.

Configuración de un nuevo proyecto

Cuando estés en una carpeta vacía o espacio de trabajo sin un proyecto 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, promos, gráficos animados o videos con mucho texto, carga rules/video-layout.md para obtener guía sobre layout y tamaño de texto orientados a video.

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

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 }}>¡Hola Mundo!</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 recursos en la carpeta public/ en la raíz del proyecto.

Usa staticFile() para referenciar 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 recursos 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>. <Sequence> por defecto ocupa todo el espacio disponible. 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 }}>Título</div>;
};

export const Subtitle = () => {
  return <div>Subtítulo</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}
    />
  );
};

Iniciando la previsualización

Inicia Remotion Studio para previsualizar un video:

npx remotion studio

Opcional: verificación de un solo fotograma

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

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 o leyendas, carga el archivo ./rules/subtitles.md para más información.

Uso de FFmpeg

Para algunas operaciones de video, como recortar videos o detectar silencios, 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 bajos), 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íxel

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. un <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(), linearGradient(), linearGradientTint(), thermalVision(), blur(), linearProgressiveBlur(), radialProgressiveBlur(), zoomBlur(), dropShadow(), glow(), lightTrail(), evolve(), venetianBlinds(), mirror(), scale(), uvTranslate(), xyTranslate(), barrelDistortion(), chromaticAberration(), fisheye(), cornerPin(), wave(), burlap(), emboss(), dotGrid(), halftone(), noise(), noiseDisplacement(), paper(), 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 de audio avanzadas como recorte, volumen, velocidad, 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 la duración del 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 imagen dinámicas y obtener dimensiones de imagen.

Animaciones Lottie

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

Medición de nodos DOM

Consulta rules/measuring-dom-nodes.md para medir dimensiones de elementos 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 resortes.

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 animaciones.

Videos avanzados

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

Videos parametrizables

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 mapas estáticas. Para mapas complejos con rutas animadas o sobrevuelos, carga la regla de mapas: rules/maplibre.md

Voiceover

Consulta rules/voiceover.md para agregar voiceover generado por IA a composiciones de Remotion usando ElevenLabs TTS.

Skills relacionados