Communitygithub.com

nateherkai/hyperframes-student-kit

Planifica, escribe, sincroniza, estiliza y valida beats de motion-graphics para videos extensos de HyperFrames con un presentador. Se usa cuando Codex debe añadir o mejorar beats visuales, molduras inferiores de efecto glassmorphism, pantallas completas de papel arrugado, llamadas sincronizadas con la transcripción, cobertura de ritmo, gráficos de retención de YouTube o superposiciones listas para renderizar en un proyecto de video HyperFrames existente.

¿Qué es hyperframes-student-kit?

Esta skill está diseñada para agentes de IA (como Codex) que trabajan en proyectos de video HyperFrames con un presentador hablando directamente a cámara. Su objetivo principal es transformar un video más la transcripción en una secuencia de gráficos animados que refuercen la narración sin tapar innecesariamente al presentador. La skill proporciona reglas precisas para decidir cuándo usar una pantalla completa de papel arrugado (para tesis, estadísticas o transiciones importantes) o una moldura inferior de vidrio (para explicaciones estructurales o listas cortas). También incluye heurísticas de ritmo para asegurar que el espectador se mantenga interesado (evitando lapsos de más de 30 segundos sin un beat visual), métodos de sincronización basados en la transcripción, pautas de redacción para captar la atención en menos de un segundo y reglas de estilo visual para mantener una apariencia profesional y coherente. Finalmente, la skill guía la implementación técnica dentro del ecosistema HyperFrames, incluyendo la creación de composiciones, la gestión de horarios de visibilidad y la validación con el linter de HyperFrames.

Compatible con~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/nateherkai/hyperframes-student-kit/tree/HEAD/.agents/skills/hyperframes-video-beats

Preguntar en tu IA favorita

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

Documentación

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

  1. Lee las instrucciones del proyecto (AGENTS.md, documentos de skill locales y notas específicas del proyecto).
  2. Inspecciona la composición raíz, el horario de beats actual, el CSS compartido y la transcripción.
  3. Construye un mapa de cobertura a partir de las entradas data-start / data-duration de la raíz o del array SHOW principal.
  4. Extrae fragmentos de la transcripción para cualquier región solicitada y para cualquier hueco descubierto.
  5. Identifica los tramos temáticos por la narración, no por marcas de tiempo arbitrarias.
  6. 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:

  1. Encuentra la primera palabra o frase donde comienza el tema.
  2. Inicia el beat 0.2-0.6 segundos antes de ese ancla cuando sea posible.
  3. Mantén el beat visible hasta que el tema termine o pase naturalmente.
  4. Si el siguiente beat comienza inmediatamente, limpia 0.1-0.5 segundos antes a menos que el traspaso sea intencional.
  5. 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-third o 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-duration y data-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 lint después de editar HTML.

Al agregar un beat:

  1. Crea compositions/beats/NNN-short-name.html.
  2. Añade el montaje raíz en index.html.
  3. Añade o actualiza el horario de visibilidad principal si existe.
  4. Haz que el SLOT de la subcomposición coincida con la duración montada.
  5. 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:

  1. Ejecuta el linter de HyperFrames.
  2. Corrige todos los errores.
  3. Menciona las advertencias por separado si son conocidas y no bloqueantes.
  4. Si el usuario solicitó salida lista para renderizar, renderiza o renderiza en falso según corresponda.
  5. 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.

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

nateherkai/hyperframes-student-kit

Agent 2 of the video editing pipeline. Finds and removes spoken mistakes — stutters, repeated words, false starts, and retakes (re-recorded lines) — from a talking-head recording. Use after cut-silences, when asked to cut mistakes, remove stutters / repeats / filler restarts, clean up flubs, or keep the best take. Works review-gated: it proposes every cut with context and a reason for approval, then renders only the approved cuts via ffmpeg. Requires a word-level transcript.

nateherkai/hyperframes-student-kit

Agent 1 of the video editing pipeline. Removes silences and dead air from a talking-head recording. Use when asked to cut silences, trim pauses, remove dead air / gaps, or tighten the pacing of a raw video, given a word-level transcript. Produces an edit list (EDL), a re-timed transcript for downstream agents, and optionally the cut video via ffmpeg. Does NOT cut mistakes, repeats, or false starts — that is the cut-mistakes agent.

nateherkai/hyperframes-student-kit

Edit a raw talking-head video through transcription, silence trimming, mistake review, visual storytelling, motion graphics, and verified HyperFrames rendering. Use for a complete edit; route a single requested operation directly to its specialist skill.

nateherkai/hyperframes-student-kit

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

nateherkai/hyperframes-student-kit

HyperFrames CLI tool — hyperframes init, lint, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Use when scaffolding a project, linting or validating compositions, previewing in the studio, rendering to video, transcribing audio, generating TTS, or troubleshooting the HyperFrames environment.

nateherkai/hyperframes-student-kit

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

nateherkai/motion-showreel

Build 10–30s motion-design showreels in the style of Nate's Opus 5.5 CLAUDE/MOTION REEL — brand motif chapters, HUD, BPM-locked cuts, logo lockup.

nateherkai/website-to-hyperframes

Capture a website URL and produce a HyperFrames promo/product-tour video — site → finished marketing video outcome.

Skills relacionados