Communitygithub.com

kyirexy/6 — HiperFrames: Léame primero

Punto de entrada para cualquier solicitud de video, animación o composición HTML en HyperFrames. Lee esto primero antes que cualquier otra skill de video o animación.

¿Qué es 6 — HiperFrames: Léame primero?

HiperFrames es un ecosistema modular de skills para autoría y renderizado de videos a partir de código HTML. Esta skill central (kyirexy/6) actúa como mapa de capacidades y enrutador: orquesta la selección de las skills Hoverframes-* apropiadas según el tipo de entrada (URL, PR de GitHub, tema, video existente) y la duración deseada (≤3 min, tutorial de 3-5 min, o inmersión de 5+ min). A diferencia de editores NLE o herramientas de captura de pantalla, Hoverframes funciona de manera determinista y autónoma: todos los valores, activos y texto se fijan en tiempo de autoría, y la renderización no realiza llamadas de red ni usa Date.now()/Math.random(). Las capacidades cubren: creación de videos a partir de URL de producto, sitio web, cambios de código, explicaciones sin rostro; superposición de subtítulos/gráficos sobre clips existentes; y animaciones cortas sin narración. Para tareas fuera de alcance (editar la secuencia de video en sí, capturar sesiones de navegador o generar avatares parlantes) la skill rechaza la solicitud o la redirige a la herramienta adecuada.

Compatible con✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/kyirexy/6/tree/HEAD/.agents/skills/hyperframes

Preguntar en tu IA favorita

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

Documentación

HyperFrames — léeme primero

Empieza aquí para cualquier tarea de HyperFrames — especialmente si no hay un archivo de configuración del agente del proyecto (CLAUDE.md / AGENTS.md / .cursorrules). Mapa de capacidades + enrutador de videos a continuación.

Mapa de capacidades — qué skill usar para cada intención

Qué quieres hacer…Ve a
Hacer un video (desde una URL, resumen, tema, PR de GitHub, metraje existente o un solo elemento para animar)el enrutador de videos de abajo (§ Enrutamiento de videos)
Autor / editar una composición HTML — el contrato data-*, clips, pistas, subcomposiciones, variables/hyperframes-core
Animar — reglas de movimiento atómico, planos de escena, transiciones, adaptadores de tiempo de ejecución (GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU)/hyperframes-animation
Dirección creativa — design.md, paletas, tipografía, narración, planificación de compases, audio-reactivo/hyperframes-creative
Preprocesamiento de medios — voz en off TTS, música de fondo, transcripción, eliminación de fondos, subtítulos/hyperframes-media
Bucle de desarrollo CLI — init, lint, validar, inspeccionar, previsualizar, renderizar, publicar, doctor/hyperframes-cli
Instalar bloques / componentes del registro (hyperframes add)/hyperframes-registry

El contrato de autoría de composiciones (cada elemento temporizado necesita data-start / data-duration / data-track-index; los elementos temporizados necesitan class="clip"; las líneas de tiempo de GSAP están pausadas y registradas en window.__timelines; solo lógica determinista — no Date.now() / Math.random() / red) no se duplica aquí — está en /hyperframes-core. Léelo antes de escribir HTML de composición.

Lo que HyperFrames no puede hacer — verifica esto primero

