Cuándo usar
Carga este skill cada vez que leas o escribas código de Remotion, desde la creación de un proyecto hasta el renderizado del video final.
Errores comunes de IA que debes evitar
Revisa cada cambio de código de Remotion contra estos modos de fallo recurrentes antes de hacer commit:
- Aleatoriedad no determinista — usa
random(seed)deremotion, nuncaMath.random(),Date.now()onew Date(). De lo contrario, los renders paralelos producen ruido parpadeante. inputPropsdel<Player>sin memoizar — pasa siempre props memoizados; los props sin memoizar causan tormentas de re-renderizados en todo el árbol.- Falta de
delayRender()/continueRender()alrededor de trabajo asíncrono (fetch, carga de fuentes, medición). Sin ellos, el render se cuelga a los 30 000 ms. inputRangeno monótono en subtítulos — elinputRangedeinterpolatedebe aumentar estrictamente. Para clips cortos, usaMath.min(10, Math.floor(duration / 3))para la ventana de desvanecimiento.- Easing lineal en todas partes — prefiere
spring()para movimiento natural; usa lineal solo para necesidades técnicas explícitas. - Importaciones olvidadas de
@remotion/google-fonts— cada fuente necesita una llamada explícita aloadFont({ weights, subsets }). - Salida monolítica de una sola composición — divide las escenas en composiciones pequeñas y enfocadas, y compón con
<Sequence>o<TransitionSeries>. startFrom/endAtobsoletos — usatrimBefore/trimAfteren su lugar.
Configuración de un nuevo proyecto
Cuando estés en una carpeta o espacio de trabajo vacío 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.
Inicio de la vista previa
Inicia Remotion Studio para previsualizar un video:
npx remotion studio
Opcional: verificación de un solo frame
Puedes renderizar un solo frame 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 renders anteriores.
npx remotion still [composition-id] --scale=0.25 --frame=30
A 30 fps, --frame=30 es la marca de un segundo (--frame está basado en cero).
Índice de reglas
Lee los archivos de reglas individuales para obtener explicaciones detalladas y ejemplos de código.
Core
- core/compositions.md - Definir composiciones, stills, carpetas, props por defecto y metadatos dinámicos
- core/sequencing.md - Patrones de secuenciación: retraso, recorte, limitación de duración de elementos
- core/timing.md - Temporización con interpolate, easing Bezier y springs
- core/animations.md - Habilidades fundamentales de animación
- core/trimming.md - Recortar el inicio o el final de animaciones
- core/parameters.md - Hacer un video parametrizable con un esquema Zod
- core/calculate-metadata.md - Establecer dinámicamente duración, dimensiones y props de la composición
- core/primitives.md - Primitivas de diseño y temporización: Loop, Freeze, Series, Null, IFrame, AnimatedImage, premount
Media
- media/images.md - Incrustar imágenes usando el componente Img
- media/videos.md - Incrustar videos: recorte, volumen, velocidad, bucle
- media/gifs.md - Mostrar GIFs sincronizados con la línea de tiempo de Remotion
- media/lottie.md - Incrustar animaciones Lottie
- media/transparent-videos.md - Renderizar un video con transparencia
- media/assets.md - Importar imágenes, videos, audio y fuentes
- media/light-leaks.md - Efectos de superposición de fugas de luz
- media/3d.md - Contenido 3D usando Three.js y React Three Fiber
Audio
- audio/audio.md - Usar audio y sonido: importación, recorte, volumen, velocidad, tono
- audio/voiceover.md - Locución generada por IA usando ElevenLabs TTS
- audio/audio-visualization.md - Visualizar audio (barras de espectro, formas de onda, reactivo a graves)
- audio/silence-detection.md - Detección adaptativa de silencio usando FFmpeg
- audio/sfx.md - Usar efectos de sonido
- audio/subtitles.md - Descripción general de subtítulos y leyendas
- audio/get-audio-duration.md - Obtener la duración de un archivo de audio con Mediabunny
- audio/ai-captions.md - Transcripción por IA: @remotion/openai-whisper, whisper-web, install-whisper-cpp
Texto
- text/text-animations.md - Tipografía y patrones de animación de texto
- text/measuring-text.md - Medir dimensiones de texto, ajustar texto a contenedores
- text/fonts.md - Cargar Google Fonts y fuentes locales
- text/google-fonts.md - Paquetes por fuente de @remotion/google-fonts con pesos/subconjuntos requeridos
- text/display-captions.md - Renderizar subtítulos en pantalla
- text/import-srt-captions.md - Importar archivos de subtítulos SRT
Avanzado
- advanced/maps.md - Agregar un mapa usando Mapbox y animarlo
- advanced/charts.md - Gráficos y visualización de datos (barras, circular, líneas, acciones)
- advanced/transitions.md - Patrones de transición de escenas (básicos)
- advanced/transitions-package.md - Referencia completa de @remotion/transitions: presentaciones, temporización, personalizadas
- advanced/tailwind.md - Usar TailwindCSS en Remotion
- advanced/measuring-dom-nodes.md - Medir dimensiones de elementos del DOM
- advanced/hdr.md - Espacio de color y salida HDR: bt709, displayp3, rec2020, ProRes
Utilidades
- utilities/ffmpeg.md - Usar FFmpeg para operaciones de video
- utilities/can-decode.md - Verificar si un video se puede decodificar usando Mediabunny
- utilities/extract-frames.md - Extraer fotogramas en marcas de tiempo específicas
- utilities/get-video-dimensions.md - Obtener ancho y alto de un archivo de video
- utilities/get-video-duration.md - Obtener la duración de un archivo de video en segundos
- utilities/transcribe-captions.md - Transcribir subtítulos
Producción
- production/delay-render.md - Suspender el renderizado durante trabajo asíncrono: delayRender, continueRender, cancelRender
- production/determinism.md - Renders deterministas con random(seed); nunca Math.random / Date.now
- production/rendering.md - SSR de Node con @remotion/renderer: bundle, selectComposition, renderMedia
- production/cli.md - Subcomandos y banderas de npx remotion (render, still, bundle, studio, benchmark)
- production/config.md - Configuradores de remotion.config.ts (códec, CRF, concurrencia, Webpack)
- production/lambda.md - AWS Lambda: deployFunction, deploySite, renderMediaOnLambda, ajuste de costos
- production/player.md - Inserción de @remotion/player, PlayerRef, inputProps memoizados, eventos de buffer
- production/video-tag-decision.md - Elegir entre Video / OffthreadVideo / Html5Video / @remotion/media
- production/input-props.md - Orden de resolución de props, validación Zod, banderas --props de CLI, seguridad de límite de renderizado
- production/caption-timing-safety.md - inputRange monótono y ventana de desvanecimiento adaptativa para subtítulos
- production/performance.md - Aceleración por hardware, concurrencia, formato de imagen, precomputación de GPU, benchmarking
- production/env-vars.md - Prefijo REMOTION_, carga de .env, secretos mediante inputProps / envVariables
Integración
- integration/nextjs.md - Next.js App Router: guardia SSR de Player, transpilePackages, ruta API para Lambda
- integration/docker.md - Docker: imagen base, --shm-size, fuentes, banderas de Chromium, ejemplo de CI
- integration/mediabunny-migration.md - Migrar de media-parser/webcodecs obsoleto a Mediabunny Video/Audio
- integration/v5-prep.md - Preparar código v4 para cambios disruptivos de v5
Paquetes
- packages/paths.md - Utilidades de rutas SVG de @remotion/paths (interpolatePath, warpPath, getLength)
- packages/shapes.md - Primitivas SVG preconstruidas de @remotion/shapes (Triangle, Circle, Star, Pie, Heart)
- packages/noise.md - Ruido Perlin con semilla de @remotion/noise (noise2D, noise3D, noise4D)
- packages/motion-blur.md - Trail y CameraMotionBlur de @remotion/motion-blur (usar con moderación)
- packages/skia.md - Canvas de alto rendimiento de @remotion/skia (React Native Skia)
- packages/rive.md - Animaciones de @remotion/rive con máquinas de estado (alternativa a Lottie)