Communitygithub.com

GanQiao1990/skills_2026

Crea composiciones de video, animaciones, tarjetas de título, superposiciones, subtítulos, voces en off, imágenes reactivas al audio y transiciones de escena en HTML de HyperFrames.

¿Qué es skills_2026?

Esta habilidad es la guía integral para la creación de videos con HyperFrames, un framework basado en HTML que usa archivos HTML como fuente de verdad para la composición de video. Proporciona reglas detalladas sobre estructura de composición, temporización con atributos `data-*`, animación con GSAP, y estilos con CSS. El resumen cubre desde el diseño de alto nivel (qué, estructura, temporización, diseño y animación) hasta reglas estrictas de implementación, incluyendo la gestión de identidad visual, diseño antes de la animación, uso de atributos de datos para clips y composiciones, manejo de video y audio, y transiciones de escena obligatorias. Es compatible con plataformas como Claude Code, Cursor y Codex, y es útil para desarrolladores que necesitan crear contenido de video dinámico, subtítulos sincronizados, narración por texto a voz, animaciones reactivas al audio y transiciones complejas. La habilidad también incluye referencias a subhabilidades para comandos CLI (`hyperframes-cli`) y conversión de sitios web a HyperFrames (`website-to-hyperframes`). No se debe confundir con otros skills y es esencial para cualquier flujo de trabajo de producción de video basado en HTML.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/GanQiao1990/skills_2026/tree/HEAD/openclaw-imports/hyperframes

Preguntar en tu IA favorita

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

Vista previa

Del README del skill

Documentación

HyperFrames

HTML es la fuente de verdad para el video. Una composición es un archivo HTML con atributos data-* para la temporización, una línea de tiempo de GSAP para la animación y CSS para la apariencia. El framework maneja la visibilidad de los clips, la reproducción de medios y la sincronización de la línea de tiempo.

Alcance general y flujos de trabajo específicos absorbidos

Esta habilidad es el paraguas a nivel de clase para la creación de contenido en HyperFrames. Cubre la estructura de la composición, la temporización, la animación, la identidad visual, los subtítulos, las imágenes reactivas al audio y la construcción de escenas de calidad de producción. Use la habilidad hyperframes-cli para la referencia de comandos y website-to-hyperframes cuando el material de origen sea un sitio web existente. Las notas de producción/depuración de sesiones únicas y específicas se han degradado a referencias de soporte aquí.

Subsección: trampas del flujo de trabajo de producción

Las notas históricas de producción enfatizaron algunas trampas del entorno que siguen siendo útiles:

  • Prefiera rutas de proyecto/salida solo ASCII al renderizar; las rutas no ASCII pueden romper Chrome sin cabeza o los subprocesos del renderizador.
  • Si la codificación MP4 falla bajo Conda FFmpeg, fuerce el FFmpeg del sistema con export PATH=/usr/bin:$PATH o renderice WebM como alternativa.
  • Cuando se usan objetos de línea de tiempo personalizados en lugar de GSAP, deben exponer métodos compatibles con GSAP: duration(), pause() y seek(time).
  • Si el video final se ve negro o vacío, primero verifique si un contenedor .clip con temporización estaba oculto mientras solo se animaban sus hijos. Una clase de utilidad como .hidden { display: none; } en los envoltorios de escena produce el modo de fallo clásico: el audio se renderiza, el fondo se renderiza, pero nunca aparece ningún texto/tarjeta porque la escena principal nunca entra en diseño/pintura. Para envoltorios de escena con temporización, oculte con opacity: 0 u opacidad controlada por la línea de tiempo en lugar de display: none.
  • Para JS de tiempo de ejecución crítico como GSAP, prefiera vender una copia local en el proyecto (por ejemplo assets/gsap.min.js) en lugar de depender de fetching de CDN en vivo durante el renderizado.
  • Agregue <link rel="icon" href="data:,"> a composiciones independientes para suprimir el ruido de error 404 de favicon del navegador sin cabeza cuando no hay favicon como parte del proyecto.
  • Verifique visualmente extrayendo fotogramas con FFmpeg e inspeccionando capturas de pantalla, no solo confiando en un código de salida de renderizado exitoso.