HyperFrames autoriza una composición HTML y la renderiza a MP4 desde código. Ese modelo tiene límites duros. Una solicitud que rebase uno de ellos no es una elección de ruta, sino que está fuera de alcance, así que recházala (o señala la herramienta correcta) en lugar de intentar un flujo de trabajo. Estos límites se derivan de la arquitectura, no de ninguna solicitud en particular:

  • El renderizado es determinista y autónomo. Cada valor, activo y fragmento de texto se incorpora cuando autorías; el renderizado no hace ninguna llamada de red ni extracción de datos en vivo en tiempo de ejecución (regla central: no Date.now() / Math.random() / red). "Actualizar los números en vivo al renderizar" está fuera de alcance — obtén los datos una vez en tiempo de autoría e incrústalos, o rechaza.
  • El video existente se superpone, nunca se edita. HyperFrames compone fotogramas sobre un clip fuente — /embedded-captions añade una capa de subtítulos, /graphic-overlays añade tarjetas gráficas diseñadas (tercios inferiores, llamadas de datos, títulos) — y el clip se reproduce sin cambios debajo, pero ninguno posprocesa el flujo de video codificado. Cambiar el metraje en sí mismo (su tiempo, color, encuadre, orden o audio) es edición estilo NLE y está fuera de alcance.
  • La importación de Remotion es unidireccional. /remotion-to-hyperframes traduce el código fuente del framework Remotion a HyperFrames. No existe el proceso inverso (HyperFrames → Remotion, o → cualquier otro framework — fuera de alcance), y una fuente de React / animación web que no sea de Remotion no tiene código Remotion que traducir — recréala mediante /general-video.
  • No puede producir entradas que no tiene. Sin grabación de pantalla / sesión, sin captura de cámara, sin generación de avatar parlante / sincronización labial con IA. Si el metraje o activo aún no existe, HyperFrames no puede crearlo — pide al usuario que lo proporcione (o que use la herramienta de captura adecuada) primero.

Todo lo demás — un video a partir de una URL, resumen, tema, PR, metraje para anotar, o un solo elemento para animar — está dentro de alcance; enrútalo abajo.


Enrutamiento de videos

Esta sección solo conoce flujos de trabajo de alto nivel. No carga fases internas de los flujos de trabajo, skills de dominio (hyperframes-* — consulta el mapa de capacidades arriba), ni referencias técnicas.

Tabla de decisión

El tipo de ENTRADA (intención) es el eje principal; la duración de SALIDA es solo un techo, no una compuerta. Para una entrada coincidente, los flujos de trabajo especializados manejan cualquier cosa de hasta ~3 min — qué flujo de trabajo eliges viene determinado por la intención (el tipo de entrada y, para texto, el tema), no por la duración. La duración solo importa en el extremo superior: una pieza genuinamente más larga (un tutorial de 3-5 min, una inmersión de 5 min+) es un registro diferente y se enruta a /general-video. Dentro de la banda de ≤~3 min, un tercer eje divide los dos flujos de trabajo alimentados por texto — el tema: un producto que se comercializa vs un tema que se explica (consulta la regla de desambiguación en el paso 3 a continuación).

Duración / EntradaLanzamiento de producto (URL / resumen / guión)Sitio web general / URLPR de GitHub / cambio de códigoTema / artículo / notas (sin producto, sin URL)Video existente (talking-head) †
≤ ~3 min/product-launch-video/website-to-video/pr-to-video/faceless-explainer/embedded-captions · /graphic-overlays †
Tutorial de 3-5 min/general-video/general-video/general-video/general-video/embedded-captions · /graphic-overlays †
Inmersión de 5 min+/general-video/general-video/general-video/general-video/embedded-captions · /graphic-overlays †
Estático / bucle/general-video/general-video/general-video/general-video/general-video

Cobertura actual: la banda ≤ ~3 min tiene flujos de trabajo dedicados para entradas de lanzamiento-de-producto / sitio-web-general / PR-de-GitHub / tema (una URL se divide por tipo y luego intención — consulta el paso 3), y la columna de video existente está cubierta en cualquier duración — por /embedded-captions (subtítulos / leyendas) o /graphic-overlays (superposiciones gráficas diseñadas), divididas por intención (consulta el paso 2). Cada otra celda es /general-video — el flujo de autoría de composiciones HTML general (independiente de entrada y duración): todo más largo de ~3 min (filas de 3-5 min / 5 min+) y cada formato estático / bucle. El enrutador nunca termina sin salida para un video creable; la única respuesta "general / ninguna" real es una solicitud fuera del propio HyperFrames (por ejemplo, edición estilo NLE de un archivo de video terminado — recorte temporal, recoloreado, reencuadre, reordenamiento, audio).

