HyperFrames, empieza aquí
HyperFrames renderiza video desde HTML: una composición es un archivo HTML cuyo DOM declara la temporización con atributos data-*, cuyo tiempo de ejecución de la animación es buscable, y cuya reproducción de medios es propiedad del framework. El contrato completo de autoría reside 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 "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 tiempo de ejecución (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, rutas, máscaras, morph/dibujo SVG, profundidad 3D, más diagnósticos hyperframes keyframes | /hyperframes-keyframes |
Dirección creativa: frame.md / design.md, paletas, tipografía, narración, planificación de ritmo, 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, doctor | /hyperframes-cli |
Instalar bloques / componentes del registro (hyperframes add) | /hyperframes-registry |
| Importar contenido de Figma: assets, tokens, componentes, storyboards→animatics (REST/CLI); Motion, shaders (MCP) | /figma |
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 entrar en 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 / brief), 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, indícalos, 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.
Guía rápida de flujos de trabajo
| Flujo de trabajo | Úsalo para |
|---|---|
/product-launch-video | Vender un producto (SaaS, app, sitio de empresa / producto). Desde una URL, brief o guión → un promocional. El predeterminado para cualquier URL comercial, incluso si el sitio solo se menciona. |
/website-to-video | Mostrar un sitio en sí mismo: un tour / showcase 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 tour, no un promocional. |
/faceless-explainer | Explicar un tema / concepto a partir de texto, sin producto, sin URL; cada visual es inventado por el LLM |
/pr-to-video | Un PR de GitHub / cambio de código → explicador de changelog / revelación de funcionalidad / corrección / refactorización |
/embedded-captions | Agregar subtítulos / leyendas a un video existente de una persona hablando (metraje sin modificar) |
/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, centrado en 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 al ritmo, video lírico, presentación de diapositivas o promocional cinético; la música marca 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, ramificaciones, puntos interactivos; la salida es un deck navegable, no un video renderizado |
/general-video | Cualquier otra cosa: piezas más largas o de múltiples escenas, un bucle estático / póster, 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 predeterminado para cualquier URL comercial incluso si el sitio solo se menciona. No, o el usuario solo quiere mostrar el sitio tal cual (portafolio / blog / docs / personal / evento) →/website-to-video: un tour. Un enlace de PR de GitHub →/pr-to-video; un concepto sin producto ni sitio →/faceless-explainer. - Metraje existente: subtítulos simples de palabra hablada →
/embedded-captions; tarjetas de superposición diseñadas →/talking-head-recut. Ninguno edita el metraje en sí (re-temporización / recolor / reencuadre / reordenación / audio es edición NLE, fuera del alcance). - Una pista de música es la entrada (un archivo de audio, o un video del cual extraer audio) con sin narración →
/music-to-video: los ritmos/energía de la música marcan 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 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>(ej.--skill pr-to-video: nombre simple, sin/inicial). - Todos los flujos de trabajo a la vez:
npx skills add heygen-com/hyperframes --all(core + 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 tanto, 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 de ida y vuelta rápido a GitHub; sin conexión (o con límite de tasa) recurre a la instalación después de un tiempo de espera breve, por lo que init nunca falla por un problema de red. Los flujos de trabajo de creación inician con init, por lo que comenzar un nuevo proyecto siempre ejecuta esta verificación y extrae nuestras últimas habilidades de GitHub cuando están obsoletas. La bandera --skip-skills actualmente está desactivada (una medida temporal mientras el registro 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 de manera inesperada, 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 no cero cuando algo está desactualizado o falta). - Actualizar:
npx hyperframes skills update: extrae el conjunto completo a la última versión, instalando cualquier habilidad aún no presente (igual que el paso de instalación de init).
La CLI también muestra un recordatorio de una línea cuando una ejecución de render / lint / validate detecta habilidades obsoletas.
Detalles de los flujos de trabajo
/product-launch-video
- Entrada: Un producto que se comercializa, (a) una URL del producto (explorada con Chrome sin interfaz gráfica para activos + tokens de marca), (b) un guión / brief que mencione el sitio del producto incluso sin un enlace (PLV lo resuelve + lo explora, a menos que el usuario opte por no hacerlo), o (c) un guión sin sitio derivable / "no raspes" (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 reestructurada por escena. PLV pregunta.
- Salida: un promocional de lanzamiento de producto / SaaS como composición de HyperFrames → MP4 (punto óptimo 30-90s). El valor del producto es el tema, no un recorrido del sitio. Para un simple tour 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 tour de un sitio tal cual. Capturado con Chrome sin interfaz gráfica 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 tour / showcase / clip social del sitio construido a partir de los propios visuales del sitio → MP4.
- Desencadenantes: "convierte este sitio web en un video", "tour del sitio desde ", "clip social de nuestra página de inicio", "solo tengo una URL, haz algo".
/faceless-explainer
- Entrada: Texto arbitrario. Un tema, artículo o notas, que se explican, sin producto que se comercialice ni sitio que capturar. (Bifurcado de
/product-launch-video; sin Chrome sin interfaz gráfica). - Salida: explicador sin rostro → MP4, cada visual inventado por el 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#No "este PR". Leído a través de la CLIgh(no un sitio para raspar). - Salida: explicador de cambio de código (changelog / revelación de funcionalidad / corrección / refactorización) → MP4, destacados de diff, antes/después, árbol de archivos + escenas de impacto. ≤ (punto óptimo 30-90s).
- Desencadenantes: "haz un video sobre este PR", "convierte PR #1187 en un video de changelog", "video de notas de 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 brief. Transcrito localmente (Whisper, sin clave API) y enmascarado (RVM) para que el sujeto pueda ocultar los subtítulos.
- Salida: el mismo metraje sin modificar, con una capa de subtítulos, Estándar (riel de tercio inferior textual + 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 / podcast (MP4) para empaquetar con gráficos en pantalla, metraje real. Transcrito localmente (Whisper). El clip se reproduce completo debajo, sin modificar.
- 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