Pipeline de publicación launch video

Video de lanzamiento / tutorial interactivo

Un pipeline repetible para convertir un producto, funcionalidad o página en un video corto con narración, publicarlo en YouTube, incrustarlo en la página y anunciarlo. Existe porque hacerlo manualmente implica redescubrir una docena de detalles no obvios cada vez (peculiaridades de OAuth, matemáticas de sincronización de voz en off, el embed de clic para reproducir, objetivos de volumen).

Salida predeterminada: un video 1080p / 30fps, de ~45–60s, con una voz emotiva, subido como no listado primero para que el usuario lo apruebe, luego hecho público. Nunca publiques un video públicamente sin que el usuario lo haya escuchado/visto — las voces y el ritmo son subjetivos.

Configura esto para tu proyecto

Antes del primer uso, completa config.md (algunos IDs y rutas). La skill lee esos valores en lugar de valores codificados, por lo que funciona para cualquier producto. Los valores que necesitas:

• Tu canal de YouTube (la cuenta OAuth debe tenerlo seleccionado)
• La ruta de tu secreto de cliente OAuth y el número de proyecto de GCP (YouTube Data API v3 habilitada)
• A dónde van los anuncios de video terminado (canal de Slack, Discord, etc.)
• Tus colores de marca y el patrón de URL del producto

Cuándo usarlo

Para crear cualquier video para una página/funcionalidad/herramienta, agregar una voz en off o enviar un video a YouTube. Para una solicitud amplia de "agregar videos a nuestras mejores páginas", primero extrae las páginas principales (de tus análisis), luego ejecuta este pipeline una vez por página — prueba una, obtén aprobación del formato, luego procesa en lote el resto.

El pipeline (7 pasos)

Trabaja de arriba a abajo. Cada paso tiene detalle en el archivo o script referenciado.

1. Entiende el tema. Lee la implementación / documentación para que los pasos mostrados coincidan con el comportamiento real. Para un tutorial de herramienta, maneja la herramienta en vivo (Playwright) para ver el flujo real de entrada→salida — ESO es el tutorial.

2. Captura capturas de pantalla reales. Playwright contra producción, 1920×1080. Oculta cualquier banner promocional / barra de cookies primero. Consulta references/video-production.md → "Capturing screenshots".

3. Construye el video de Remotion. Copia la estructura remotion-scaffold/. Las escenas se cuentan por fotogramas a 30fps en src/theme.ts. Ajusta cada escena a su duración de narración (paso 4). Patrones completos de escenas/animaciones en references/video-production.md.

4. Genera la voz en off. scripts/tts_voiceover.py — OpenAI gpt-4o-mini-tts, voz ash, con un prompt instructions para emoción (sin él, la lectura es plana y robótica — este es el detalle más importante de la voz en off). Genera clips por escena, los sincroniza con el fotograma de inicio de cada escena y normaliza el volumen de la pista mezclada. Reajusta los tiempos de las escenas en theme.ts si un clip se desborda de su escena, luego vuelve a renderizar.

5. Renderiza + multiplexa + codifica. npx remotion render, multiplexa la pista de voz con ffmpeg (-c:v copy), luego codifica un corte de subida < 10 MB (libx264 -crf 25 -movflags +faststart). Comandos en references/video-production.md → "Render, mux, encode".

6. Publica en YouTube. scripts/youtube.py (envuelve youtubeuploader para la subida, usa la API de Datos para todo lo demás). Sube como no listado, obtén la aprobación del usuario, luego hazlo público. Lee references/youtube-publishing.md primero — tiene la configuración de autenticación, el problema de redirección de OAuth, el error de API no habilitada, los límites de cuota y la plantilla de metadatos.

7. Incrusta + anuncia. Agrega una sección de fachada de clic para reproducir a la página (póster + botón de reproducción; el iframe de YouTube solo se monta al hacer clic — lo mantiene fuera de la carga inicial). Luego publica el enlace en tu canal de equipo. Ambos patrones en references/embed-and-announce.md.

Barreras de protección

• No listado → aprobar → público, cada vez. Subir al canal del usuario requiere su aprobación.
• El consentimiento OAuth de Google lo da el usuario — no puedes hacer clic en "Permitir" por ellos. Si la autenticación no está configurada, guíalos a través de ella (consulta references/youtube-publishing.md), no intentes omitirla.
• Mantén el render maestro; solo el corte de subida tiene restricción de tamaño.
• La cuota de la API de YouTube ≈ 6 subidas / 24h. Un lote más grande debe distribuirse en varios días — dilo en lugar de fallar silenciosamente a mitad de camino.
• La CLI no puede establecer una miniatura — indica que el usuario debe agregar una en Studio (o configurarla por separado a través de la API).