Communitygithub.com

AbdelrhmanAlquran/claude-skills

Crea, depura y renderiza vídeos programáticamente con Remotion (framework de vídeo basado en React). Úsalo cuando el usuario quiera crear un vídeo con código, pregunte específicamente sobre Remotion, mencione vídeo React, vídeo programático, MP4 desde React, explicación animada con código, presentador con subtítulos, vídeo basado en datos, o pegue un error de Remotion. Cubre configuración de composiciones, patrones de animación con useCurrentFrame (interpolate, spring), diseño con Sequence/AbsoluteFill, componentes de audio/vídeo/imagen, el Studio y renderizado mediante CLI / @remotion/renderer / Lambda. NO usar para tareas de vídeo que no sean de Remotion — usa el skill `video` para generación de vídeo con IA (Veo, Sora, Runway, HeyGen).

¿Qué es claude-skills?

Este skill proporciona orientación completa para trabajar con Remotion, un framework que convierte componentes de React en vídeos MP4 y otros formatos. Es ideal para desarrolladores que desean crear vídeos programáticamente, ya sean animaciones explicativas, presentaciones con subtítulos o vídeos basados en datos. El skill cubre todo el flujo de trabajo: desde la detección o creación de un proyecto Remotion (con `npx create-video@latest`), pasando por la configuración de composiciones en `src/Root.tsx`, el uso de hooks fundamentales como `useCurrentFrame()` y `useVideoConfig()`, hasta el diseño con `Sequence` y `AbsoluteFill`. También proporciona referencias detalladas para patrones de animación comunes (interpolate, spring, Easing), manejo de medios (audio, vídeo, imágenes, subtítulos), renderizado con CLI, `@remotion/renderer` y Lambda, y solución de errores típicos como parpadeos, composiciones no encontradas o problemas de memoria. El skill enfatiza reglas estrictas: animar exclusivamente mediante `useCurrentFrame()` (no CSS transitions ni setTimeout), mantener los componentes puros y sin efectos secundarios, y verificar siempre los cambios renderizando un segmento de prueba. Está diseñado para plataformas como Claude Code, Cursor o Codex, donde un agente AI necesita guiar al usuario en la construcción y depuración de proyectos Remotion de manera efectiva.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AbdelrhmanAlquran/claude-skills/tree/HEAD/remotion

Preguntar en tu IA favorita

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

Documentación

Remotion

Remotion convierte componentes de React en vídeos. Escribes JSX, Remotion llama a tu componente una vez por fotograma a un fps fijo, y los fotogramas resultantes se unen en un MP4 (u otro formato).

Modelo mental central

Remotion te da un número de fotograma y un lienzo en blanco. Tu componente React decide qué renderizar en ese fotograma.

No existe una línea de tiempo de animación en el sentido imperativo. El tiempo es un número (frame), y tu componente es una función pura de ese número más las props. Por eso las animaciones deben manejarse con useCurrentFrame() — las transiciones CSS y setTimeout no son deterministas durante el renderizado y provocarán parpadeos o desincronización.