Referencias de soporte degradadas

  • references/hyperframes-video-production.md
  • references/hyperframes-workflow.md

Enfoque

Antes de escribir HTML, piense a alto nivel:

  1. Qué — ¿qué debería experimentar el espectador? Identifique el arco narrativo, los momentos clave y los latidos emocionales.
  2. Estructura — cuántas composiciones, cuáles son subcomposiciones vs en línea, qué pistas contienen qué (video, audio, superposiciones, subtítulos).
  3. Temporización — qué clips impulsan la duración, dónde caen las transiciones, cuál es el ritmo.
  4. Diseño — construya el estado final primero. Vea "Diseño Antes de la Animación" a continuación.
  5. Animar — luego agregue movimiento usando las reglas a continuación.

Para ediciones pequeñas (corregir un color, ajustar la temporización, agregar un elemento), vaya directamente a las reglas.

Puerta de Identidad Visual

Verifique en este orden:

  1. ¿Existe DESIGN.md en el proyecto? → Léalo. Use sus colores, fuentes, reglas de movimiento y restricciones "Qué NO Hacer" exactos.
  2. ¿Existe visual-style.md? → Léalo. Aplique su style_prompt_full y campos estructurados. (Nota: visual-style.md es un archivo específico del proyecto. visual-styles.md es la biblioteca de estilos con 8 preajustes nombrados — archivos diferentes.)
  3. ¿El usuario nombró un estilo (ej., "Swiss Pulse", "oscuro y tecnológico", "marca de lujo")? → Lea visual-styles.md para los 8 preajustes nombrados. Genere un DESIGN.md mínimo con: ## Prompt de Estilo (un párrafo), ## Colores (3-5 valores hex con roles), ## Tipografía (1-2 familias de fuentes), ## Qué NO Hacer (3-5 antipatrones).
  4. ¿Ninguno de los anteriores? → Haga 3 preguntas antes de escribir cualquier HTML:
    • ¿Cuál es el estado de ánimo? (explosivo / cinematográfico / fluido / técnico / caótico / cálido)
    • ¿Lienzo claro u oscuro?
    • ¿Algún color, fuente o referencia visual específica de la marca? Luego genere un DESIGN.md mínimo a partir de las respuestas.

Cada composición debe rastrear su paleta y tipografía hasta un DESIGN.md, visual-style.md o una dirección explícita del usuario. Si está usando #333, #3b82f6 o Roboto — se saltó este paso.

Para valores predeterminados de movimiento, tamaño, patrones de entrada y easing — siga house-style.md. El estilo de la casa maneja CÓMO se mueven las cosas. El DESIGN.md maneja CÓMO SE VEN las cosas.

Diseño Antes de la Animación

Posicione cada elemento donde debería estar en su momento más visible — el fotograma donde ha entrado completamente, está colocado correctamente y aún no está saliendo. Escriba esto como HTML+CSS estático primero. Aún no hay GSAP.

Por qué esto es importante: Si posiciona los elementos en su estado de inicio animado (fuera de la pantalla, escalados a 0, opacidad 0) y los interpola hacia donde cree que deberían aterrizar, está adivinando el diseño final. Las superposiciones son invisibles hasta que el video se renderiza. Al construir el estado final primero, puede ver y solucionar problemas de diseño antes de agregar cualquier movimiento.

El proceso

  1. Identifique el fotograma héroe para cada escena — el momento en que la mayoría de los elementos son visibles simultáneamente. Este es el diseño que construye.
  2. Escriba CSS estático para ese fotograma. El contenedor .scene-content DEBE llenar la escena completa usando width: 100%; height: 100%; padding: Npx; con display: flex; flex-direction: column; gap: Npx; box-sizing: border-box. Use padding para empujar el contenido hacia adentro — NUNCA position: absolute; top: Npx en un contenedor de contenido. Los contenedores de contenido con posición absoluta se desbordan cuando el contenido es más alto que el espacio restante. Reserve position: absolute solo para elementos decorativos.
  3. Agregue entradas con gsap.from() — anime DESDE fuera de la pantalla/invisible HASTA la posición CSS. La posición CSS es la verdad absoluta; la interpolación describe el viaje para llegar allí.
  4. Agregue salidas con gsap.to() — anime HASTA fuera de la pantalla/invisible DESDE la posición CSS.