† El metraje existente se divide por intención, no por duración. Subtítulos / leyendas → /embedded-captions; superposiciones gráficas diseñadas / empaquetado — tercios inferiores, llamadas de datos, tarjetas con títulos, citas destacadas — → /graphic-overlays. Ambas superponen el clip, que se reproduce sin cambios debajo; ninguna edita el metraje en sí.

Cortocircuito de género (precede a la tabla). Un gráfico en movimiento corto (~menos de 10s), sin narración, liderado por diseño — tipografía cinética, un impacto de estadística / gráfico, un sting de logotipo, un tercio inferior / superposición, o un tuit animado / titular / resaltado de página capturada — se enruta a /motion-graphics independientemente de la entrada. Es un género de SALIDA, no un tipo de entrada, por lo que tiene prioridad sobre la tabla de tipo de entrada anterior cuando la solicitud es claramente movimiento-primero sin narración (consulta el paso 2). Un tratamiento más largo o narrado se enruta por tipo de entrada, o a /general-video.

Migrar una composición existente (caso especial)

La tabla anterior es para crear un video a partir de una entrada. Un flujo de trabajo queda fuera de ella: si el usuario pide explícitamente portar / convertir / migrar una composición existente de Remotion (React) a HyperFrames → /remotion-to-hyperframes. Esto es traducción de código fuente, no creación a partir de entrada, por lo que no tiene una celda ENTRADA × DURACIÓN. Enruta aquí SOLO con lenguaje explícito de migración ("porta mi proyecto de Remotion", "convierte esta comp de Remotion", "reescribe esto como HyperFrames") — una mención pasajera de Remotion no es un desencadenante; por defecto, usa la tabla de creación o /hyperframes-core.

