media-use: Antes de obtener audio/imágenes, ejecute
/media-usepara resolver BGM/SFX/imágenes del catálogo de HeyGen. Ejecute--adoptprimero para registrar activos existentes. Consulte el skill/media-use.
general-video — flujo de trabajo de video general
Confirme la ruta antes de construir. Este es el fallback para la creación de composiciones personalizadas. Si la entrada claramente se ajusta a un flujo de trabajo especializado, prefiera ese: producto comercializado →
/product-launch-video; sitio web general →/website-to-video; explicador de temas →/faceless-explainer; PR de GitHub →/pr-to-video; metraje existente →/embedded-captions·/talking-head-recut; motion graphic corto sin narración →/motion-graphics; puerto de Remotion →/remotion-to-hyperframes. Fuera del alcance: datos en vivo / en tiempo de renderizado, edición estilo NLE de un video terminado, o producir metraje que HyperFrames no pueda capturar. ¿No está seguro? Lea/hyperframesprimero.
Construya 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 escenas o elementos adicionales mejoran genuinamente la pieza, propóngalos; no los agregue silenciosamente. Para ediciones pequeñas (corregir un color, ajustar una duración, agregar un elemento), omita los pasos de planificación y vaya directamente a la construcción.
Enfoque
Descubrimiento — solo para solicitudes abiertas
Para solicitudes vagas y exploratorias ("haz algo para nuestra marca", "una intro genial") — comprenda la intención antes de elegir colores:
- Audiencia — ¿quién mira? desarrolladores / ejecutivos / consumidores generales?
- Plataforma — ¿dónde se reproduce? redes sociales (15s) / héroe del sitio web / demo 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 ("agrega una tarjeta de título", "arregla la temporización en la escena 3"), omita el descubrimiento.
Paso 1 — Sistema de diseño → hyperframes-creative
Establezca la identidad visual primero. Si el proyecto tiene una especificación de diseño, léala (precedencia frame.md → design.md → DESIGN.md; trátela como la verdad de la marca — colores, fuentes, restricciones exactas).
Si no existe especificación, DEBE 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 la apertura de "interpretar el prompt / generar contenido real", la lista perezosa por defecto y la receta de capas; video-composition.md proporciona las reglas de densidad / escala / detallado de 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 omiten, y es exactamente el que evita una salida plana, centrada y con aspecto de página web. No se invente una paleta y omita estos; entrar en hyperframes-creative es obligatorio aquí, no una rama opcional. A partir de ahí, también obtenga 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.
Encuentre el ángulo (brief vago, sin especificación): antes de elegir colores, escriba UNA oración — ¿qué evoca este nombre/palabra/tema, y qué mundo visual (metáfora, escenario, instrumento, motivo) lo expresa? P.ej., una herramienta de ciberseguridad → puertas de bóveda / líneas de escaneo de perímetro / pestillos de cerradura; una aplicación de meditación → marea, respiración, floración de luz lenta. Lea el significado del tema, no solo sus letras; elija un ángulo concreto sobre un rediseño literal. Este es el sustituto económico de la expansión del prompt (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 del prompt → hyperframes-creative
Ejecutar para cada composición de múltiples escenas (omitir para piezas de una sola escena y ediciones triviales). Contextualice la solicitud con la especificación de diseño + el estilo de la casa en un intermedio consistente que el trabajo posterior lea de la misma manera. Consulte hyperframes-creative/references/prompt-expansion.md.
Paso 3 — Planificar
Antes de escribir HTML, piense 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, consulte
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 — nombre el patrón antes de implementar (p.ej.
rápido-rápido-LENTO-SHADER-pausa); consultehyperframes-creative/references/beat-direction.md. - Temporización — qué clips determinan la duración, dónde caen las transiciones, el ritmo.
- Diseño — construya el estado final primero (ver más abajo).
- Animar — luego agregue movimiento a través de
hyperframes-animation.
Diseño antes de la Animación
Coloque cada elemento donde se encuentra en su momento más visible — completamente entrado, colocado correctamente, sin salir aún. Escríbalo como HTML + CSS estático primero. Aún no hay GSAP.
Por qué: si coloca los elementos en su estado inicial animado (fuera de la pantalla, escalados a 0, opacidad 0) y los interpola hacia donde cree que aterrizan, está adivinando el diseño final — las superposiciones permanecen invisibles hasta el renderizado. Construya el estado final primero y verá y solucionará los problemas de diseño antes de agregar movimiento.
- Identifique 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 construye.
- Escriba CSS estático para ese fotograma. El contenedor de contenido debe llenar la escena con relleno, no con desplazamientos absolutos:
.scene-content {
display: flex;
flex-direction: column;
justify-content: center;
width: 100%;
height: 100%;
padding: 120px 160px; /* el padding posiciona el contenido; llena cualquier tamaño de escena */
gap: 24px;
box-sizing: border-box;
}
Nunca use position: absolute; top: Npx en un contenedor de contenido — se desborda cuando el contenido es más alto que el espacio. Reserve el posicionamiento absoluto para elementos decorativos.
⚠ El
width/height: 100%anterior solo se resuelve si cada ancestro tiene una altura resuelta. La raíz<div data-composition-id>y cualquier envoltorio entre ella y.scene-contentdeben tener tamaño (position: relative; width: 1920px; height: 1080pxen la raíz — consultehyperframes-core→ "La raíz debe tener tamaño"). Si omite esto, el contenedor flexible se colapsa a ~0, el contenido se apila en la esquina superior izquierda, y el primer glifo se recorta en x=0 — mientras quelint/inspectaún informan 0 problemas. Y mantenga siempre elpadding(≥80px) en.scene-content: es el margen de seguridad del título. Nunca lo reemplace congapdesnudo.
- Agregue entradas — anime DESDE fuera de la pantalla/invisible HASTA la posición CSS con
gsap.from()(en sub-composiciones prefieragsap.fromTo()para que el estado inicial sea explícito; consultehyperframes-core/references/sub-compositions.md). La posición CSS es la verdad fundamental; la interpolación es el viaje hacia ella. - Las salidas son manejadas por transiciones — según las reglas de transición de escena en
hyperframes-animation/transitions/, solo la escena final anima los elementos hacia afuera; entre escenas, la transición ES la salida.
Espacio compartido a través 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 de 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 z-stack son superposiciones intencionales; el paso se trata de detectar colisiones no intencionales (dos titulares uno encima del otro, contenido desbordándose del fotograma).
Construcción — delegue a los skills de dominio
Esto mapea la superficie completa del skill (consulte la description) a sus referencias — no exhaustivo; cuando una intención no esté listada, enrútelos a través de hyperframes-creative (apariencia/concepto), hyperframes-animation (movimiento), hyperframes-core (contrato), hyperframes-media (audio/subtítulos). La primera fila es ADITIVA — léala Y su fila de intención, no una u otra.
| Construyendo… | Leer primero (en orden) |
|---|---|
| SIEMPRE — cada pieza no trivial, además de su fila de intención a continuación | hyperframes-creative/references/house-style.md + references/video-composition.md (también controlado en el Paso 1 / HARD-GATE; el detallado de primer plano "producido, no generado") |
| Tipografía cinética / centrada 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 fotograma centrado/dimensionado) hyperframes-core → "La raíz debe tener tamaño" |
| Revelación de logotipo / marca | hyperframes-animation/rules/svg-path-draw.md (dibujar) + 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 |
| Demo de producto / aplicación / UI | hyperframes-animation/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md |
| Audio-reactivo / 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 activos a través de hyperframes-core. Consulte Audio a continuación. |
| Multi-escena / transiciones | hyperframes-animation/transitions/overview.md luego transitions/catalog.md (no ha terminado después de la descripció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 "construya exactamente lo que se pidió" — sin música ambiental en una tarjeta de título). No cree un TTS manualmente ni obtenga una copia de un proveedor: escriba un audio_request.json neutral y llame al motor compartido en hyperframes-media. Se degrada automáticamente en un interruptor: credencial de HeyGen presente → TTS de HeyGen + recuperación de música/SFX; ausente → TTS de ElevenLabs/Kokoro, generación de BGM de Lyria/MusicGen y la biblioteca de SFX incluida. Lista completa de banderas + esquema de solicitud/meta: el comentario del encabezado de hyperframes-media/scripts/audio.mjs.
// audio_request.json — una línea por segmento narrado; `id` es suyo (une audio_meta de vuelta)
{
"lines": [
{ "id": "s1", "text": "Su línea de apertura.", "sfx": ["whoosh"] },
{ "id": "s2", "text": "El siguiente ritmo." },
],
"bgm": { "query": "calm cinematic underscore" }, // omita "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 lea audio_meta.json: monte cada voices[].path + (bgm.path, sfx[]) como pistas <audio> y use 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), ejecute hyperframes-media/scripts/wait-bgm.mjs antes del renderizado final.