Communitygithub.com

jonosin/jstack

Enrutador delgado hacia HeyGen HyperFrames: el motor de gráficos en movimiento nativo de HTML (escribe HTML, renderiza MP4 determinista localmente mediante headless Chrome + FFmpeg).

¿Qué es jstack?

HyperFrames (licencia Apache-2.0) transforma composiciones de HTML/CSS/JS en archivos MP4 deterministas ejecutando cada fotograma en Chrome sin interfaz gráfica y codificándolos con FFmpeg. Este skill actúa como un enrutador delgado: todo el conocimiento real reside en el repositorio clonado y sus 20 skills de agente; este skill solo dirige las solicitudes al workflow correcto (como "/motion-graphics" para títulos animados o "/embedded-captions" para subtítulos cinéticos) y nunca duplica documentación upstream. Es compatible con sistemas como Claude Code y Cursor, y se usa invocando "npx hyperframes init" para iniciar un proyecto, luego los comandos "dev"/"check"/"render"/"publish" para editar y renderizar. Útil para superposiciones animadas, títulos cinéticos, tarjetas finales, tercios inferiores o cualquier composición HTML-a-MP4. NO es para video generativo (usar /vidgen) ni para superposiciones estáticas de StayFrame (usar /jstack-sf-caption).

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jonosin/jstack/tree/HEAD/skills/hyperframe

Preguntar en tu IA favorita

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

Documentación

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 bloqueshyperframes.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ónIr 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 hablandoFlujo 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 componentesDirectorios 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 RemotionEl 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 init no 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-depth o recibirás un blob de registro skills.sh desactualizado que va por detrás de main.
  • La telemetría está activada por defecto; desactívala con hyperframes telemetry disable.
  • La salida del renderizado se guarda en renders/[project]_[timestamp].mp4 dentro del directorio del proyecto.

Siguientes skills

SiguienteCuándo
/vidgenLa 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-captionUn 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-stitchUna superposición/tarjeta final de HyperFrames renderizada necesita ensamblarse en un reel de StayFrame.

Skills relacionados