HyperFrames — comienza aquí
HyperFrames renderiza video desde HTML — una composición es un archivo HTML cuyo DOM declara la temporización con atributos data-*, cuyo runtime de animación es reproducible, y cuya reproducción multimedia es propiedad del framework. El contrato de autoría completo está en /hyperframes-core; léelo antes de escribir HTML de composición.
A continuación: un mapa de capacidades (las habilidades del dominio, cargadas bajo demanda) y el enrutador de intenciones (elige un flujo de trabajo para cualquier solicitud de "hazme un video").
Mapa de capacidades — las habilidades del dominio
Capacidades atómicas que cargas bajo demanda — no son flujos de trabajo completos de video. Para "hazme un video", usa el enrutador de intenciones a continuación.
| Quieres… | Habilidad |
|---|---|
Crear / editar una composición HTML — el contrato data-*, clips, pistas, sub-composiciones, variables | /hyperframes-core |
| Animar — movimiento atómico, planos de escena, transiciones, adaptadores de runtime (GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU) | /hyperframes-animation |
Crear keyframes seguros para búsqueda — líneas de tiempo GSAP, keyframes CSS, Anime.js, WAAPI, FLIP, trazados, máscaras, SVG morph/dibujo, profundidad 3D, más hyperframes keyframes diagnóstico | /hyperframes-keyframes |
Dirección creativa — frame.md / design.md, paletas, tipografía, narración, planificación de ritmos, audio-reactivo | /hyperframes-creative |
| Medios — voz en off TTS, música de fondo, transcripción, eliminación de fondo, subtítulos | /hyperframes-media |
Resolución de medios — encontrar + congelar BGM, SFX, imágenes, iconos del catálogo de HeyGen en .media/ con seguimiento de manifiesto | /media-use |
| Bucle de desarrollo CLI — init, lint, validar, inspeccionar, previsualizar, renderizar, publicar, diagnosticar | /hyperframes-cli |
Instalar bloques / componentes del registro (hyperframes add) | /hyperframes-registry |
Enrutamiento de intenciones — elige un flujo de trabajo
Esta sección solo conoce los flujos de trabajo de alto nivel; no carga sus referencias internas ni las habilidades del dominio anteriores.
Antes de enrutar — confirma la entrada, no la especificación
El enrutamiento necesita saber de qué trata el video — su entrada y tema. Si eso no está especificado ("haz un video sobre nuestra cosa" sin URL, producto, tema o activo), pregunta antes de ingresar a cualquier flujo de trabajo — comprometerse con un flujo de trabajo ES la decisión de enrutamiento. Como máximo dos preguntas:
- Entrada — un producto (URL / resumen), un sitio web general, un PR de GitHub, un tema para explicar, o un video existente de una persona hablando?
Valores predeterminados de especificación — indica, no preguntes (nunca cambian la ruta): relación de aspecto 16:9 (usa 9:16 solo para un destino vertical nombrado — TikTok / Reels / Shorts); idioma de narración / subtítulos = el del usuario. El flujo de trabajo elegido reconfirma sus propios detalles en su primer paso.
Hoja de referencia de flujos de trabajo
| Flujo de trabajo | Úsalo para |
|---|---|
/product-launch-video | Vender un producto (SaaS, app, sitio de empresa / producto) — desde una URL, resumen o guión → un promocional. El valor predeterminado para cualquier URL comercial, incluso si solo se nombra el sitio. |
/website-to-video | Mostrar un sitio en sí mismo — un recorrido / demostración construido a partir de las propias capturas de pantalla del sitio. Para sitios no comerciales (portafolio, blog, docs, personal, evento), o cuando el usuario quiere un recorrido, no un promocional. |
/faceless-explainer | Explicar un tema / concepto a partir de texto — sin producto, sin URL; cada visual es inventado por LLM |
/pr-to-video | Un PR de GitHub / cambio de código → explicador de registro de cambios / revelación de funcionalidad / corrección / refactorización |
/embedded-captions | Agregar subtítulos / leyendas a un video existente de una persona hablando (metraje intacto) |
/talking-head-recut | Empaquetar un video existente de una persona hablando con superposiciones gráficas diseñadas — tercios inferiores, llamadas de datos, títulos cinéticos, citas destacadas |
/motion-graphics | Un gráfico en movimiento corto, sin narración, liderado por el diseño — tipografía cinética, un impacto de estadística / gráfico, un sting de logotipo, una superposición de tercio inferior |
/music-to-video | Una pista de música → un video sincronizado con el ritmo — video lírico, presentación de diapositivas o promocional cinético; la música impulsa el ritmo (imágenes / videos opcionales del usuario cortados en la cuadrícula de ritmo) |
/slideshow | Una presentación / pitch deck / deck interactivo — diapositivas discretas, fragmentos, ramificación, hotspots; la salida es un deck navegable, no un video renderizado |
/general-video | Cualquier otra cosa — piezas más largas o de varias escenas, un bucle / póster estático, una composición personalizada |
/remotion-to-hyperframes | Migrar una composición existente de Remotion (React) a HyperFrames (migración, no creación) |
Desambiguación (solo donde sea confuso):
- Prioridad de movimiento y sin narración (menos de ~10s, el movimiento es el mensaje) →
/motion-graphics, independientemente de la entrada. - Una URL o guión — pregunta una cosa: ¿el sitio vende un producto? Sí (SaaS / app / producto / sitio de empresa) →
/product-launch-video— un promocional, y el valor predeterminado para cualquier URL comercial incluso si solo se nombra el sitio. No, o el usuario solo quiere mostrar el sitio tal como está (portafolio / blog / docs / personal / evento) →/website-to-video— un recorrido. Un enlace de PR de GitHub →/pr-to-video; un concepto sin producto ni sitio →/faceless-explainer. - Metraje existente — subtítulos simples de palabras habladas →
/embedded-captions; tarjetas de superposición diseñadas →/talking-head-recut. Ninguno edita el metraje en sí (re-temporización / recolorear / reencuadrar / reordenar / audio es edición NLE — fuera del alcance). - Una pista de música es la entrada (un archivo de audio, o un video para extraer audio) con sin narración →
/music-to-video— los ritmos/energía de la música impulsan el ritmo. (Las piezas narradas permanecen con el flujo de trabajo coincidente con la entrada anterior;/motion-graphicses para movimiento corto sin narración que no está impulsado por música). - Una presentación / pitch deck / deck interactivo (diapositivas discretas, navegación, modo presentador) →
/slideshow— la salida es un deck navegable, no un video renderizado. Una solicitud explícita de "presentación de diapositivas" procede directamente; un desencadenante adyacente ("deck / diapositivas / presentación / convertir esta página") hace que/slideshowconfirme que es una presentación de diapositivas antes de crear, y cambie al flujo de trabajo no de presentación de diapositivas apropiado si no lo es. - La duración es una guía, no una barrera — la intención elige el flujo de trabajo; ve a
/general-videosolo cuando la pieza sea claramente más larga de ~3 min, o sea un formato estático / bucle / personalizado.
Si el flujo de trabajo coincidente no está instalado
Una vez que hayas elegido un flujo de trabajo, verifica que esté realmente disponible para ti. Si la habilidad del flujo de trabajo coincidente no está instalada, no recurras a adivinar — dile al usuario que la instale primero:
- Solo este flujo de trabajo:
npx skills add heygen-com/hyperframes --skill <nombre-del-flujo-de-trabajo>(por ejemplo--skill pr-to-video— nombre simple, sin/inicial). - Todos los flujos de trabajo a la vez:
npx skills add heygen-com/hyperframes --all(núcleo + cada flujo de trabajo, omite el selector).
Después de que lo ejecuten, vuelve a leer la habilidad del flujo de trabajo y continúa.
Mantener las habilidades actualizadas
Las habilidades de HyperFrames tienen versiones. npx hyperframes init verifica las habilidades instaladas contra las últimas en GitHub e instala/actualiza el conjunto completo cada vez que algo está desactualizado o falta — por lo que un proyecto recién inicializado siempre tiene el conjunto completo y más reciente (y volver a ejecutar init en un proyecto actualizado no hace nada). La verificación es un viaje rápido de ida y vuelta a GitHub; sin conexión (o con límite de velocidad) recurre a la instalación después de un breve tiempo de espera, por lo que init nunca falla por un problema de red. Los flujos de trabajo de creación se inicializan con init, por lo que comenzar un nuevo proyecto siempre ejecuta esta verificación y obtiene nuestras últimas habilidades de GitHub cuando están desactualizadas. La bandera --skip-skills está actualmente neutralizada (una medida temporal mientras el registro de skills.sh se pone al día): pasarla ya no omite la verificación, por lo que cada init verifica GitHub. CI/pruebas optan por no participar mediante la variable de entorno HYPERFRAMES_SKIP_SKILLS=1.
Si una tarea se comporta inesperadamente, o antes de una compilación larga, confirma que las habilidades instaladas estén actualizadas:
- Verificar:
npx hyperframes skills check(agrega--jsonpara un veredicto legible por máquina; sale con código distinto de cero cuando algo está desactualizado o falta). - Actualizar:
npx hyperframes skills update— obtiene el conjunto completo más reciente, instalando cualquier que aún no esté presente (igual que el paso de instalación de init).
El CLI también muestra un recordatorio de una línea cuando una ejecución de render / lint / validate detecta habilidades obsoletas.
Detalles del flujo de trabajo
/product-launch-video
- Entrada: Un producto que se comercializa — (a) una URL del producto (rastreada con Chrome sin cabeza para activos + tokens de marca), (b) un guión / resumen que nombra el sitio del producto incluso sin un enlace (PLV resuelve + lo rastrea, a menos que el usuario opte por no hacerlo), o (c) un guión sin sitio derivable / "no raspar" (modo sin captura — elige un preset de estilo que proporcione paleta + sistema de diseño). Un guión proporcionado puede ser la voz en off textual o reestructurado por escena — PLV pregunta.
- Salida: un promocional de lanzamiento de producto / SaaS como una composición de HyperFrames → MP4 (punto óptimo 30–90s) — el valor del producto es el tema, no un recorrido del sitio. Para un recorrido simple del sitio, usa
/website-to-video. - Desencadenantes: "video de lanzamiento para X", "promocional para nuestro sitio", "explica mi SaaS en un minuto", "convierte mi guión en un promocional de 60s", "video de lanzamiento solo texto, no raspes".
/website-to-video
- Entrada: Un sitio web / URL cuyo objetivo es mostrar el sitio en sí mismo, no vender un producto. Mejor para sitios no comerciales (portafolio, blog, docs, personal, evento), o cuando el usuario quiere explícitamente un recorrido de un sitio tal como está. Capturado con Chrome sin cabeza para capturas de pantalla reales + activos de marca. Si el sitio vende algo y el usuario quiere un promocional, usa
/product-launch-video. - Salida: un recorrido del sitio / demostración / clip social construido a partir de los propios visuales del sitio → MP4.
- Desencadenantes: "convierte este sitio web en un video", "recorrido del sitio desde ", "clip social desde nuestra página de inicio", "solo tengo una URL — haz algo".
/faceless-explainer
- Entrada: Texto arbitrario — un tema, artículo o notas — que se está explicando, sin producto que se comercialice ni sitio que capturar. (Bifurcado de
/product-launch-video; sin Chrome sin cabeza). - Salida: explicador sin rostro → MP4, cada visual inventado por LLM por escena (tipografía / abstracto / diagrama / visualización de datos); incluye el preset
pin-and-paper. (punto óptimo 30–90s). - Desencadenantes: "explicador sin rostro sobre X", "explica cómo funciona DNS como un video", "convierte este artículo en un explicador", "explicador a partir de mis notas".
/pr-to-video
- Entrada: Un pull request de GitHub — una URL de PR, una referencia
owner/repo#N, o "este PR" — leído a través del CLIgh(no un sitio para raspar). - Salida: explicador de cambios de código (registro de cambios / revelación de funcionalidad / corrección / refactorización) → MP4 — aspectos destacados del diff, antes/después, árbol de archivos + escenas de impacto. ≤ (punto óptimo 30–90s).
- Desencadenantes: "haz un video sobre este PR", "convierte el PR #1187 en un video de registro de cambios", "video de notas de la versión desde github.com/org/repo/pull/123".
/embedded-captions
- Entrada: Un video existente de una persona hablando (MP4) para subtitular — metraje real, no una URL o resumen. Transcrito localmente (Whisper, sin clave API) y enmascarado (RVM) para que el sujeto pueda ocultar los subtítulos.
- Salida: el mismo metraje intacto, con una capa de subtítulos — Estándar (riel textual de tercio inferior + un clímax incrustado detrás del sujeto) o Cinematográfico (cada subtítulo compuesto detrás del sujeto). Cualquier duración.
- Desencadenantes: "agrega subtítulos / leyendas a este video", "subtítulos detrás del sujeto", "subtítulos cinematográficos para mi clip".
/talking-head-recut
- Entrada: Un video existente de una persona hablando / entrevista / pódcast (MP4) para empaquetar con gráficos en pantalla — metraje real. Transcrito localmente (Whisper). El clip se reproduce en su totalidad debajo, intacto.
- Salida: el mismo metraje con tarjetas de superposición gráfica temporizadas — títulos cinéticos, tercios inferiores, llamadas de datos, citas destacadas, paneles laterales, imagen en imagen — sincronizadas con la transcripción. Cualquier duración.
- Desencadenantes: "empaqueta este video", "agrega superposiciones gráficas / tercios inferiores / llamadas de datos a mi charla", "convierte esta entrevista en un video con paquete gráfico".