Beats de Video HyperFrames
Usa esta skill para convertir un video con presentador más su transcripción en un conjunto ritmado de motion graphics que apoyen la narración sin cubrir innecesariamente al presentador.
Objetivo Principal
Mantén al espectador orientado y comprometido. Cada beat debe responder a una de estas preguntas:
- ¿Qué debería recordar el espectador?
- ¿Qué concepto necesita una estructura visual?
- ¿Qué estadística, contraste o punto de inflexión merece énfasis?
- ¿Dónde el ritmo se está volviendo suficientemente tranquilo como para que el espectador pueda distraerse?
No añadas gráficos solo porque exista un hueco. Añade gráficos porque la narración tiene un tema, una transición, un punto de prueba o un modelo mental que se beneficia del apoyo visual.
Primera Pasada
- Lee las instrucciones del proyecto (
AGENTS.md, documentos de skill locales y notas específicas del proyecto). - Inspecciona la composición raíz, el horario de beats actual, el CSS compartido y la transcripción.
- Construye un mapa de cobertura a partir de las entradas
data-start/data-durationde la raíz o del arraySHOWprincipal. - Extrae fragmentos de la transcripción para cualquier región solicitada y para cualquier hueco descubierto.
- Identifica los tramos temáticos por la narración, no por marcas de tiempo arbitrarias.
- Decide si cada tema necesita un beat de papel a pantalla completa, una tarjeta de vidrio en la parte inferior o ningún beat nuevo.
Usa comandos locales rápidos. Prefiere rg, Select-String y pequeños scripts de Node/PowerShell para la transcripción.
Decisión del Tipo de Beat
Usar Papel Arrugado a Pantalla Completa
Usa una toma de papel cuando la narración llegue a una tesis importante, lista, marcador de sección, cita o estadística que deba convertirse brevemente en el fotograma completo.
Buenos usos:
- Conclusión del gancho o resumen "en este video"
- Transición importante de sección
- Estadística grande o resultado de estudio
- Línea de tesis memorable
- Cita corta o mantra
- Contraste que necesita que la audiencia se detenga y mire
Reglas:
- Mantenlo corto, normalmente de 4 a 12 segundos.
- Usa texto negro y espaciado.
- Solo permite que los números de estadísticas verdaderas o una palabra extremadamente importante usen color de acento.
- No cubras explicaciones largas con tomas de papel.
- No hagas que el texto a pantalla completa sea juguetón, enorme o demasiado negrita por defecto.
Usar Moldura Inferior de Efecto Glassmorphism
Usa una moldura inferior de vidrio cuando el presentador deba permanecer visible y el gráfico deba apoyar la idea actual.
Buenos usos:
- Andamios de explicación
- Etiquetas de tema
- Modelos mentales tipo ecuación
- Listas pequeñas
- Traducciones de "lo que esto significa"
- Rellenos de ritmo durante tramos largos con presentador
- Tarjetas de seguimiento después de un beat acortado de pantalla completa o de pantalla dividida
Reglas:
- Mantén las molduras inferiores en el tercio inferior o la mitad inferior.
- Evita cubrir la cara.
- Usa texto conciso: un titular más una línea secundaria opcional, o una lista de 2 a 4 elementos.
- Prefiere una tarjeta por tramo temático en lugar de muchos destellos pequeños.
- Conserva el estilo de tarjeta de vidrio existente a menos que el usuario solicite un cambio de diseño.
Heurísticas de Ritmo
Para videos largos de YouTube con presentador:
- Inicio del video: evita más de 20-30 segundos sin un beat visual.
- Cuerpo principal: evita más de 30-45 segundos sin un beat.
- Secciones de explicación densas: usa molduras inferiores aproximadamente cada tramo temático, no cada frase.
- Las grandes tomas de papel deben ser puntuaciones ocasionales, no la opción predeterminada.
- Si un beat existente se acortó manualmente porque se sentía demasiado largo, respeta esa decisión y rellena después con una nueva tarjeta más corta.
Al escanear un horario, reporta los huecos verdaderos según el horario de visibilidad, no solo por el orden del DOM. Si la línea de tiempo raíz usa un array SHOW, ese suele ser el rango visible autorizado.
Método de Sincronización
Sincroniza cada beat con el tema de la transcripción:
- Encuentra la primera palabra o frase donde comienza el tema.
- Inicia el beat 0.2-0.6 segundos antes de ese ancla cuando sea posible.
- Mantén el beat visible hasta que el tema termine o pase naturalmente.
- Si el siguiente beat comienza inmediatamente, limpia 0.1-0.5 segundos antes a menos que el traspaso sea intencional.
- Empareja las entradas de subelementos con las frases habladas.
Evita este modo de fallo:
- La tarjeta aparece en el tema correcto pero solo dura de 5 a 8 segundos mientras el presentador sigue discutiendo el tema durante 20 a 40 segundos.
Prefiere:
- Una tarjeta vive durante todo el tema, con una línea secundaria o un elemento de lista que se construye a mitad de camino si la narración evoluciona.
Redacción de Contenido
Redacta para la comprensión de un vistazo. El espectador debe entender la tarjeta en menos de un segundo.
Usa:
- Frases nominales cortas
- Etiquetas directas
- Un modelo mental por tarjeta
- Números solo cuando sean significativos
- Verbos cuando aclaren la acción
Evita:
- Repetir toda la locución
- Oraciones largas
- Lenguaje vago y entusiasta
- Demasiadas palabras resaltadas
- Explicar cómo usar el video dentro del gráfico
Buenos patrones:
El cuello de botella
No hay suficiente IA dentro de los flujos de trabajo reales.
El problema es la adopción, no el talento bruto.
El puente
Habilidades + Flujos de trabajo = 40 horas ahorradas
En este video
-> El estudio
-> Las estadísticas
-> Los caminos que puedes tomar
-> Lo que realmente importa
Reglas de Estilo Visual
Sigue primero el sistema de diseño local. Para esta familia de proyectos, usa:
- Tipografía profesional seria.
- Texto primario negro en los beats de papel.
- Azul de acento solo para números de estadísticas importantes o palabras de poder poco comunes.
- Tarjetas de vidrio con el estilo oscuro mate existente.
- Tarjetas de moldura inferior que no cubran la cara del presentador.
Para beats de papel:
- Usa negro para patadas, etiquetas, flechas, fuentes, citas y texto de apoyo.
- Mantén el peso de la fuente contenido.
- Evita tipos de letra exagerados y juguetones a menos que el usuario lo solicite explícitamente.
- Haz que el movimiento de papel arrugado sea determinista.
Para tarjetas de vidrio:
- Reutiliza
.glass-card dim lower-thirdo la clase existente más cercana. - Prefiere la colocación en la parte inferior central.
- Mantén las tarjetas compactas.
- Usa ayudantes de ecuación/lista cuando la idea sea estructural.
Reglas de Implementación en HyperFrames
Sigue el AGENTS.md del proyecto y las reglas de lint de HyperFrames:
- Cada elemento temporizado montado necesita
data-start,data-durationydata-track-index. - Los elementos visibles montados en la raíz deben tener la clase de clip/capa esperada utilizada por el proyecto.
- Las subcomposiciones deben registrar una línea de tiempo de GSAP pausada en
window.__timelines. - Fija cada línea de tiempo de subcomposición con
tl.set({}, {}, SLOT);. - Mantén solo lógica determinista.
- No animes las dimensiones de los elementos de video ni las propiedades multimedia de maneras que puedan congelar los renders.
- Ejecuta
npx hyperframes lintdespués de editar HTML.
Al agregar un beat:
- Crea
compositions/beats/NNN-short-name.html. - Añade el montaje raíz en
index.html. - Añade o actualiza el horario de visibilidad principal si existe.
- Haz que el
SLOTde la subcomposición coincida con la duración montada. - Verifica que no haya superposiciones en la misma pista a menos que el proyecto use intencionadamente múltiples pistas de superposición.
Escaneo de Cobertura
Después de las ediciones, escanea el horario principal:
- Enumera los beats ordenados por inicio visible.
- Imprime los huecos por encima del umbral objetivo.
- Añade o reajusta los beats solo donde la transcripción tenga un concepto que se pueda apoyar.
Para este patrón de proyecto, usa 30 segundos como umbral de escaneo estricto y 45 segundos como umbral máximo aceptable para el cuerpo principal.
Validación
Antes de finalizar:
- Ejecuta el linter de HyperFrames.
- Corrige todos los errores.
- Menciona las advertencias por separado si son conocidas y no bloqueantes.
- Si el usuario solicitó salida lista para renderizar, renderiza o renderiza en falso según corresponda.
- Entrega al usuario las rutas de archivo exactas y las marcas de tiempo modificadas.
Valores Predeterminados Prácticos
Usa estos valores predeterminados a menos que el contexto del proyecto diga lo contrario:
- Resumen de papel a pantalla completa: 8-10 segundos.
- Estadística de papel a pantalla completa: 5-8 segundos.
- Explicación con moldura inferior de vidrio: 12-30 segundos.
- Tarjeta de vidrio para tema largo: 25-45 segundos con subelementos escalonados.
- Inicio anticipado del beat: 0.2-0.6 segundos.
- Umbral de escaneo de huecos: 30 segundos.
- Ancho de moldura inferior: aproximadamente 68-72vw, máximo alrededor de 1240-1280px.
Qué Conservar
Conserva las decisiones de gusto del usuario descubiertas durante la revisión:
- Si el usuario dice que un beat es demasiado largo, no lo restablezcas solo para cumplir una regla genérica de cobertura.
- Si se aprueba el estilo de tarjeta de vidrio, reutilízalo en lugar de rediseñarlo.
- Si se aprueba la tipografía, mantenla estable y ajusta solo el tamaño y peso local.
- Si la cara del presentador es importante, prefiere tarjetas de moldura inferior sobre tarjetas en el centro de la pantalla.