Communitygithub.com

joyehuang/skills

Convierte guiones de video en proyectos Remotion listos para producción con componentes React, audio y renderizado.

¿Qué es skills?

Esta habilidad transforma guiones de video estructurados (script.json) en proyectos Remotion completos y funcionales. Sigue un flujo de trabajo en 4 fases: generación de componentes React por escena, ensamblaje del proyecto, generación opcional de audio TTS (usando la API de Google Gemini) y renderizado final en MP4. Admite 6 tipos de escenas (hook, textDisplay, etc.) con animaciones físicas spring y texto responsive. Requiere Node.js 18+, pnpm y la habilidad `remotion-best-practices`. Ideal para creadores de contenido y desarrolladores que buscan automatizar la producción de videos con alta calidad técnica y visual.

Compatible con✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/joyehuang/skills/tree/HEAD/script-to-remotion

Preguntar en tu IA favorita

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

Documentación

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.json en 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:

  1. Lea el archivo script.json
  2. Consulte la habilidad remotion-best-practices
  3. Genere el componente correspondiente a cada tipo de escena
  4. Asegúrese de usar animaciones spring (no CSS)
  5. Utilice fitText/measureText para 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:

  1. Cree la estructura de directorios del proyecto
  2. Copie package.json, tsconfig.json, remotion.config.ts
  3. Cree el componente principal Root.tsx
  4. Copie los componentes compartidos (NeonBackground, Subtitle, etc.)
  5. Copie el archivo de tema (theme.ts)
  6. 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:

  1. Cree un script independiente tts-generator.js
  2. Genere archivos de audio para cada escena
  3. Aplique velocidad de reproducción 1.25x
  4. Genere datos de segmentación de subtítulos
  5. 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:

  1. Inicie el servidor de vista previa de Remotion (pnpm start)
  2. Verifique el resultado en el navegador
  3. Renderice el video final (pnpm build)
  4. 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 escenaDuraciónPropósitoCaracterísticas clave
hook5-8sGancho de aperturaEfecto máquina de escribir, animación de rebote
textDisplay15-20sVisualización de información clavefitText autoajustable, animación de deslizamiento
numberComparison12-18sComparación de datosAnimación de números, diseño antes/después
threeColumns15-20sComparación de tres columnasVisualización escalonada, secuencia Series
caseStudy20-30sHistoria de casoTransitionSeries, transición antes/después
cta8-12sLlamada a la acciónVisualizació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 React
  • project-assembly.md - Estructura y configuración del proyecto
  • render-configuration.md - Configuración de renderizado de Remotion
  • troubleshooting.md - Solución de problemas comunes

Guías de tipos de escena (6):

  • scene-types/hook-scene.md - Escena de gancho de apertura
  • scene-types/text-display-scene.md - Escena de visualización de texto
  • scene-types/number-comparison-scene.md - Escena de comparación numérica
  • scene-types/three-columns-scene.md - Escena de tres columnas
  • scene-types/case-study-scene.md - Escena de caso de estudio
  • scene-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 proyecto
  • tsconfig.json.template - Configuración de TypeScript
  • remotion.config.ts.template - Configuración de Remotion
  • theme.ts - Tema de vidrio neón

Componentes compartidos:

  • components/NeonBackground.tsx - Fondo degradado dinámico
  • components/SceneAudio.tsx - Reproductor de audio
  • components/Subtitle.tsx - Componente de subtítulo

Otros:

  • Root.tsx.template - Plantilla del componente principal
  • tts-generator.js.template - Script de generación TTS

Ejemplos

  • examples/script-input.json - Script de entrada de ejemplo
  • examples/Hook-scene-example.tsx - Componente de escena Hook completo
  • examples/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/measureText para manejar el texto
  • ✅ Los componentes deben ser funciones puras (sin efectos secundarios)
  • ✅ Usar correctamente useCurrentFrame() y useVideoConfig()
  • ❌ 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.md para 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

Skills relacionados