Communitygithub.com

HyperFrames — empezar aquí

Procesa cualquier solicitud de creación, edición, animación o renderizado de video, animación o gráfico en movimiento — un anuncio, explicación, clip con subtítulos, tarjeta de título, superposición, presentación interactiva o cualquier composición. HyperFrames renderiza video desde HTML; esta es la habilidad de entrada y la forma predeterminada en que un agente crea o edita video.

¿Qué es HyperFrames — empezar aquí?

HyperFrames es un framework de código abierto que permite a agentes de IA (como Claude Code, Cursor y Codex) crear y editar videos renderizándolos desde HTML. La composición se define en un archivo HTML cuyos elementos del DOM declaran temporización mediante atributos `data-*`, y la animación se vuelve seekable y controlable por el framework. Esta habilidad principal (`feishu-pi-bridge`) es el punto de entrada: un enrutador de intenciones que dirige cualquier solicitud de 'hazme un video', animación o gráfico en movimiento al flujo de trabajo especializado correcto (por ejemplo, video de lanzamiento de producto, explicación sin rostro, video a partir de sitio web, gráficos en movimiento, presentación interactiva). También mapea las habilidades de dominio de HyperFrames (como `/hyperframes-core` para la autoría, `/hyperframes-animation` para la animación, `/hyperframes-creative` para la dirección creativa) que se cargan bajo demanda, nunca son dueñas de la tarea completa, pero proporcionan capacidades atómicas. El enrutador garantiza que el flujo de trabajo elegido esté instalado (con `npx hyperframes skills update`) y luego delega al flujo de trabajo, que se encarga de principio a fin: su propio directorio de proyecto, pasos con compuertas, subagentes y artefacto final. Es una herramienta esencial para agentes que necesitan producir contenido de video de alta calidad con flujos de trabajo predecibles y repetibles.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/childelins/feishu-pi-bridge/tree/HEAD/pi/agent/skills/hyperframes

Preguntar en tu IA favorita

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

Documentación

¿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-graphics es 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-videoVender 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-videoMostrar 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-explainerExplicar un tema / concepto a partir de texto — sin producto, sin URL; cada visual es inventado por el LLM
/pr-to-videoUn PR de GitHub / cambio de código → changelog / revelación de funcionalidad / fix / refactor explicativo
/embedded-captionsAgregar subtítulos / leyendas a un video existente de una persona hablando (metraje intacto)
/talking-head-recutEmpaquetar 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-graphicsUna 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-videoUna 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)
/slideshowUna presentación / pitch deck / presentación interactiva — diapositivas discretas, fragmentos, ramificaciones, hotspots; la salida es un deck navegable, no un video renderizado
/general-videoCualquier otra cosa — piezas más largas o de múltiples escenas, un bucle / póster estático, una composición personalizada
/remotion-to-hyperframesMigrar 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-graphics es 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 /slideshow confirme 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-video solo 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-* y media-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-skills está 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 entorno HYPERFRAMES_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 --json para 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 (o npx 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]

Skills relacionados