CommunityProgramación y desarrollogithub.com

saranambiar/hyperframes-video-agent-skills

Habilidades reutilizables, scripts y flujos de trabajo de producción para creación de video asistida por agentes con HyperFrames, FFmpeg, subtítulos, sincronización de audio y control de calidad de renderizado. Proyecto comunitario basado en trabajo real de video con HyperFrames; no es un repositorio oficial de HyperFrames o HeyGen.

¿Qué es hyperframes-video-agent-skills?

Este conjunto de habilidades proporciona guías detalladas y plantillas para que agentes de IA (como Claude Code, Cursor o Codex) automaticen la edición de videos que incluyen grabaciones de productos. Está diseñado específicamente para flujos de trabajo que usan HyperFrames, FFmpeg y otros pipelines de producción de video. La habilidad cubre decisiones de recorte, transiciones entre escenas, sincronización de narración con estados del producto, y controles de calidad para verificar que los subtítulos no oculten elementos importantes de la interfaz de usuario. También incluye matrices de decisión, mapas de momentos del producto y puntos de aprobación del usuario para garantizar que el video final cumpla con los requisitos del cliente. Es útil para equipos que producen videos de demostración de productos de forma automatizada, sin necesidad de intervención manual en cada paso.

Compatible con~Claude Code~Codex CLI✓Cursor
npx skills add saranambiar/hyperframes-video-agent-skills

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

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

Documentación

Integración de Demostración de Producto

Usa esta habilidad cuando el metraje del producto forme parte del video final.

Recepción

Antes de editar:

  • Pregunta por la duración de la grabación, resolución, velocidad de fotogramas y audio.
  • Identifica si la grabación incluye un lienzo, marco del navegador, cursor, zooms, desplazamientos o tiempo muerto.
  • Identifica los momentos requeridos del producto y sus marcas de tiempo.
  • Identifica las frases de narración que deben alinearse con los estados del producto.
  • Solicita aprobación antes de un recorte agresivo si es posible que se corte parte importante de la interfaz de usuario.

Decisión de Recorte

Por defecto, prioriza la preservación de la interfaz de usuario sobre la eliminación del lienzo de fondo.

Usa recorte solo cuando:

  • La interfaz importante permanece visible durante zooms y desplazamientos.
  • El recorte no corta encabezados, etiquetas, contexto del cursor o estado final.
  • Un fotograma de prueba confirma que el zoom más ajustado aún funciona.

Usa sin recorte o recorte ligero cuando:

  • La grabación hace zoom en diferentes áreas.
  • El momento del producto se mueve por el lienzo.
  • El usuario ya ha indicado que el recorte ajustado cortó texto clave.

Lee references/crop-and-zoom.md para una lista de verificación.

Transición al Metraje del Producto

  • Comienza desde el fotograma final de la escena anterior.
  • Usa un movimiento de barrido o empuje de cámara en lugar de un corte brusco si se solicita continuidad.
  • Aterriza en el primer fotograma actual de la grabación del producto.
  • Si la grabación comienza con tiempo muerto, recórtalo solo si hacerlo no rompe la sincronización.
  • Si un momento del producto debe alinearse con la narración, reajusta el tiempo del segmento anterior a ese momento en lugar de cambiar toda la sincronización posterior.

Transición de Salida

  • Mantén el último estado significativo del producto el tiempo suficiente para que el espectador lo registre.
  • Crea un barrido de cámara hacia la siguiente escena si se solicita.
  • Evita fotogramas en blanco accidentales al final de las grabaciones de pantalla.
  • Extrae un fotograma de prueba en el límite de la transición.

Control de Calidad

  • Verifica el primer fotograma del producto.
  • Verifica cada pico de zoom.
  • Verifica cada estado requerido del producto.
  • Verifica las transiciones de entrada y salida.
  • Confirma que los subtítulos no cubren la interfaz del producto.

Salida

Devuelve:

  • Grabación fuente utilizada.
  • Decisión de recorte/sin recorte.
  • Segmentos recortados/reajustados.
  • Ruta de renderizado.
  • Fotogramas de prueba para el recorte más ajustado y los momentos clave del producto.

Mapa de Momentos del Producto

Crea un mapa de momentos antes de editar:

  • Marca de tiempo de la grabación.
  • Qué es visible.
  • Frase de narración.
  • Marca de tiempo global deseada.
  • Si el cursor es relevante.
  • Si la posición de desplazamiento es relevante.
  • Si los subtítulos se superponen.
  • Si el recorte es seguro.

Usa este mapa para decidir recortes y reajustes de tiempo.

Matriz de Decisión de Recorte

Elige sin recorte cuando:

  • El usuario acepta el lienzo/fondo.
  • Los zooms se mueven por la pantalla.
  • El texto principal se corta con un recorte ajustado.
  • El estado del producto es más importante que la pulcritud.

Elige recorte ligero cuando:

  • El lienzo distrae pero la interfaz de usuario permanece centrada.
  • Los subtítulos necesitan más espacio.
  • El marco del navegador o los márgenes muertos se pueden eliminar de forma segura.

Elige recorte dinámico solo cuando:

  • Cada rectángulo de recorte está mapeado.
  • El movimiento se siente intencionado.
  • Todos los estados clave del producto tienen fotogramas de prueba.

Sincronización de Narración

Sincroniza los estados del producto con las frases habladas:

  • Inicia la transición antes de la frase si el producto debe ser visible en el momento de la frase.
  • Deja que el fotograma final del producto se mantenga después de la frase si la comprensión es importante.
  • Ralentiza el metraje anterior al momento en lugar de acelerar un desplazamiento del producto de forma antinatural.
  • No cortes a mitad de palabra en la narración para alcanzar un estado del producto.

Limpieza de Grabación de Pantalla

Verifica:

  • Visibilidad del cursor.
  • Interfaz del navegador.
  • Ventanas emergentes de notificaciones.
  • Tiempo muerto.
  • Pantallas de carga en blanco.
  • Bordes de escritorio accidentales.
  • Velocidad de desplazamiento.
  • Enfoque del zoom.

Solo elimina u oculta estos elementos si no perjudica la claridad del producto.

Seguridad de Subtítulos

Si los subtítulos están incrustados:

  • Verifica las barras de navegación inferiores.
  • Verifica las tablas del producto.
  • Verifica los botones modales.
  • Verifica los controles de línea de tiempo.
  • Mueve el margen de subtítulos o elige un fotograma de prueba diferente si es necesario.

Puntos de Aprobación del Usuario

Pregunta antes de:

  • Recortar el lienzo visible.
  • Eliminar el cursor.
  • Acelerar drásticamente el metraje.
  • Difuminar o enmascarar detalles del producto.
  • Reemplazar el metraje real con una interfaz de usuario recreada.

Formato de Entrega

Informa:

  • Clip del producto utilizado.
  • Estrategia de recorte.
  • Puntos de recorte.
  • Relaciones de reajuste.
  • Fotogramas de prueba clave.
  • Cualquier interfaz de usuario que permanezca imperfecta por diseño.

Skills relacionados