Procedimiento de enrutamiento

  1. Determina el tipo de ENTRADA + la duración objetivo. El enrutamiento necesita saber de qué trata el video — su tema y entrada. Si el tema en sí no está especificado (por ejemplo, "haz un video sobre nuestra cosa" sin URL, producto nombrado, tema o activo con el que trabajar), o el tipo de entrada es desconocido, pregunta antes de entrar en cualquier flujo de trabajo — aclara primero; no invoques una Skill de flujo de trabajo y luego preguntes, ya que comprometerse con un flujo de trabajo es en sí mismo la decisión de enrutamiento. Haz como máximo 2 preguntas aclaratorias:
    • "¿Cuál es tu entrada — un producto (URL o resumen), un sitio web general / URL, un PR de GitHub / cambio de código, un tema o artículo para explicar, o un video existente de talking-head para subtitular?"
    • "Duración objetivo — ¿unos 3 minutos o menos, o más larga (tutorial de 3-5 min / inmersión de 5 min+)?"
    • Valores por defecto de especificaciones — indica, no preguntes (estos NO afectan la ruta, así que nunca bloquees el enrutamiento por ellos): relación de aspecto 16:9 (el motor también soporta 9:16 vertical — cambia solo si el usuario nombra un destino vertical como TikTok / Reels / Shorts); idioma de narración / subtítulos = el del usuario. Confirma solo si el usuario se opone; el flujo de trabajo elegido reconfirmará sus propios detalles en su Paso 0.
  2. Elige por tipo de ENTRADA (intención) primero; la duración es solo un techo, no una compuerta.
    • Gráfico en movimiento corto liderado por diseño (cortocircuito de género, precede a la tabla de entrada) — el movimiento en sí es el mensaje: tipografía cinética, un contador de estadística/número, un impacto de gráfico, un sting de logotipo, un tercio inferior / superposición, o un tuit animado / titular / resaltado de página capturada; típicamente menos de ~10s, sin narración / voz en off → /motion-graphics. Esto es un género de SALIDA, no un tipo de entrada — cuando la solicitud es claramente una pieza de movimiento rápida, sin narración, liderada por diseño, enruta aquí independientemente de la entrada. Un tratamiento más largo o narrado del mismo material NO es esto (enruta por tipo de entrada, o a /general-video).
    • Video existente de talking-head (el usuario tiene un clip y quiere añadir algo sobre él) → divide por intención, en cualquier duración (el tipo de entrada gana sobre la duración): subtítulos / leyendas (las palabras habladas como texto legible) → /embedded-captions; superposiciones gráficas diseñadas — tercios inferiores, llamadas de datos, tarjetas de información con título, citas destacadas, una edición empaquetada con gráficos → /graphic-overlays. (Editar el metraje en sí mismo — re-temporización, recoloración, reencuadre, reordenamiento, audio — es estilo NLE y está fuera de alcance; consulta § Lo que HyperFrames no puede hacer.)
    • PR de GitHub / cambio de código (un enlace github.com/<propietario>/<repo>/pull/<N>, una referencia propietario/repo#N, o "este PR") → /pr-to-video (hasta ~3 min).
    • De lo contrario (URL de producto / resumen / texto de tema): la intención elige el flujo de trabajo mediante el paso 3, y maneja cualquier cosa de hasta ~3 min — un promo corto de 15-30 s y un explicador de ~100 s ambos se enrutan por intención, no por duración. Enruta a /general-video (la alternativa independiente de duración — consulta el paso 4) solo cuando el objetivo es claramente más largo de ~3 min (un tutorial de 3-5 min, una inmersión de 5 min+). Nunca fuerces una pieza genuinamente larga en un flujo de trabajo de ≤~3 min — la intención decide dentro de la banda, /general-video cubre el resto.
  3. Desambigua las entradas de URL / texto de ≤~3 min (la división por intención). Dos divisiones:
    • Tipo de URL + intención — una URL ya no gana automáticamente para PLV; su tipo luego intención deciden: un enlace de PR de GitHub (.../pull/<N>, propietario/repo#N, "este PR") → /pr-to-video; de lo contrario, una URL de sitio web se divide por intención — comercializar / lanzar / promocionar un producto o SaaS específico → /product-launch-video; un sitio general → video (recorrido del sitio, portafolio / blog / escaparate de página de inicio, un clip social de los propios elementos visuales del sitio, o simplemente "convierte este sitio en un video") → /website-to-video. Ambos rastrean con Chrome sin cabeza; las URLs de PR se leen mediante gh. Cuando no esté claro si una URL de sitio es un lanzamiento de producto o un video de sitio general, haz una pregunta.
    • Producto vs tema (texto, sin URL) — la pregunta decisiva es de qué trata el video, no el formato de entrada:
      • Un producto / empresa / SaaS / aplicación / sitio web específico que se está comercializando, lanzando o promocionando → /product-launch-video.
      • Un concepto / tema / artículo / cómo-funciona-algo que se está explicando, sin producto y sin URL → /faceless-explainer.
      • Desempates: redacción "Promocionar / Lanzar / Vender / nuestro producto" → PLV. "Explicar / Enseñar / cómo funciona X / qué es X" sin producto → faceless. El estilo predeterminado para faceless es siempre pin-and-paper.
      • Un sitio nombrado sin URL pegada sigue siendo PLV. Un guión que menciona un producto o su sitio web ("nuestro sitio es acme.io", "promociona ") se enruta a PLV incluso sin un enlace clicable — PLV puede buscar el sitio en la web y rastrearlo para obtener activos de marca (a menos que el usuario opte por no hacerlo, → modo preset sin captura). No pegar la URL no lo convierte en un trabajo faceless / sin captura. La elección de verbatim vs reestructuración para un guión proporcionado es interna a PLV y nunca cambia la ruta.
      • Señales conflictivas → pregunta, no adivines. Si la fuente proporcionada es el propio marketing de un producto (su página de inicio, un blog promocional sobre su plataforma) pero el usuario pide explícitamente eliminar la promoción — un explicador neutral del concepto subyacente, no un anuncio — trátalo como genuinamente ambiguo (¿es el video sobre el producto o sobre el concepto?). Pregunta en una frase corta y solo entonces enruta por la respuesta del usuario.

Para la documentación completa del contrato de composición, consulta /hyperframes-core.

Skills relacionados