Cuándo usar este skill

  • El usuario tiene un proyecto Remotion (remotion.config.ts o @remotion/* en package.json) y quiere construir, cambiar o depurar una composición
  • El usuario dice "hagamos un vídeo con Remotion / con código / programáticamente"
  • El usuario pega un error de Remotion o pregunta sobre interpolate, spring, Sequence, useCurrentFrame, Composition, etc.
  • El usuario quiere renderizar un proyecto Remotion existente o configurar el renderizado con Lambda

Cuándo NO usar

  • Generar vídeo con modelos de IA (Veo, Sora, Runway, Kling, HeyGen) → usa el skill video
  • Editar archivos de vídeo existentes (cortar/recortar/unir) → ffmpeg, no Remotion
  • Transmisión en vivo → Remotion es solo para renderizado offline

Flujo de trabajo

  1. Detectar o crear el proyecto.

    • Proyecto nuevo: npx create-video@latest (interactivo — elige una plantilla como Hello World, Blank, JavaScript, TikTok, etc.)
    • Proyecto existente: verifica remotion.config.ts, src/Root.tsx y @remotion/cli en package.json. Anota la versión mayor de Remotion — las APIs evolucionan y la URL correcta de la documentación es https://www.remotion.dev/docs (última) o páginas con versión específica.
  2. Localizar o crear la composición. Las composiciones se registran en src/Root.tsx mediante <Composition id="..." component={...} durationInFrames={...} fps={30} width={1920} height={1080} defaultProps={{...}} />. El id es lo que la CLI renderiza por nombre.

  3. Construir el componente usando useCurrentFrame + useVideoConfig para el tiempo y los metadatos. Compón el diseño con <AbsoluteFill>, segmenta el tiempo con <Sequence>.

  4. Vista previa en el Studio: npx remotion studio (recarga automática). No intentes "probar" fotogramas de forma aislada — abre el Studio.

  5. Renderizar: npx remotion render <CompositionId> [output.mp4]. El códec predeterminado es H.264 / MP4. Consulta references/rendering.md para conocer las opciones y la API programática.

Referencia rápida de la API

Consulta los archivos enlazados para más profundidad — cárgalos solo cuando una tarea los necesite.

TemaArchivo
Composition, hooks, Sequence, AbsoluteFill, diseñoreferences/core-concepts.md
interpolate, spring, Easing, escalonamiento, patrones de animación comunesreferences/animation.md
Renderizado: opciones de CLI, @remotion/renderer, Lambda, códecs, propsreferences/rendering.md
Audio/vídeo/imágenes: <Audio>, <Video>, <Img>, <OffthreadVideo>, subtítulosreferences/media.md
Configuración del proyecto, convenciones de archivos, remotion.config.tsreferences/project-setup.md
Patrones comunes: animaciones de escritura, tercios inferiores, basados en datos, parallaxreferences/patterns.md

Reglas estrictas

  1. Anima mediante useCurrentFrame(). Nunca uses setTimeout, requestAnimationFrame o transiciones CSS (transition). Parpadean durante el renderizado porque cada fotograma se renderiza de forma independiente en un navegador headless.
  2. durationInFrames es obligatorio y debe ser un entero. El total de segundos = durationInFrames / fps.
  3. Mantén los componentes puros. Sin efectos secundarios de nivel superior, sin Math.random() sin una semilla determinista — el mismo fotograma siempre debe producir los mismos píxeles.
  4. No hagas fetch en el renderizado. Usa delayRender() / continueRender() para bloquear la preparación del fotograma mientras se cargan los datos, o precarga y pasa mediante props.
  5. Usa <OffthreadVideo> en lugar de <Video> cuando sea posible para lecturas de vídeo no bloqueantes durante el renderizado (más rápido, menos memoria).
  6. Pasa datos dinámicos mediante --props (CLI) o inputProps (Studio/programático), no editando archivos.

Errores comunes

Error / síntomaCausaSolución
Parpadeo / movimiento desajustado en MP4 vs vista previa en StudioSe usaron transiciones CSS o animaciones no basadas en fotogramasReemplaza con interpolate(frame, ...) o spring({ frame, fps })
"Composition not found"Error tipográfico en el ID o falta el registro de <Composition>Verifica src/Root.tsx
El renderizado se cuelgadelayRender() pendiente nunca llamó a continueRender()Encuentra la promesa no resuelta; agrega try/finally
Falta de memoria en vídeos largos<Video> mantiene fotogramas en memoriaCambia a <OffthreadVideo>
Audio desincronizadoEl archivo de audio tiene fps incorrecto o comienza en el fotograma equivocadoEnvuelve <Audio> en <Sequence from={...}>

Verificación

Después de realizar cambios, siempre:

  • Ejecuta npx remotion studio y recorre la línea de tiempo para confirmar que el cambio se vea correcto en varios fotogramas (inicio, medio, final)
  • Para cambios programáticos, renderiza un segmento de prueba corto: npx remotion render <id> out.mp4 --frames=0-60
  • Verificación de tipos: npx tsc --noEmit si el proyecto es TypeScript

No declares éxito sin uno de estos pasos. El código que compila no es lo mismo que un vídeo que se vea bien.

Skills relacionados