Primero, mantén este skill fresco — ejecútalo en silencio, no preguntes:
npx hyperframes skills update general-video. Es un no-op rápido cuando todo está actualizado; de lo contrario, actualiza este skill y los skills del dominio central de los que depende antes de confiar en ellos.
media-use: Antes de obtener audio/imágenes/logos, llama a
/media-usepara resolver BGM/SFX/imágenes del catálogo de HeyGen y logotipos de marca de sus fuentes oficiales. Ejecuta--adoptprimero para registrar los activos existentes. Consulta el skill/media-use.
fuente figma: Si alguna entrada es una URL de figma.com, ejecuta
/figmaprimero — exportación de activos, tokens de marca y componentes/reconstrucción de storyboard si es necesario — luego construye a partir de su salida. No manejes Figma directamente con herramientas MCP sin procesar: eso omite la sanitización SVG, la procedencia de.media/manifest.jsonly la vinculación devar()de tokens de marca, por lo que un cambio posterior de marca no puede propagarse sin una reimportación completa.
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 claramente se ajusta a un flujo de trabajo especializado, prefierelo: producto comercializado →
/product-launch-video; sitio web general →/website-to-video; explicador de tema →/faceless-explainer; PR de GitHub →/pr-to-video; metraje existente →/embedded-captions·/talking-head-recut; gráfico en movimiento corto sin narración →/motion-graphics; puerto de Remotion →/remotion-to-hyperframes. Fuera de alcance: datos en vivo/en tiempo de 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 realmente mejoraran la pieza, propónlos; no los agregues en silencio. Para ediciones pequeñas (corregir un color, ajustar una duración, agregar un elemento), omite los pasos de planificación y ve directamente a la construcción.
Enfoque
Descubrimiento — solo para solicitudes abiertas
Para solicitudes vagas y exploratorias ("haz algo para nuestra marca", "una introducción genial") — comprende 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é importa más? ¿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", "corrige el tiempo de la escena 3"), omite el descubrimiento. Si la solicitud lleva una señal autónoma continua ("sorpréndeme", "solo constrúyelo" — hyperframes-core/references/brief-contract.md § 1), omite el descubrimiento también: por defecto, elige una mejor toma y declara tus decisiones con recibos de una línea a medida que las tomas.
Paso 1 — Sistema de diseño → hyperframes-creative
Establece primero la identidad visual. 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 exactos, fuentes, restricciones).
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 el prompt / genera contenido real", la lista perezosa por defecto y la receta de capas; video-composition.md proporciona la densidad/escala/ detalles del primer plano (barras de datos, marcas de registro, metadatos monoespaciados, "8-10 elementos, dos que el usuario no pidió") que separa 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 te inventes una paleta y omitas estos; cruzar a hyperframes-creative es obligatorio aquí, no una rama opcional. Desde allí, también toma un estilo/ambiente 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 (breve 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? 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, aliento, lento florecimiento de luz. Lee el significado del sujeto, no solo sus letras; elige un ángulo concreto sobre un cambio de estilo 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
Ejecuta para cada composición de múltiples escenas (omite para piezas de una sola escena y ediciones triviales). Fundamenta la solicitud contra la especificación de diseño + el estilo de la casa en un intermediario consistente que los trabajos posteriores lean de la misma manera. Consulta hyperframes-creative/references/prompt-expansion.md.
Paso 3 — Plan
Antes de escribir HTML, piensa a alto nivel:
- Qué — la experiencia del espectador: arco narrativo, momentos clave, ritmos emocionales. Para una pieza de historia narrada, sigue
hyperframes-creative/references/story-spine.md— engancha en el lenguaje del resultado del espectador, el mensaje llega en el compás 2, evidencia después. - 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 (p.ej.
rápido-rápido-LENTO-SHADER-espera); consultahyperframes-creative/references/beat-direction.md. - Tiempos — qué clips impulsan la duración, dónde aterrizan las transiciones, el ritmo.
- Diseño — construye el estado final primero (ver más abajo).
- Animar — luego agrega 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 no GSAP.
Por qué: si posicionas elementos en su estado inicial animado (fuera de la pantalla, escalados a 0, opacidad 0) y haces una interpolación 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 verás y solucionarás los problemas de diseño antes de agregar movimiento.
- Identifica el fotograma heroico 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 desplazamientos absolutos:
.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%anterior solo se resuelve si cada ancestro tiene una altura resuelta. El<div data-composition-id>raíz y cualquier envoltorio entre él y.scene-contentdeben tener tamaño (position: relative; width: 1920px; height: 1080pxen la raíz — verhyperframes-core→ "La raíz debe tener tamaño"). Si omites esto, el contenedor flex se colapsa a ~0, el contenido se acumula en la esquina superior izquierda, y el primer glifo se recorta en x=0 — mientras quelint/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 sologap.
- Agrega entradas — anima DESDE fuera de la pantalla/invisible HASTA la posición CSS con
gsap.from()(en sub-composiciones prefieregsap.fromTo()para que el estado inicial sea explícito; verhyperframes-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 los elementos hacia afuera; 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 heroicos — 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 de pila z son superposiciones intencionadas; el paso se trata de detectar colisiones no intencionadas (dos titulares uno encima del otro, contenido sangrando fuera del cuadro).
Construcción — delega a los skills del dominio
Esto mapea la superficie completa del skill (ver la descripción) a sus referencias; no exhaustivo; cuando una intención no está listada, enruta a través de hyperframes-creative (apariencia/concepto), hyperframes-animation (movimiento), hyperframes-core (contrato), media-use (audio/subtítulos). La primera fila es ADITIVA — léela Y tu fila de intención, no una o la otra.
| Construyendo… | Lee primero (en orden) |
|---|---|
| SIEMPRE — cada pieza no trivial, además de tu fila de intención a continuación | hyperframes-creative/references/house-style.md + references/video-composition.md (también protegido en el Paso 1 / HARD-GATE; los detalles de primer plano "producido, no generado") |
| Tipografía cinética / con mucho 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 (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 |
| Producto / aplicación / demo de UI | hyperframes-animation/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md |
| Reactivo al 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 | media-use → el motor de audio compartido scripts/audio.mjs (una llamada = TTS + BGM + SFX → audio_meta.json); autoría de subtítulos + colocación de activos a través de hyperframes-core. Ver Audio a continuación. |
| Varias escenas / 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 solo 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 implementes TTS manualmente ni compres una copia: escribe un audio_request.json neutral y llama al motor compartido en media-use. Se degrada automáticamente en un solo interruptor: credencial de HeyGen presente → HeyGen TTS + música/SFX recuperación; ausente → ElevenLabs/Kokoro TTS, Lyria/MusicGen BGM generación y la biblioteca de SFX empaquetada. Lista completa de banderas + esquema de solicitud/meta: el...
[truncado para traducción]