hyperframe — enrutador hacia HeyGen HyperFrames
HyperFrames (Apache-2.0, github.com/heygen-com/hyperframes) convierte composiciones HTML/CSS/JS en archivos MP4 deterministas: el renderizador busca cada fotograma en Chrome sin interfaz gráfica y codifica con FFmpeg. Este skill es un ENRUTADOR DELGADO — todo el conocimiento real vive en el repositorio clonado y sus propios 20 skills de agente; nunca dupliques documentación upstream aquí.
Rutas locales
Resolución: variable de entorno HYPERFRAMES_HOME → ~/.jstack/config.env → valor por defecto abajo.
| Qué | Dónde |
|---|---|
| Repositorio clonado (copia local canónica) | ~/.jstack/vendor/hyperframes |
| Skill de enrutador upstream (LEE PRIMERO para cualquier solicitud de "hazme un video") | ~/.jstack/vendor/hyperframes/skills/hyperframes/SKILL.md |
Sus 20 skills de agente (también instalados en ~/.claude/skills/ + ~/.agents/skills/ por hyperframes init) | ~/.jstack/vendor/hyperframes/skills/ |
Registro de bloques/componentes (más de 70 bloques: tercios inferiores lt-*, code-*, logo-outro, glitch, data-chart…) | ~/.jstack/vendor/hyperframes/registry/{blocks,components} |
| Fuente de documentación (Inicio rápido, conceptos, referencia, catálogo) | ~/.jstack/vendor/hyperframes/docs/ |
| En línea: docs + catálogo de bloques | hyperframes.heygen.com (Inicio rápido/Docs/Catálogo), hyperframes.dev (área de juegos + plantillas de diseño) |
Instalación / verificación de estado
Requisitos: Node 22+ y FFmpeg en PATH (verificado funcionando en esta máquina, CLI v0.7.48).
npx --yes hyperframes doctor # verificación de estado del entorno
npx --yes hyperframes init my-video # crear un proyecto (también instala/actualiza sus skills de agente)
cd my-video && npm run render # → renders/*.mp4
init crea index.html + hyperframes.json y fija la versión de CLI en los scripts de package.json
(dev/check/render/publish). Actualiza el clon con
git -C ~/.jstack/vendor/hyperframes pull.
Tabla de despacho
Enruta la intención, luego ABRE/EJECUTA el destino upstream — no improvises un flujo de trabajo.
| Intención | Ir a |
|---|---|
| Cualquier solicitud de "hazme un video/animación" (punto de entrada) | Lee el skill de enrutador /hyperframes: ~/.jstack/vendor/hyperframes/skills/hyperframes/SKILL.md — elige el flujo de trabajo |
| Texto de gancho animado / títulos cinéticos / impacto de estadística / logo sting / tarjeta final / tercio inferior (cortos, sin narración, guiados por diseño) | Flujo de trabajo /motion-graphics: skills/motion-graphics/ en el clon; bloques de tercio inferior = registro lt-*, tarjeta final = logo-outro |
| Subtítulos cinéticos / subtítulos en un video existente de una persona hablando | Flujo de trabajo /embedded-captions: skills/embedded-captions/ (metraje intacto, subtítulos renderizados sobre él) |
Crear o editar una composición HTML→MP4 (el contrato de tiempo data-*, clips, pistas) | /hyperframes-core luego /hyperframes-animation: skills/hyperframes-core/, skills/hyperframes-animation/ |
| Navegar / instalar bloques y componentes | Directorios de registro registry/{blocks,components} o hyperframes.heygen.com/catalog; instala y conecta mediante /hyperframes-registry y npx hyperframes add [block] |
| Renderizar / previsualizar / lint / validar una composición | /hyperframes-cli: npx hyperframes preview, npx hyperframes lint && npx hyperframes validate, npx hyperframes render, npx hyperframes doctor |
| BGM / SFX / voz en off / iconos / eliminación de fondo para una composición | /media-use: skills/media-use/ |
| Deck / presentación de diapositivas, promoción de producto, PR-a-video, sincronizado con música, tour de sitio web, puerto de Remotion | El skill de flujo de trabajo correspondiente en skills/ (consulta la hoja de trucos del enrutador /hyperframes) |
Cuándo NO usar (línea roja de StayFrame)
La estrella del norte estética de StayFrame (ADR 0002, minimalismo editorial — "¿pasaría desapercibido esto en la cuadrícula de Aman/Soneva?") hace que los estilos de gráficos en movimiento pesados estén FUERA DE MARCA: subtítulos cinéticos al estilo Hormozi, bloques glitch/VFX, tickers de noticias, widgets de vidrio líquido. Para los reels de StayFrame usa HyperFrames solo para superposiciones SUTILES y mínimas, y:
- Las superposiciones de texto estático permanecen en el carril existente — Chrome sin interfaz gráfica + ffmpeg mediante
/jstack-sf-caption. No migres eso a HyperFrames. - El video generativo (i2v/t2v) nunca es HyperFrames — eso es
/vidgen.
Advertencias
hyperframes initno tiene bandera--yes(da error con banderas desconocidas); ya es no interactivo.- Efecto secundario de
init: instala/actualiza los skills centrales propios de HyperFrames en~/.claude/skills/y~/.agents/skills/— esperado, mantiene actualizado el enrutador upstream. - Instalación de skills de forma independiente:
npx skills add heygen-com/hyperframes --full-depth— mantén--full-deptho recibirás un blob de registro skills.sh desactualizado que va por detrás demain. - La telemetría está activada por defecto; desactívala con
hyperframes telemetry disable. - La salida del renderizado se guarda en
renders/[project]_[timestamp].mp4dentro del directorio del proyecto.
Siguientes skills
| Siguiente | Cuándo |
|---|---|
/vidgen | La composición necesita metraje generado (clips i2v/t2v) como material de origen — la generación de video siempre se enruta allí, nunca directamente a un backend. |
/jstack-sf-caption | Un reel de StayFrame necesita superposiciones de texto estático simples — ese carril permanece en Chrome sin interfaz gráfica + ffmpeg, no en HyperFrames. |
/jstack-sf-trim-stitch | Una superposición/tarjeta final de HyperFrames renderizada necesita ensamblarse en un reel de StayFrame. |