Ejemplo

/* scene-content llena la escena, el padding posiciona el contenido */
.scene-content {
  display: flex;
  flex-direction: column;
  justify-content: center;
  width: 100%;
  height: 100%;
  padding: 120px 160px;
  gap: 24px;
  box-sizing: border-box;
}
.title {
  font-size: 120px;
}
.subtitle {
  font-size: 42px;
}
/* El contenedor llena cualquier tamaño de escena (1920x1080, 1080x1920, etc.).
   El padding posiciona el contenido. Flex + gap maneja el espaciado. */

INCORRECTO — dimensiones fijas y posicionamiento absoluto:

.scene-content {
  position: absolute;
  top: 200px;
  left: 160px;
  width: 1920px;
  height: 1080px;
  display: flex; /* ... */
}
// Paso 3: Anime HACIA esas posiciones
tl.from(".title", { y: 60, opacity: 0, duration: 0.6, ease: "power3.out" }, 0);
tl.from(".subtitle", { y: 40, opacity: 0, duration: 0.5, ease: "power3.out" }, 0.2);
tl.from(".logo", { scale: 0.8, opacity: 0, duration: 0.4, ease: "power2.out" }, 0.3);

// Paso 4: Anime FUERA de esas posiciones
tl.to(".title", { y: -40, opacity: 0, duration: 0.4, ease: "power2.in" }, 3);
tl.to(".subtitle", { y: -30, opacity: 0, duration: 0.3, ease: "power2.in" }, 3.1);
tl.to(".logo", { scale: 0.9, opacity: 0, duration: 0.3, ease: "power2.in" }, 3.2);

Cuando los elementos comparten espacio a través del tiempo

Si el elemento A sale antes de que el elemento B entre en la misma área, ambos deben tener posiciones CSS correctas para sus respectivos fotogramas héroe. El orden de la línea de tiempo garantiza que nunca coexistan visualmente — pero si omite el paso de diseño, no detectará el caso en que se superponen accidentalmente debido a un error de temporización.

Qué cuenta como superposición intencional

Los efectos en capas (brillo detrás del texto, elementos de sombra, patrones de fondo) y los diseños apilados en Z (pilas de tarjetas, capas de profundidad) son intencionales. El paso de diseño se trata de detectar superposiciones no intencionales — dos titulares que caen uno encima del otro, una estadística que cubre una etiqueta, contenido que se sale del fotograma.

Atributos de Datos

Todos los Clips

AtributoRequeridoValores
idSíIdentificador único
data-startSíSegundos o referencia de ID de clip ("el-1", "intro + 2")
data-durationRequerido para img/div/composicionesSegundos. El video/audio predetermina la duración del medio.
data-track-indexSíEntero. Los clips de la misma pista no pueden superponerse.
data-media-startNoDesplazamiento de recorte en la fuente (segundos)
data-volumeNo0-1 (predeterminado 1)

data-track-index NO afecta la superposición visual — use CSS z-index.

Clips de Composición

AtributoRequeridoValores
data-composition-idSíID de composición único
data-startSíTiempo de inicio (composición raíz: use "0")
data-durationSíTiene prioridad sobre la duración de la línea de tiempo de GSAP
data-width / data-heightSíDimensiones en píxeles (1920x1080 o 1080x1920)
data-composition-srcNoRuta al archivo HTML externo

Estructura de la Composición

Las subcomposiciones cargadas a través de data-composition-src usan un envoltorio <template>. Las composiciones independientes (el index.html principal) NO usan <template> — colocan el div data-composition-id directamente en <body>. Usar <template> en un archivo independiente oculta todo el contenido del navegador y rompe el renderizado.

Estructura de subcomposición:

<template id="my-comp-template">
  <div data-composition-id="my-comp" data-width="1920" data-height="1080">
    <!-- contenido -->
    <style>
      [data-composition-id="my-comp"] {
        /* estilos con ámbito */
      }
    </style>
    <script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/gsap.min.js"></script>
    <script>
      window.__timelines = window.__timelines || {};
      const tl = gsap.timeline({ paused: true });
      // interpolaciones...
      window.__timelines["my-comp"] = tl;
    </script>
  </div>
