script-to-remotion
Convierte guiones de video estructurados en proyectos Remotion funcionales, incluyendo generación de componentes React, integración de audio TTS, generación de subtítulos y renderizado de video.
Casos de uso
Utilice esta habilidad cuando necesite:
- Convertir un
script.jsonen un proyecto de video Remotion - Generar componentes React que sigan las
remotion-best-practices - Generar opcionalmente audio TTS (usando la API de Google Gemini)
- Generar subtítulos inteligentemente segmentados
- Renderizar el video final en formato MP4
No usar cuando:
- Genere un guion directamente desde un artículo (use la habilidad
article-to-script) - Edite videos existentes o realice cortes
- Cree contenido de video interactivo
Requisitos previos
Obligatorios
- script.json - Salida de la habilidad
article-to-script - Node.js - Versión 18+ y el gestor de paquetes pnpm
- Habilidad remotion-best-practices - Debe consultarse para garantizar la calidad de los componentes
Opcionales
- Clave API de Google Gemini - Para la generación de audio TTS
- Música de fondo - Archivo BGM (si se necesita)
Flujo de trabajo
Esta habilidad sigue un flujo de trabajo en 4 fases:
Fase 1: Generación de componentes (30-45 minutos)
Genere componentes React para cada escena
Proceso:
- Lea el archivo
script.json - Consulte la habilidad
remotion-best-practices - Genere el componente correspondiente a cada tipo de escena
- Asegúrese de usar animaciones spring (no CSS)
- Utilice
fitText/measureTextpara manejar el tamaño del texto
Archivo de reglas: rules/component-generation.md
Guías de tipos de escena: rules/scene-types/*.md (6 archivos)
Fase 2: Ensamblaje del proyecto (15-20 minutos)
Cree la estructura completa del proyecto Remotion
Proceso:
- Cree la estructura de directorios del proyecto
- Copie
package.json,tsconfig.json,remotion.config.ts - Cree el componente principal
Root.tsx - Copie los componentes compartidos (
NeonBackground,Subtitle, etc.) - Copie el archivo de tema (
theme.ts) - Instale las dependencias
Archivo de reglas: rules/project-assembly.md
Fase 3: Generación de audio TTS (opcional, 10-15 minutos)
Use la API de Google Gemini para generar audio TTS
Proceso:
- Cree un script independiente
tts-generator.js - Genere archivos de audio para cada escena
- Aplique velocidad de reproducción 1.25x
- Genere datos de segmentación de subtítulos
- Guarde en el directorio
public/audio/
Archivos de reglas: rules/tts-integration.md, rules/subtitle-generation.md
Fase 4: Vista previa y renderizado (5-10 minutos)
Inicie la vista previa y renderice el video
Proceso:
- Inicie el servidor de vista previa de Remotion (
pnpm start) - Verifique el resultado en el navegador
- Renderice el video final (
pnpm build) - Obtenga el archivo
video.mp4
Archivo de reglas: rules/render-configuration.md
Inicio rápido
# 1. Prepare script.json
# Se asume que ya fue generado con article-to-script
# 2. Consulte remotion-best-practices
Read .claude/skills/remotion-best-practices/skill.md
# 3. Consulte las reglas de script-to-remotion
Read .claude/skills/script-to-remotion/rules/component-generation.md
Read .claude/skills/script-to-remotion/rules/scene-types/*.md
# 4. Genere componentes (para cada escena)
# Seleccione la plantilla y reglas según el tipo de escena
# 5. Ensamble el proyecto
Read .claude/skills/script-to-remotion/rules/project-assembly.md
# Siga las instrucciones para crear la estructura completa
# 6. Opcional: Genere TTS
Read .claude/skills/script-to-remotion/rules/tts-integration.md
# Cree y ejecute tts-generator.js
# 7. Instale dependencias
cd video-output-<timestamp>
pnpm install
# 8. Vista previa
pnpm start
# Acceda a http://localhost:3000 en el navegador
# 9. Renderice
pnpm build
# Salida en out/video.mp4
Características principales
Soporte para 6 tipos de escena
Cada tipo de escena tiene plantillas y animaciones específicas:
| Tipo de escena | Duración | Propósito | Características clave |
|---|---|---|---|
| hook | 5-8s | Gancho de apertura | Efecto máquina de escribir, animación de rebote |
| textDisplay | 15-20s | Visualización de información clave | fitText autoajustable, animación de deslizamiento |
| numberComparison | 12-18s | Comparación de datos | Animación de números, diseño antes/después |
| threeColumns | 15-20s | Comparación de tres columnas | Visualización escalonada, secuencia Series |
| caseStudy | 20-30s | Historia de caso | TransitionSeries, transición antes/después |
| cta | 8-12s | Llamada a la acción | Visualización en varios pasos, animación de énfasis |
Animaciones físicas Spring
Todas las animaciones usan el motor físico spring() de Remotion:
const scale = spring({
frame,
fps,
config: { damping: 12, stiffness: 100 }
});
Prohibido usar animaciones CSS (viola las remotion-best-practices)
Texto responsive
Use @remotion/layout-utils para garantizar que el texto se adapte:
import { fitText, measureText } from '@remotion/layout-utils';
const fittedText = fitText({
text: narration,
withinWidth: 1600,
fontFamily: 'Inter',
fontSize: 80
});
Subtítulos inteligentes
Divida automáticamente la narración larga en subtítulos fáciles de leer:
- Segmentación natural por signos de puntuación
- Cada segmento de 3 a 8 segundos de duración
- Efecto de fundido (0.2 segundos)
- Sincronización perfecta con el audio
Archivos de reglas
Todas las reglas del flujo de trabajo están documentadas en el directorio rules/:
Reglas principales:
component-generation.md- Guía de generación de componentes Reactproject-assembly.md- Estructura y configuración del proyectorender-configuration.md- Configuración de renderizado de Remotiontroubleshooting.md- Solución de problemas comunes
Guías de tipos de escena (6):
scene-types/hook-scene.md- Escena de gancho de aperturascene-types/text-display-scene.md- Escena de visualización de textoscene-types/number-comparison-scene.md- Escena de comparación numéricascene-types/three-columns-scene.md- Escena de tres columnasscene-types/case-study-scene.md- Escena de caso de estudioscene-types/cta-scene.md- Escena de llamada a la acción
Audio y subtítulos:
tts-integration.md- Generación de audio TTS (opcional)subtitle-generation.md- Algoritmo de segmentación de subtítulos
Archivos de plantilla
Plantillas de código listas para usar en el directorio templates/:
Archivos de configuración:
package.json.template- Dependencias del proyectotsconfig.json.template- Configuración de TypeScriptremotion.config.ts.template- Configuración de Remotiontheme.ts- Tema de vidrio neón
Componentes compartidos:
components/NeonBackground.tsx- Fondo degradado dinámicocomponents/SceneAudio.tsx- Reproductor de audiocomponents/Subtitle.tsx- Componente de subtítulo
Otros:
Root.tsx.template- Plantilla del componente principaltts-generator.js.template- Script de generación TTS
Ejemplos
examples/script-input.json- Script de entrada de ejemploexamples/Hook-scene-example.tsx- Componente de escena Hook completoexamples/complete-project/- Proyecto completo de referencia
Comandos Bash
Todas las operaciones CLI están documentadas en commands/bash-commands.md:
- Comandos de configuración del proyecto
- Instalación de dependencias
- Generación de TTS (opcional)
- Vista previa y renderizado
- Manejo de errores
Garantía de calidad
Debe seguir las remotion-best-practices
Reglas clave:
- ✅ Usar
spring()para todas las animaciones - ✅ Usar
fitText/measureTextpara manejar el texto - ✅ Los componentes deben ser funciones puras (sin efectos secundarios)
- ✅ Usar correctamente
useCurrentFrame()yuseVideoConfig() - ❌ No usar animaciones o transiciones CSS
- ❌ No usar
useState/useEffect - ❌ No realizar llamadas a APIs externas
Estándar de calidad de componentes
Cada componente generado debe:
- Compilar sin errores de TypeScript
- Exportar el tipo correcto (componente de escena)
- Tener props que incluyan
startFrame,durationFrames,scene - Tener animaciones fluidas (60fps)
- Tener texto claro y legible
- Tener suficiente contraste de color
Solución de problemas
Problemas comunes y soluciones en rules/troubleshooting.md:
- Errores de compilación de TypeScript
- Animaciones entrecortadas
- Desbordamiento de texto
- Problemas de sincronización de audio
- Fallos de renderizado
Historial de versiones
- v3.0.0 (2025-01): Habilidad puramente documental, basada en plantillas
- v2.1.0 (2024-12): Implementación de fases 4-8 impulsada por CLI
- v1.0.0 (2024-11): Habilidad monolítica inicial
Soporte
Si encuentra problemas:
- Consulte
rules/troubleshooting.mdpara problemas comunes - Consulte los ejemplos en
examples/ - Consulte la habilidad
remotion-best-practices - Revise la documentación oficial de Remotion
Habilidades relacionadas
- article-to-script - Aguas arriba: genera
script.json - remotion-best-practices - Debe consultarse: garantiza la calidad de los componentes