¿Qué hace HyperFrames — empezar 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 seekable, y cuya reproducción de medios es propiedad del framework. El contrato completo de autoría está en /hyperframes-core; léelo antes de escribir HTML de composición.
A continuación: un mapa de capacidades (las habilidades de dominio, cargadas bajo demanda) y el enrutador de intenciones (elige un flujo de trabajo para cualquier solicitud de 'hazme un…' — normalmente un video, pero también una presentación navegable o un puerto de composición). La división es de propiedad, no de tipo de salida: un flujo de trabajo posee un entregable de extremo a extremo (su propio directorio de proyecto, pasos con compuertas, subagentes, artefacto final); una habilidad de dominio es una capa de capacidad que un flujo de trabajo incorpora durante el proceso y nunca es dueña de la tarea.
Mapa de capacidades — las habilidades de dominio
Capacidades atómicas que cargas bajo demanda — no son flujos de trabajo completos; nunca son dueñas de la tarea de extremo a extremo. Para la intención 'hazme un…', usa el enrutador de intenciones a continuación.
| Quieres… | Habilidad |
|---|---|
Crear / editar una composición HTML — el contrato data-*, clips, pistas, subcomposiciones, 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 seek-safe — líneas de tiempo GSAP, keyframes CSS, Anime.js, WAAPI, FLIP, trazados, máscaras, SVG morph/draw, profundidad 3D, más hyperframes keyframes diagnósticos | /hyperframes-keyframes |
Dirección creativa — frame.md / design.md, paletas, tipografía, narración, planificación de ritmos, audio-reactivo | /hyperframes-creative |
| Medios — resolver/generar BGM, SFX, imagen, icono, logo de marca, voz; voz en off TTS, transcripción, eliminación de fondo, subtítulos; reutilización entre proyectos | /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 — activos, tokens, componentes, storyboards → movimiento reconstruido (REST/CLI); Motion (MCP), shaders (fuente MCP / exportación nativa) | /figma |
Enrutamiento de intenciones — elige un flujo de trabajo
Esta sección solo conoce los flujos de trabajo de nivel superior; no carga sus referencias internas ni las habilidades de 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?
- Modo — si la solicitud lleva una señal autónoma continua ('sorpréndeme', 'decide por mí', 'solo constrúyelo'), anótalo y pásalo al flujo de trabajo: toda la ejecución se vuelve autónoma y ningún paso posterior vuelve a preguntar. Sin señal, el flujo de trabajo pregunta el modo como su primera cuestión en el brief. El valor predeterminado es colaborativo. (
/motion-graphicses autónomo por diseño.) Semántica:hyperframes-core→references/brief-contract.md.
Valores predeterminados de especificación — indica, no preguntes (nunca cambian la ruta): aspecto se deriva del destino — feed social (X / LinkedIn / Instagram) → cuadrado 1:1, TikTok / Reels / Shorts → 9:16, YouTube / incrustado / desconocido → 16:9; idioma de narración / subtítulos = el del usuario. El flujo de trabajo elegido reconfirma sus propios detalles en su primer paso (semántica de campo: hyperframes-core → references/brief-contract.md).
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, brief o guion → un anuncio. 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 anuncio. |
/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 → changelog / revelación de funcionalidad / fix / refactor explicativo |
/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 | Una pieza corta (~menos de 10s), sin narración, donde el movimiento es el mensaje — tipo cinético, un impacto de gráfico, un sting de logo, un mapa animado, un tweet / titular animado, un tercio inferior / superposición independiente (MP4 o alfa transparente) |
/music-to-video | Una pista de música → un video sincronizado al ritmo — lyric video, presentación de diapositivas o anuncio 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 / presentación interactiva — diapositivas discretas, fragmentos, ramificaciones, hotspots; 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 / 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 es 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 guion — pregunta una cosa: ¿el sitio está vendiendo un producto? Sí (SaaS / app / sitio de producto / empresa) →
/product-launch-video— un anuncio, 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 cual (portafolio / blog / docs / personal / evento) →/website-to-video— un recorrido. Un enlace de un PR de GitHub →/pr-to-video; un concepto sin producto ni sitio →/faceless-explainer. - Metraje existente — subtítulos de palabras habladas simples →
/embedded-captions; tarjetas de superposición diseñadas →/talking-head-recut. Ninguno edita el metraje en sí (remezcla de tiempo / recolor / reencuadre / reorden / audio es edición NLE — fuera del alcance). - Una pista de música es la entrada (un archivo de audio, o un video del que extraer audio) con sin narración →
/music-to-video— los ritmos/energía de la música marcan el ritmo. (Las piezas narradas se quedan con el flujo de trabajo emparejado por entrada arriba;/motion-graphicses para movimiento corto sin narración que no está impulsado por música.) - Una presentación / pitch deck / presentación interactiva (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 desencadenador adyacente ('deck / slides / presentation / convert this page') hace que/slideshowconfirme que es una presentación de diapositivas antes de crear, y cambie al flujo de trabajo no diapositivas apropiado si no. - 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 es claramente más larga que ~3 min, o es un formato estático / bucle / personalizado.
Después de elegir — garantiza que el flujo de trabajo esté instalado
Una vez que hayas elegido un flujo de trabajo, ejecuta el paso de actualización antes de leer su habilidad — las habilidades de los flujos de trabajo se instalan bajo demanda, por lo que el que seleccionaste puede no estar en esta máquina todavía (sus frases desencadenantes viven en este enrutador precisamente para que puedas enrutar a habilidades que no están instaladas):
npx hyperframes skills update <nombre-del-flujo-de-trabajo>
Nombre simple, sin / inicial — ej. npx hyperframes skills update pr-to-video. Nombrar una habilidad garantiza que ella más las habilidades de dominio centrales de las que depende cada flujo de trabajo estén instaladas y actualizadas: un no-op rápido cuando todo ya lo está, una instalación dirigida solo de las habilidades faltantes/obsoletas cuando no — nunca el conjunto completo. Luego lee la habilidad del flujo de trabajo y continúa. El mismo comando funciona para una habilidad de dominio bajo demanda del mapa de capacidades (ej. npx hyperframes skills update figma).
Si el comando falla, muestra su error al usuario en lugar de improvisar el flujo de trabajo desde la memoria. Alternativa manual (sin CLI de HyperFrames disponible): npx skills add heygen-com/hyperframes --skill <nombre-del-flujo-de-trabajo>; todo a la vez: npx skills add heygen-com/hyperframes --all.
Mantener las habilidades actualizadas
Las habilidades de HyperFrames tienen versiones y se instalan perezosamente: el conjunto central con avidez, los flujos de trabajo en el primer uso.
- Conjunto central — este enrutador, las habilidades de dominio
hyperframes-*ymedia-use.npx hyperframes init(que cada flujo de trabajo de creación ejecuta al andamiar) verifica GitHub y actualiza el conjunto central más cualquier otra cosa ya instalada. Nunca expande la instalación — las habilidades de flujo de trabajo que no has usado no se descargan. Volver a ejecutar init en una máquina actualizada es un no-op; fuera de línea (o con límite de tasa) degrada con gracia y nunca falla de forma grave. La bandera--skip-skillsestá actualmente neutralizada (una medida temporal mientras el registro skills.sh se pone al día); CI/tests optan por no participar mediante la variable de entornoHYPERFRAMES_SKIP_SKILLS=1. - Habilidades de flujo de trabajo — instaladas y actualizadas en el momento del desencadenamiento por el paso de actualización anterior (
skills update <nombre-del-flujo-de-trabajo>).
Si una tarea se comporta inesperadamente, o antes de una construcció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 instalado está desactualizado o el conjunto central está incompleto — las habilidades de flujo de trabajo aún no instaladas se informan como disponibles bajo demanda, no como un fallo). - Actualizar:
npx hyperframes skills update— actualiza el conjunto central más todo lo instalado a la última versión y elimina habilidades que ya no se publican. Sin nombres, nunca instala flujos de trabajo que no hayas usado; nombrar habilidades (skills update <nombre…>) adicionalmente instala esas. - Conjunto completo, explícitamente:
npx hyperframes skills(onpx skills add heygen-com/hyperframes --all).
El 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 está comercializando — (a) una URL del producto (rastreada con Chrome sin cabeza para activos + tokens de marca), (b) un guion / brief que nombra el sitio del producto incluso sin un enlace (PLV lo resuelve + lo rastrea, a menos que el usuario opte por no participar), o (c) un guion sin sitio derivable / 'no raspar' (modo sin captura — elige un preset de estilo que proporciona paleta + sistema de diseño). Un guion proporcionado puede ser la voz en off textual o reestructurada por escena — PLV pregunta.
- Salida: un anuncio 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. - Desencadenadores: 'video de lanzamiento para X', 'anuncio para nuestro sitio', 'explica mi SaaS en un minuto', 'convierte mi guion en un anuncio 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 explícitamente quiere un recorrido de un sitio tal cual. Capturado con Chrome sin cabeza para capturas de pantalla reales + activos de marca. Si la …
[truncado para traducción]