Marca RoleModel para HyperFrames
Ya tenemos herramientas profundas de HyperFrames. Empieza desde ese inventario, no desde cero. Esta habilidad es solo la capa de marca encima: de dónde vienen nuestros valores, cuál usar y lo que no hacemos.
El inventario
Hay dos conjuntos instalados, y se superponen por nombre. Sepa cuál está invocando.
Oficial (HeyGen), en ~/.claude/skills:
| habilidad | úsala cuando |
|---|---|
hyperframes | autoría de composición, temporización, medios, el flujo de trabajo de producción |
hyperframes-core | el contrato de composición y los atributos de temporización data-* |
hyperframes-animation | reglas de movimiento, planos de escena, GSAP y los otros runtimes |
hyperframes-keyframes | acercamientos, movimientos de cámara, reencuadres, keyframes seguros para búsqueda |
hyperframes-creative | paletas, planificación de ritmo, narración, patrones de composición |
hyperframes-audio | mezcla de una pista ya colocada: fundidos, silenciamiento, automatización |
hyperframes-cli | init, lint, check, preview, render, transcribe, tts |
hyperframes-registry | instalación de bloques y componentes |
media-use | búsqueda o generación de música, SFX, imágenes, voz |
Estándar (nuestro), en ~/.claude/skills/synced:
| habilidad | úsala cuando |
|---|---|
hyperframes | nuestra propia habilidad de composición — lee design.md, house-style.md |
hyperframes-cli | nuestras propias notas de CLI |
hyperframes-direction-harness | antes de un index.html final cuando la dirección no está definida |
optics-context | cualquier cosa que también tenga que ser una superficie de producto |
gsap | aspectos específicos de GSAP |
impeccable | nuestro estándar de artesanía |
Colisión de nombres.
hyperframesyhyperframes-cliexisten en ambos conjuntos. Cuando importe cuál obtiene, dígalo explícitamente.
No repita ninguna de sus reglas aquí. El contrato de composición, errores de lint, colisión de pistas, timelines en pausa — todo eso pertenece a esas habilidades y se mantiene allí. Una segunda copia se desvía en cuanto lanzan una versión y nadie se da cuenta. Si falta una regla, corríjela río arriba, no en este archivo.
La marca llega a HyperFrames a través de design.md
La habilidad hyperframes estándar ya lee design.md desde la raíz del proyecto como "la fuente de verdad para colores, fuentes y restricciones de la marca", y se le indica que use sus valores exactos en lugar de inventar ninguno. Ese es el gancho. Úsalo.
El repositorio de la marca genera uno:
cp rolemodel-brand/dist/design.md <video-project>/design.md
Se genera desde rolemodel-brand/tokens/brand.json mediante scripts/build-tokens.mjs, por lo que no puede diferir de los tokens que usa cualquier otra superficie de RoleModel. Nunca lo edite a mano — cambie brand.json y vuelva a ejecutar.
Ese archivo lleva color, tipo, la escala de movimiento completa, los cuatro principios de movimiento y las restricciones a continuación. Una vez que está en el proyecto, la habilidad existente hace el resto.
Para propiedades personalizadas de CSS en la propia composición:
<link rel="stylesheet" href="rolemodel-brand/css/academy-theme.css">
<body data-theme="academy">
Elegir un token de movimiento
Los valores completos están en design.md. La regla para elegir es breve:
Elige por lo que el elemento está haciendo, no por cómo se ve.
- Una cosa llegando →
--duration-base+--ease-enter - La misma cosa siendo descartada →
--duration-fast+--ease-exit. Salir siempre es más rápido que llegar. - Algo ya en pantalla cambiando de lugar o tamaño →
--ease-move - Un deliberado mírame →
--ease-emphasis, la única curva que puede sobrepasar - Un grupo → un
--staggerentre hermanos, nunca todos a la vez
Nunca escriba una duración cruda o un cubic-bezier crudo en una composición. Misma regla que el Estudio aplica al color, por la misma razón.
Lo que no hacemos
Estas son vinculantes. Varias son aplicadas por npm run check en el toolkit, y todas están en design.md donde la habilidad de composición las leerá.
- Sin gradientes radiales, en ningún lado. La marca es lineal — dirección, no manchas.
- Sin barridos de marco. No dibuje un marco, borde o caja de color blanco o con línea clara que cruce como transición de escena. Claude recurre a esto sin que se le pida; es un adorno de plantilla estándar, no nosotros, y dirige la atención hacia nada. Transicione cortando, o revelando el contenido entrante con
--ease-enter. Nada dibuja una caja alrededor del marco. - Sin reglas decorativas, subrayados o divisores. No subraye un encabezado, ponga una línea clave entre secciones, o dibuje un borde alrededor de una tarjeta, estadística, cita o tercio inferior. Claude recurre a estos para señalar estructura; solo señalan que se añadió algo. La separación proviene del espacio, el peso y el fondo. La única regla sancionada en el sistema es la barra corta de marca debajo de un título, y
rm-titlela dibuja — nunca añada una segunda a mano. - Un borde es un borde sólido, no un fundido. Esto rige cómo se dibuja un borde necesario; no es licencia para añadir uno. Si nada es ambiguo sin el borde, no hay borde.
- El naranja es solo un acento — nunca un fondo.
- Sin ornamentación. Si un elemento no lleva información ni dirige la atención, elimínelo.
Cuando la dirección no está definida
No empiece a escribir index.html. Use hyperframes-direction-harness — está construido exactamente para esto y produce un tablero revisable antes de cualquier composición:
01_intake.md → 02_design_direction.md → 03_critical_frame_plan.md
→ direction_board.html (Banco de trabajo del director, revisado)
→ 04_render_plan.md (listo solo después de la revisión)
→ entregar a la habilidad hyperframes
Sáltelo solo para ediciones pequeñas a una composición existente — un error tipográfico, un ajuste de temporización, un color, una corrección de lint.
Qué herramienta resuelve qué problema
HyperFrames compone; no captura. Si el video debe mostrar la interfaz de usuario real del producto, es la herramienta equivocada.
| entrada | herramienta | ¿se mantiene actualizado? | |
|---|---|---|---|
| Grabar | su pantalla | openscreen | no — regrabar a mano |
| Componer | un guion o un brief | HyperFrames | re-ejecutar el brief |
| Desde una prueba | un trace de Playwright | playwright-recast | sí — re-ejecutar la prueba |
Recurra a HyperFrames para las tarjetas de título, tercios inferiores y gráficos en movimiento que se superponen a una captura.
Narración, temporización, entrega
No sintetice la narración dentro de la composición.
rm-voice <project> --script opener --voice af_nova
Un clip por línea, cada uno medido, SRT escrito a partir de duraciones ya conocidas — así que las temporizaciones son exactas por construcción y una corrección de texto solo resintetiza lo que cambió. Kokoro se ejecuta localmente: sin clave de API, y nada sobre un producto de cliente no lanzado sale de la máquina.
Un render y una pista de narración están en relojes diferentes. playwright-recast comprime el tiempo de inactividad; la narración dura lo que tardan las palabras. Grabe una pista de subtítulos de 22 segundos en un render de 3.8 segundos y la señal 1 se mantiene para todo el clip mientras el resto se descarta silenciosamente — parece que funcionó.
rm-mux --video demo.mp4 --audio narration.wav --srt narration.srt -o final.mp4
rm-share final.mp4 --project "Ridgeline Railing"
rm-share devuelve un enlace que un cliente abre sin cuenta y deja comentarios con marca de tiempo. rm-share --check dice si está configurado.
Antes de un proyecto de cliente
export HYPERFRAMES_NO_TELEMETRY=1
La telemetría está activada por defecto. Los nombres de proyectos y el contenido del video nunca se recopilan, pero hyperframes auth login vincula su correo electrónico de cuenta de HeyGen a su uso y une la actividad anónima anterior a él. Ponga la exclusión voluntaria en la estructura.
Fije la versión. HyperFrames es Apache-2.0 — sin recuento de asientos, sin umbral de tamaño de empresa, por lo que es nuestro valor predeterminado — pero es pre-1.0 y se lanza casi a diario sin garantía de compatibilidad declarada. Un proyecto de cliente que se renderiza hoy debería renderizarse igual en seis meses.
Créditos
El encuadre de tres niveles y el pipeline de corte → storyboard → gráficos en movimiento provinieron de hyperframes-helper por Jay en RoboNuggets, usado bajo CC BY 4.0. Mantenga la atribución si re-comparte esto — esa es la licencia.