</template>

Cargar en la raíz: <div id="el-1" data-composition-id="my-comp" data-composition-src="compositions/my-comp.html" data-start="0" data-duration="10" data-track-index="1"></div>

Video y Audio

El video debe tener muted playsinline. El audio siempre es un elemento <audio> separado:

<video
  id="el-v"
  data-start="0"
  data-duration="30"
  data-track-index="0"
  src="video.mp4"
  muted
  playsinline
></video>
<audio
  id="el-a"
  data-start="0"
  data-duration="30"
  data-track-index="2"
  src="video.mp4"
  data-volume="1"
></audio>

Contrato de Línea de Tiempo

  • Todas las líneas de tiempo comienzan { paused: true } — el reproductor controla la reproducción
  • Registre cada línea de tiempo: window.__timelines["<composition-id>"] = tl
  • El framework anida automáticamente las sublíneas de tiempo — NO las agregue manualmente
  • La duración proviene de data-duration, no de la longitud de la línea de tiempo de GSAP
  • Nunca cree interpolaciones vacías para establecer la duración

Reglas (No Negociables)

Determinista: Sin Math.random(), Date.now() o lógica basada en tiempo. Use un PRNG con semilla si necesita valores pseudoaleatorios (ej. mulberry32).

GSAP: Solo anime propiedades visuales (opacity, x, y, scale, rotation, color, backgroundColor, borderRadius, transformaciones). NO anime visibility, display, ni llame a video.play()/audio.play().

Conflictos de animación: Nunca anime la misma propiedad en el mismo elemento desde múltiples líneas de tiempo simultáneamente.

Sin repeat: -1: Las líneas de tiempo de repetición infinita rompen el motor de captura. Calcule el recuento exacto de repeticiones a partir de la duración de la composición: repeat: Math.ceil(duration / cycleDuration) - 1.

Construcción de línea de tiempo síncrona: Nunca construya líneas de tiempo dentro de async/await, setTimeout o Promises. El motor de captura lee window.__timelines de forma síncrona después de la carga de la página. Las fuentes están incrustadas por el compilador, por lo que están disponibles de inmediato — no es necesario esperar la carga de fuentes.

Nunca haga:

  1. Olvide el registro window.__timelines
  2. Use video para audio — siempre video silenciado + <audio> separado
  3. Anide video dentro de un div con temporización — use un envoltorio sin temporización
  4. Use data-layer (use data-track-index) o data-end (use data-duration)
  5. Anime las dimensiones del elemento de video — anime un div envoltorio
  6. Llame a play/pause/seek en medios — el framework posee la reproducción
  7. Cree un contenedor de nivel superior sin data-composition-id
  8. Use repeat: -1 en cualquier línea de tiempo o interpolación — siempre repeticiones finitas
  9. Construya líneas de tiempo de forma asíncrona (dentro de async, setTimeout, Promise)
  10. Use gsap.set() en elementos de clips de escenas posteriores — no existen en el DOM en la carga de la página. Use tl.set(selector, vars, timePosition) dentro de la línea de tiempo en o después del tiempo data-start del clip en su lugar.
  11. Use <br> en el texto del contenido — los saltos de línea forzados no tienen en cuenta el ancho de fuente renderizado real. El texto que se ajusta naturalmente + un <br> produce un salto adicional no deseado, causando superposición. Deje que el texto se ajuste a través de max-width en su lugar. Excepción: títulos de visualización cortos donde cada palabra está deliberadamente en su propia línea (ej., "THE\nIMMORTAL\nGAME" a 130px).

Transiciones de Escena (No Negociables)

Cada composición de múltiples escenas DEBE seguir TODAS estas reglas. Violar cualquiera de ellas es una composición rota.

  1. SIEMPRE use transiciones entre escenas. Sin cortes directos. Sin excepciones.
  2. SIEMPRE use animaciones de entrada en cada escena. Cada elemento se anima ENTRANDO a través de gsap.from(). Ningún elemento puede aparecer completamente formado. Si una escena...

Skills relacionados