media-use: Antes de buscar audio/imágenes, llama a
/media-usepara resolver BGM/SFX/imágenes del catálogo de HeyGen. Ejecuta--adoptprimero para registrar los assets existentes. Consulta el skill/media-use.
general-video — flujo de trabajo de video general
Confirma la ruta antes de construir. Este es el respaldo para la creación de composiciones personalizadas. Si la entrada se ajusta claramente a un flujo de trabajo especializado, prefíerelo: producto comercializado →
/product-launch-video; sitio web general →/website-to-video; explicación de tema →/faceless-explainer; PR de GitHub →/pr-to-video; metraje existente →/embedded-captions·/talking-head-recut; gráfico animado corto sin narración →/motion-graphics; port de Remotion →/remotion-to-hyperframes. Fuera de alcance: datos en vivo/en el momento del renderizado, edición estilo NLE de un video terminado o producción de metraje que HyperFrames no pueda capturar. ¿No estás seguro? Lee/hyperframesprimero.
Construye exactamente lo que se pidió. Una tarjeta de título es una tarjeta de título — no una tarjeta de título + tres escenas de apoyo + música ambiental + subtítulos. Si las escenas o elementos adicionales mejoraran genuinamente la pieza, propónlos; no los añadas en silencio. Para ediciones pequeñas (corregir un color, ajustar una duración, añadir un elemento), salta los pasos de planificación y ve directo a la construcción.
Enfoque
Descubrimiento — solo para solicitudes abiertas
Para solicitudes vagas y exploratorias ("haz algo para nuestra marca", "una intro genial") — comprende la intención antes de elegir colores:
- Audiencia — ¿quién lo ve? desarrolladores / ejecutivos / consumidores generales?
- Plataforma — ¿dónde se reproduce? redes sociales (15s) / héroe del sitio web / demostración de producto / interno?
- Prioridad — ¿qué es lo más importante? calidad del movimiento / precisión del contenido / fidelidad de la marca / velocidad?
- Variaciones — ¿una mejor toma, o 2-3 opciones significativamente diferentes (diferente ritmo, energía o estructura — no solo cambios de color)?
Para solicitudes específicas ("añade una tarjeta de título", "arregla el tiempo de la escena 3"), salta el descubrimiento.
Paso 1 — Sistema de diseño → hyperframes-creative
Establece la identidad visual primero. Si el proyecto tiene una especificación de diseño, léela (precedencia frame.md → design.md → DESIGN.md; trátala como la verdad de la marca — colores, fuentes y restricciones exactos).
Si no existe una especificación, DEBES leer AMBOS hyperframes-creative/references/house-style.md Y hyperframes-creative/references/video-composition.md antes de elegir cualquier color o fuente. house-style.md proporciona el abridor "interpreta la solicitud / genera contenido real", la lista perezosa por defecto y la receta de capas; video-composition.md proporciona las reglas de densidad/escala de medios de video y detalles en primer plano (barras de datos, marcas de registro, metadatos monoespaciados, "8-10 elementos, dos que el usuario no pidió") que separan lo "producido" de lo "generado". Leer solo uno es el error más común — video-composition.md es el que los agentes se saltan, y es exactamente el que evita la salida plana, centrada y con aspecto de página web. No te inventes una paleta y te saltes estos; cruzar a hyperframes-creative es obligatorio aquí, no una rama opcional. A partir de ahí, también toma un estilo/estado de ánimo con nombre → references/visual-styles.md, o el selector interactivo → references/design-picker.md, según sea necesario. La especificación/estilo define la marca, no las reglas de composición.
Encuentra el ángulo (resumen vago, sin especificación): antes de elegir colores, escribe UNA oración — ¿qué evoca este nombre/palabra/tema, y qué mundo visual (metáfora, escenario, instrumento, motivo) lo expresa? Por ejemplo, una herramienta de ciberseguridad → puertas de bóveda / líneas de escaneo de perímetro / pestillos de cerradura; una app de meditación → marea, respiración, lento florecimiento de luz. Lee el significado del tema, no solo sus letras; elige un ángulo concreto sobre un rediseño literal. Este es el sustituto económico de la expansión de la solicitud (Paso 2) en piezas de una sola escena, donde la expansión se omite correctamente — y es la diferencia entre un concepto diseñado y un logotipo genérico sobre un degradado.
Paso 2 — Expansión de la solicitud → hyperframes-creative
Ejecutar para cada composición multi-escena (saltar para piezas de una sola escena y ediciones triviales). Fundamenta la solicitud con la especificación de diseño + el estilo de la casa en un intermediario consistente que el trabajo posterior lea de la misma manera. Consulta hyperframes-creative/references/prompt-expansion.md.
Paso 3 — Planificación
Antes de escribir HTML, piensa a alto nivel:
- Qué — la experiencia del espectador: arco narrativo, momentos clave, ritmos emocionales.
- Estructura — cuántas composiciones, sub-comp vs en línea, qué pistas llevan video / audio / superposiciones / subtítulos. Para la decisión de archivo único monolítico vs sub-comp modular, consulta
hyperframes-core/references/composition-patterns.md§ Dos Arquitecturas (regla general: ≥3 cortes de escena duros, o cualquier escena reutilizada → modularizar; una pieza corta de una sola escena permanece en un archivo). - Ritmo — nombra el patrón antes de implementar (por ejemplo,
rápido-rápido-LENTO-SHADER-pausa); consultahyperframes-creative/references/beat-direction.md. - Tiempo — qué clips determinan la duración, dónde caen las transiciones, el ritmo.
- Diseño — construye el estado final primero (ver más abajo).
- Animar — luego añade movimiento a través de
hyperframes-animation.
Diseño Antes de la Animación
Posiciona cada elemento donde se encuentra en su momento más visible — completamente entrado, colocado correctamente, sin salir aún. Escríbelo como HTML + CSS estático primero. Aún sin GSAP.
Por qué: si posicionas los elementos en su estado de inicio animado (fuera de pantalla, escalados a 0, opacidad 0) y interpolas a donde crees que aterrizan, estás adivinando el diseño final — las superposiciones permanecen invisibles hasta el renderizado. Construye el estado final primero y ves y solucionas los problemas de diseño antes de añadir movimiento.
- Identifica el fotograma héroe para cada escena — el momento en que la mayoría de los elementos son visibles simultáneamente. Ese es el diseño que construyes.
- Escribe CSS estático para ese fotograma. El contenedor de contenido debe llenar la escena con relleno, no con compensaciones absolutas:
.scene-content {
display: flex;
flex-direction: column;
justify-content: center;
width: 100%;
height: 100%;
padding: 120px 160px; /* el relleno posiciona el contenido; llena cualquier tamaño de escena */
gap: 24px;
box-sizing: border-box;
}
Nunca uses position: absolute; top: Npx en un contenedor de contenido — se desborda cuando el contenido es más alto que el espacio. Reserva el posicionamiento absoluto para elementos decorativos.
⚠ El
width/height: 100%de arriba solo se resuelve si cada ancestro tiene una altura resuelta. El<div data-composition-id>raíz y cualquier envoltorio entre él y.scene-contentdebe tener tamaño (position: relative; width: 1920px; height: 1080pxen la raíz — consultahyperframes-core→ "La raíz debe tener tamaño"). Si te lo saltas, el contenedor flex se colapsa a ~0, el contenido se apila en la esquina superior izquierda, y el primer glifo se recorta en x=0 — mientraslint/inspectaún informan 0 problemas. Y mantén siempre elpadding(≥80px) en.scene-content: es el margen de seguridad del título. Nunca lo reemplaces con un simplegap.
- Añade entradas — anima DESDE fuera de pantalla/invisible HASTA la posición CSS con
gsap.from()(en sub-composiciones prefieregsap.fromTo()para que el estado inicial sea explícito; consultahyperframes-core/references/sub-compositions.md). La posición CSS es la verdad fundamental; la interpolación es el viaje hacia ella. - Las salidas se manejan con transiciones — según las reglas de transición de escena en
hyperframes-animation/transitions/, solo la escena final anima la salida de los elementos; entre escenas, la transición ES la salida.
Espacio compartido a lo largo del tiempo: si el elemento A sale antes de que el elemento B entre en la misma área, ambos aún necesitan posiciones CSS correctas para sus respectivos fotogramas héroe — el orden en la línea de tiempo evita que coexistan, y el paso de diseño detecta superposiciones accidentales. Los brillos/sombras en capas y la profundidad apilada en z son superposiciones intencionales; el paso consiste en detectar colisiones no intencionales (dos titulares uno encima del otro, contenido que se sale del marco).
Construcción — delega a los skills de dominio
Esto mapea la superficie completa del skill (consulta la description) a sus referencias — no exhaustivo; cuando una intención no esté listada, enruta a través de hyperframes-creative (aspecto/concepto), hyperframes-animation (movimiento), hyperframes-core (contrato), hyperframes-media (audio/subtítulos). La primera fila es ADITIVA — léela Y tu fila de intención, no una u otra.
| Construyendo… | Lee primero (en orden) |
|---|---|
| SIEMPRE — cada pieza no trivial, además de tu fila de intención abajo | hyperframes-creative/references/house-style.md + references/video-composition.md (también verificado en el Paso 1 / HARD-GATE; los detalles de primer plano "producido, no generado") |
| Tipografía cinética / centrado en texto | hyperframes-animation/techniques.md (tipo cinético) + adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md |
| Tarjeta de título / tercio inferior / superposición / PiP / texto detrás del sujeto | hyperframes-creative/references/composition-patterns.md + (para el marco centrado/dimensionado) hyperframes-core → "La raíz debe tener tamaño" |
| Revelación de logotipo / marca | hyperframes-animation/rules/svg-path-draw.md (dibujado) + rules/3d-text-depth-layers.md + rules/scale-swap-transition.md |
| Datos / estadísticas / números | hyperframes-animation/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-creative/references/data-in-motion.md |
| Demostración de producto / app / UI | hyperframes-animation/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md |
| Reactivo a audio / impulsado por música | hyperframes-creative/references/audio-reactive.md (pre-extraer bandas; mapear a movimiento) |
| Narrado / voz en off / música / SFX / subtítulos | hyperframes-media → el motor de audio compartido scripts/audio.mjs (una llamada = TTS + BGM + SFX → audio_meta.json); creación de subtítulos + colocación de assets a través de hyperframes-core. Consulta Audio más abajo. |
| Multi-escena / transiciones | hyperframes-animation/transitions/overview.md luego transitions/catalog.md (no has terminado después de la visión general — la receta de GSAP está en el catálogo) |
| Modular / sub-composiciones | hyperframes-core/references/composition-patterns.md + references/sub-compositions.md |
Audio: un motor (TTS · BGM · SFX)
Solo cuando la pieza lo requiera (según "construye exactamente lo que se pidió" — sin música ambiental en una tarjeta de título). No improvises TTS ni compres una copia: escribe un audio_request.json neutral y llama al motor compartido en hyperframes-media. Se degrada automáticamente según un interruptor — credencial de HeyGen presente → TTS de HeyGen + recuperación de música/SFX; ausente → generación de TTS de ElevenLabs/Kokoro, BGM de Lyria/MusicGen y la biblioteca de SFX incluida. Lista completa de banderas + esquema de solicitud/meta: el comentario de cabecera de hyperframes-media/scripts/audio.mjs.
// audio_request.json — una línea por segmento narrado; `id` es tuyo (une audio_meta de vuelta)
{
"lines": [
{ "id": "s1", "text": "Tu línea de apertura.", "sfx": ["whoosh"] },
{ "id": "s2", "text": "El siguiente ritmo." },
],
"bgm": { "query": "fondo cinematográfico tranquilo" }, // omite "mode" → auto (recuperar si HeyGen, si no generar); "none" para deshabilitar
}
# <MEDIA_DIR> = el directorio del skill hyperframes-media instalado (hermano de este skill)
node <MEDIA_DIR>/scripts/audio.mjs --request ./audio_request.json --hyperframes . --out ./audio_meta.json
Luego lee audio_meta.json: monta cada voices[].path + (bgm.path, sfx[]) como pistas <audio> y usa voices[].words para subtítulos, todo según hyperframes-core (pistas de audio + creación de subtítulos). Si BGM tomó la ruta de generación (bgm_pending: true), ejecuta hyperframes-media/scripts/wait-bgm.mjs antes del renderizado final.