Communitygithub.com

RoleModel/rolemodel-openscreen

Aplica la marca RoleModel a un video de HyperFrames: de dónde viene design.md, qué token de movimiento usar, qué prohíbe la marca y cómo funcionan la narración y la entrega al cliente. Úsalo cuando alguien diga 'haz un video de RoleModel', 'ponle la marca a esta composición', 'qué easing debería usar', 'agrega gráficos en movimiento a esta grabación' o esté escribiendo cualquier composición de HyperFrames con la marca RoleModel o Academy. Es una capa delgada sobre las habilidades existentes de HyperFrames: agrega lo nuestro y deja todo lo demás.

¿Qué es rolemodel-openscreen?

Esta es una habilidad especializada para Claude Code (u otros agentes) que actúa como una capa de marca sobre el sistema de composición de video HyperFrames. Su propósito principal es garantizar que cualquier composición de video que lleve la marca RoleModel o Academy cumpla con las pautas de la marca: colores, tipografía, reglas de movimiento (como la selección de tokens de duración y easing), y restricciones (prohibición de gradientes radiales, bordes decorativos, subrayados, etc.). La habilidad se basa en el archivo `design.md` generado automáticamente desde el repositorio de tokens de marca, y delega toda la lógica de composición, animación, audio y CLI a las habilidades estándar de HyperFrames. También proporciona un flujo de trabajo estructurado (a través de `hyperframes-direction-harness`) para bloquear la dirección antes de escribir el HTML final, y maneja la narración y la entrega con herramientas locales como `rm-voice` y `rm-mux`, garantizando que nada del producto del cliente salga de la máquina.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/RoleModel/rolemodel-openscreen/tree/HEAD/skill/hyperframes-brand

Preguntar en tu IA favorita

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

Documentación

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
hyperframesautoría de composición, temporización, medios, el flujo de trabajo de producción
hyperframes-coreel contrato de composición y los atributos de temporización data-*
hyperframes-animationreglas de movimiento, planos de escena, GSAP y los otros runtimes
hyperframes-keyframesacercamientos, movimientos de cámara, reencuadres, keyframes seguros para búsqueda
hyperframes-creativepaletas, planificación de ritmo, narración, patrones de composición
hyperframes-audiomezcla de una pista ya colocada: fundidos, silenciamiento, automatización
hyperframes-cliinit, lint, check, preview, render, transcribe, tts
hyperframes-registryinstalación de bloques y componentes
media-usebúsqueda o generación de música, SFX, imágenes, voz

Estándar (nuestro), en ~/.claude/skills/synced:

habilidadúsala cuando
hyperframesnuestra propia habilidad de composición — lee design.md, house-style.md
hyperframes-clinuestras propias notas de CLI
hyperframes-direction-harnessantes de un index.html final cuando la dirección no está definida
optics-contextcualquier cosa que también tenga que ser una superficie de producto
gsapaspectos específicos de GSAP
impeccablenuestro estándar de artesanía

Colisión de nombres. hyperframes y hyperframes-cli existen 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 --stagger entre 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-title la 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.

entradaherramienta¿se mantiene actualizado?
Grabarsu pantallaopenscreenno — regrabar a mano
Componerun guion o un briefHyperFramesre-ejecutar el brief
Desde una pruebaun trace de Playwrightplaywright-recastsí — 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.

Skills relacionados