Communitygithub.com

ohad6k/emulo

Convierte un resumen en una película. Traduce una solicitud de una línea a un prompt de diseño de Claude creado en el propio lenguaje del motor animations-v3, además del archivo piece.jsx construido y una hoja de contactos para revisar antes de que alguien renderice. Cubre roles de referencia, el kit, el gate del storyboard, el piso de movimiento y los comandos de verificación. No lo uses para trabajo de backend, diseño de UI o solo copy de marketing.

¿Qué es emulo?

Emulo es una habilidad de IA agente (como para Claude Code, Cursor, Codex, etc.) para creadores y equipos que necesitan transformar un brief en una especificación de producción de video lista para renderizar. La habilidad guía al agente a través de un proceso estructurado: primero carga un perfil de usuario y contexto del proyecto, luego construye un kit completo de activos (partes aisladas, marcas, UI reconstruida) en lugar de marcadores de posición. Luego escribe un prompt en el lenguaje del motor de composición `animations-v3.jsx` (que usa nombres de escenas, cues de coreografía, curvas de easing y un único eje de tiempo autorado), genera una hoja de contactos de referencia y, opcionalmente, construye y renderiza localmente la película para verificación. El objetivo final es una carpeta que se puede subir directamente a Claude Design, con un orden de carga claro, una hoja de ruta de activos y un prompt que nombra explícitamente cada archivo y condición de fallo. Emulo aplica reglas estrictas: no promediar referencias de estilo, no inventar activos faltantes, no editar el motor de ejecución y construir en etapas con compuertas de revisión. Está diseñado para generar películas cinematográficas de marca de alta calidad, no para trabajo de backend, diseño de UI o copy de marketing.

Compatible con✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/ohad6k/emulo/tree/HEAD/skills/video

Preguntar en tu IA favorita

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

Documentación

Video Emulo

Tomas un brief y devuelves una película. No un prompt, una película: el prompt que la construyó, los archivos de composición y fotogramas que alguien puede ver.

0. Carga el perfil antes de escribir una palabra

  1. Localiza emulo.py dos directorios por encima de esta habilidad; recurre a ./emulo.py solo para una clonación directa del repositorio.
  2. Guarda la ruta absoluta resuelta como EMULO_PY, luego ejecuta python "$EMULO_PY" plugin profile-path --domain video.
  3. Si termina con código distinto de cero, da su instrucción de recuperación exacta y deja de cargar el contexto personal. Nunca sustituyas una persona creativa genérica.
  4. Lee cada ruta devuelta por completo. La primera es el perfil de trabajo principal, la segunda es el perfil de video. Ambas tienen prioridad sobre cualquier cosa debajo: donde las reglas propias de la persona extraídas discrepan con un valor predeterminado en esta habilidad, las suyas ganan.
  5. Si el proyecto tiene sus propios documentos o enrutador de video, léelos primero y síguelos para todo lo que cubren.

1. Lo que devuelves

Una carpeta que la persona pueda subir a Claude Design y obtener una película. Ese es el entregable. No un prompt en un mensaje de chat, no una descripción de una película, no una lista de ideas. Una carpeta.

Constrúyela en el proyecto, en una carpeta con el nombre de la marca o la película, con esta forma:

#ArtefactoPor qué está ahí
1PROMPT.mdel brief. Una página, en el lenguaje del motor
2START-HERE.mdel orden de subida. Qué archivos, en qué orden, en un mensaje. Sin él, la persona adivina y la adivinanza es incorrecta
3ATTACH/cada activo que la película necesita, incluyendo animations-v3.jsx en sí mismo
4frames/fotogramas de referencia cuyos nombres de archivo llevan la instrucción
5KIT.mdel manifiesto: cada archivo, su tamaño en píxeles, sus defectos conocidos

Opcionalmente, y solo después de que los cinco anteriores estén terminados: build/piece.jsx más build/frames/, la película construida y renderizada localmente para que puedas verla antes de que nadie más lo haga. Eso es verificación, no el entregable. Un kit sin construcción local igual se envía. Una construcción local sin kit no.

Las tres cosas que deciden si la carpeta funciona

Envía el motor dentro de ATTACH/. animations-v3.jsx va en la carpeta con los activos. Claude Design necesita el tiempo de ejecución contra el que se le pide escribir. Dejarlo fuera es una forma común en que un buen prompt produce una mala película.

Partes aisladas, nunca una captura de pantalla de una pantalla completa. Un objeto por archivo, transparente, 1600px como mínimo en el borde largo, más placas grandes en la relación de aspecto de la película para el fondo. Una pantalla completa colocada es un bloque sólido y se lee como roto. Las películas construidas de esta manera fallan por activos faltantes con mucha más frecuencia que por la longitud del prompt.

Pon la instrucción en el nombre del archivo. REF_03_objecto-se-convierte-en-la-marca.png enseña; ref3.png no. La persona que los sube mantiene los nombres, por lo que cada archivo lleva su propia lección al contexto.

Nombra lo que falta. Nunca inventes un sustituto.

Si un activo no existe, dilo en PROMPT.md bajo su propio encabezado, y di qué hacer en su lugar. Un brief que admite dos activos faltantes es utilizable. Un brief que los falsifica en silencio produce una película con dos tiempos rotos y sin forma de saber por qué.

Cada prompt contiene, en este orden y por nombre

  1. el brief en el lenguaje del motor: OM_SCENES, CUES, Easing nombrado
  2. la cadena de transformación, como anclas de coincidencia: qué se convierte en qué
  3. la lista de activos, con nombres de archivo reales, para que ningún tiempo se bloquee por una pieza faltante
  4. las condiciones de fallo para esta película específica, no genéricas
  5. los comandos de verificación, para que la afirmación "funciona" tenga una salida detrás

2. El motor

animations-v3.jsx es el tiempo de ejecución de composición de Claude Design. Lee su encabezado una vez, luego trabaja desde esta tabla.

Nunca edites animations-v3.jsx. Su propio encabezado dice que volver a ejecutar copy_starter_component lo sobrescribe, por lo que cada cambio realizado allí se pierde en la siguiente copia del host. El apalancamiento está en el brief.

UsarNunca usar
Easing.easeOutExpo y las curvas nombradascubic-bezier(...), cualquier cadena CSS
OM_SCENES secciones nombradas con durnúmeros de fotograma absolutos como la estructura
CUES.SectionName para clave de coreografíareloj de pared, setTimeout, requestAnimationFrame
animate({from, to, start, end, ease})(T)useEffect pintando cualquier cosa visible
interpolate([...], [...], ease)(T)keyframes CSS ejecutándose por su cuenta
<Shot from to> para un corte bruscomontaje condicional por sección
un <CompositionStage> como la única raíz exportableel atributo exportable en cualquier otro lugar

El modelo en una oración: la animación es un árbol de un elemento renderizado como una función pura de un eje de tiempo autorado, por lo que nada se monta o desmonta en un límite de sección y cualquier objeto puede persistir, moverse o transformarse a lo largo de toda la película mediante interpolación ordinaria. Eso convierte cero cortes y un objeto transformándose a lo largo de la película en los valores predeterminados del motor en lugar de cosas por las que un brief tiene que luchar.

<CompositionStage width={1080} height={1920} bg="#161309"
                  scenes={window.OM_SCENES} playback={window.OM_PLAYBACK}>
  <Piece />          // UN componente, toda la película
</CompositionStage>
useComposition() -> { T, CUES, time, duration, authoredTotal, playing }

OM_SCENES y OM_PLAYBACK son literales de cadena JSON en etiquetas <script> en línea simples del documento principal, no type="text/babel", pasados sin modificar. Cada entrada necesita un desc, una oración simple, porque el usuario lo lee en el popover de la línea de tiempo. Nunca establezcas nat manualmente.

<script>window.OM_SCENES = '[{"name":"Strike","dur":2.5,"desc":"La marca aterriza y lanza color por el suelo"}]';</script>
<script>window.OM_PLAYBACK = '{"mode":"loop"}';</script>

Easing, la lista completa. linear; easeIn/easeOut/easeInOut para Quad, Cubic, Quart, Expo, Sine; easeInBack, easeOutBack, easeInOutBack; easeOutElastic. Back y elastic sobrepasan, por lo que no pertenecen cerca de un logotipo o un archivo de marca oficial.

Renderiza solo desde T. El exportador busca cada fotograma con una confirmación síncrona y puede serializar el escenario en el momento en que la búsqueda regresa, por lo que cualquier cosa pintada desde un efecto o un bucle de animación privado se exporta obsoleto.

Subtítulos solo cuando se soliciten. Renderiza <Captions> solo cuando el brief o el perfil de video de la persona solicite subtítulos incrustados. Muchas personas agregan los suyos propios después, y un subtítulo incrustado lo arruina. El texto fijo en pantalla es un elemento normal colocado donde la composición lo desea.

Establece bg al fondo de la película, nunca al valor predeterminado #0b0b0e, y nunca #000000. Un mundo diseñado necesita un lugar donde la luz pueda desvanecerse.

Define exactamente tres o cuatro ayudantes de movimiento desde el principio y no uses easing ni transformación fuera de ellos:

MOTION.slam    Easing.easeOutExpo     llegadas e impactos
MOTION.snap    Easing.easeOutBack     fichas aterrizando, sobrepaso limitado al 6%
MOTION.drive   Easing.easeInOutQuart  viaje, luz, deriva
MOTION.settle  Easing.easeOutQuart    la resolución final

3. Asigna las referencias. Nunca las promedies.

Cada referencia recibe un trabajo y una lista explícita de no copiar. Sin la línea "no promedies las referencias", el modelo combina los estilos en una papilla.

ReferenciaSu único trabajoNunca tomar
una película que la persona nombra para movimientotransformación, profundidad, contraste de escalasu paleta, su marca
una película que la persona nombra para cámaracámara y easing: los eventos, la pausa, la resoluciónsu color, su producto
el material propio de la marcaidentidad, tipografía, la marca exactasus diseños de interfaz como plantilla

Escríbelo en el prompt con esta forma:

Usa X como la autoridad PRINCIPAL para: ritmo, moderación, anclas de coincidencia, contraste
de escala, empuje y tirón de cámara, profundidad, la pausa final.
Usa Y solo para: identidad monocromática, tipografía, logotipo exacto, claridad.

No copies el diseño de X. No introduzcas el color de X. No promedies las
referencias.

Si la persona tiene varias películas terminadas en el mismo motor, lee al menos tres y pregunta qué es lo mismo en todas ellas: cómo se declara una lista de escenas, dónde se expresa la cadena de transformación, cómo se sincroniza una entrada contra la cosa que golpea, cómo se construyen los últimos tres segundos. Las constantes son el flujo de trabajo. Cualquier cosa presente en solo una es el disfraz de esa película.

Construye por etapas, y pon una compuerta entre ellas. Construye los primeros cinco a ocho segundos. Renderiza. Mira una hoja de contactos. Solo entonces continúa. Una película de veinte segundos construida antes de que nadie la vea es una película de veinte segundos que nadie puede arreglar, porque el defecto está en el concepto y el concepto ahora es estructural.

4. Construye el kit antes de escribir el prompt

Un prompt largo y detallado sin activos reales sigue devolviendo rectángulos grises que representan texto y una forma dibujada a mano en lugar de la marca real, porque los marcadores de posición son lo único que un modelo puede dibujar sin nada real que colocar.

Claude Code construye el kit. Claude Design lo anima. Esa división es la tubería.

  1. Mide la referencia a 1:1, un archivo, nunca una hoja de contactos. Anota tiempos, color de fondo, luminancia media, saturación media, y qué ocupa físicamente el fotograma.
  2. Recepción de marca. Las marcas oficiales suelen vivir en las pautas de la propia marca o en la página de prensa, mezcladas con sus ejemplos de "no hagas esto". Renderiza una hoja de contactos clara y oscura y mira antes de nombrar cualquier cosa.
  3. Reconstruye la UI del producto como DOM vivo con cadenas reales, luego captúrala a 3x a 5x en placas planas con un navegador sin cabeza. Las interfaces se reconstruyen. El arte del mundo se renderiza y compone. Nada se falsifica.
  4. Corta partes, no pantallas. Una pantalla completa es un bloque sólido, y un bloque sólido no puede animarse, solo deslizarse. Envía una carpeta parts/ de objetos transparentes aislados a 1600px y más: cada botón, chip, nodo, barra, mosaico, insignia, icono.
  5. Divide la marca en sus propias capas. Un SVG oficial se divide en capas que se apilan con precisión de píxeles. Verifícalo: apilado contra el original, la diferencia máxima en cualquier píxel debe ser aproximadamente 1 de 255, que es antialiasing. Luego la película ensambla la marca en lugar de cortar a ella.
  6. Optimiza. Mantén cada archivo pequeño (unos pocos cientos de KB) y todo el kit unos pocos MB, para que sobreviva al ser llevado a un proyecto de Claude Design.
  7. Abre cada archivo y registra sus defectos en KIT.md. Botones recortados, falta alfa, relación de aspecto incorrecta, emblemas blancos que desaparecen sobre un fondo blanco. Cada defecto que encontraste va en el prompt bajo DEFECTOS CONOCIDOS DEL KIT con lo que la película debe hacer al respecto. Si no encontraste ninguno, di que abriste cada archivo y no encontraste ninguno.

La relación de aspecto es una clase de defecto real. Renderizar chips de 1200x800 píxeles en una caja de 224x160 estira cada uno horizontalmente en un 7%, que es lo suficientemente sutil como para sobrevivir a la revisión y está mal en cada fotograma.

Los artefactos publicados pueden ejecutarse bajo una CSP estricta que bloquea hosts externos, por lo que nada en un kit debe apuntar a un CDN. Todo es un archivo de proyecto o una URI de datos.

5. Escribe OM_SCENES primero

Es el esquema, y los nombres de las secciones se convierten en el vocabulario de señales que habla el resto del brief. Seis secciones es una buena película. Diez es una presentación de diapositivas.

Cada desc es una oración que nombra un evento físico, no un estado de ánimo. "El triángulo se convierte en una apertura, la cámara lo atraviesa y retrocede a una vista previa completa del producto" es un desc. "Una sensación de velocidad y posibilidad" no lo es.

6. La cadena de transformación, como anclas de coincidencia

Nombra el único objeto que lleva la película y prohíbe romperlo.

Cada escena hereda un objeto visible, forma, línea o vector de movimiento de la escena anterior. Nunca: escena se desvanece, fondo vacío, siguiente escena aparece. El tiempo entrante es visible mientras el saliente todavía está 25 a 50% visible.

Por ejemplo, un círculo de color que es la marca, luego un nodo de lección, luego la cosa en la que cada nombre colapsa, luego la marca de nuevo. O un título de canción impreso en cada superficie del producto, de modo que la misma canción se mueve de una barra a un escritorio a un teléfono.

La regla de color que viene con esto. Un objeto que se convertirá en una capa oficial se corrige al color de esa capa, nunca al color publicado de la marca. Los archivos de marca y las páginas de pautas de marca a menudo discrepan en algunos valores, y corregir al valor de la pauta cambia el color exactamente en el fotograma que no debe ser visible. El archivo gana sobre la página de pautas.

7. El prompt

Completa esto. No elimines nada estructural. Un brief que es largo y no contiene nombres de archivo es el brief incorrecto.

Estás dirigiendo un comercial de <N> segundos <vertical|apaisado> para <MARCA>,
construido en el motor de composición animations-v3. Cinematográfico. Pocos objetos, grandes, iluminados.

FORMATO. ESCRIBELO LITERALMENTE.

  <CompositionStage width={<W>} height={<H>} bg="<hex del fondo>"
                    scenes={window.OM_SCENES} playback={window.OM_PLAYBACK}>

<W> de ancho por <H> de alto. Si tu composición es <más ancha que alta | no
<W>x<H>> has fallado antes de que se juzgue cualquier otra cosa.

LA ÚNICA LEY

Cada objeto en pantalla es un archivo de la lista a continuación. La línea de tiempo nunca dibuja una
pantalla de <MARCA>, nunca dibuja la marca, nunca coloca texto con un rectángulo
gris, nunca aproxima imágenes con un degradado. Coloca, enmascara, recorta, ilumina
  y mueve esos archivos.

  Si un tiempo necesita un objeto que el kit no contiene, dilo y detente. No
  sustituyas un div. Si no puedes resolver las rutas, dímelo antes de construir
  cualquier cosa en lugar de dibujar reemplazos.

  REFERENCIAS

  <un trabajo por referencia, con una lista de no copiar. Luego: no las promedies.>

  LOS ACTIVOS

    <cada archivo, su tamaño en píxeles y una línea sobre para qué sirve. Nombra qué
     partes a nivel de elemento existen y qué se supone que deben hacer por sí mismas.>

  EL LÍMITE, Y LO QUE EXCLUYE

  <las exclusiones de género, no notas de oficio. Las exclusiones de género son lo que el modelo
  ya entiende: seis diapositivas desconectadas, un recorrido de producto SaaS, un montaje
  de panel, una presentación de conferencia, un tutorial de desarrollador, una grabación de pantalla
  de navegador, un muro de logotipos de tecnología, un anuncio genérico de IA futurista, un flujo
  de aplicación, una secuencia de carga de datos, un fondo de rotación de logotipos.>

  LA CADENA DE TRANSFORMACIÓN: ANCLA DE COINCIDENCIA ÚNICA

  <La forma exacta de la cadena de transformación, de la Sección 6 de esta misma habilidad.>

  EL KIT

  <Un enlace a la carpeta del kit o la lista de archivos arriba.>

  DEFECTOS CONOCIDOS DEL KIT

  <Cada defecto de la Sección 4, paso 7.>

  PLACA DE REFERENCIA DE LUZ DE FONDO

  <Una descripción del tamaño de la placa de fondo y su color basado en la referencia medida.>

  ESTRUCTURA DE LA PELÍCULA

  <nombrar la escena, el evento físico, la duración, qué sucede con el objeto en ejecución,
  qué activo se usa. Un párrafo por sección, con la misma sangría que las reglas del motor>

  EASING Y MOVIMIENTO

  <las cuatro definiciones del ayudante de movimiento en código, exactamente como en la Sección 2>

  VERIFICACIÓN

    cd build  &&  for f in frames/*.png; do identify "$f" | head -1; done

  La tubería de verificación completa. Esta comienza desde el directorio de construcción y
  emite la geometría de cada fotograma para confirmar que la película renderiza a
  <W>x<H>, no a 1080x1920 y luego se escala, y que cada fotograma es distinto del
  que está antes y después.

8. Una vez que aterriza en el Design

La persona arrastra los archivos a Claude Design en el orden de START-HERE.md. Ese archivo es la única instrucción que tiene. Si el primer mensaje no contiene el motor, el modelo de Design no sabe qué runtime se le pide que use y escribe contra una biblioteca genérica de React que no existe. Siempre pon animations-v3.jsx primero en el orden de subida.

El prompt que escribiste en PROMPT.md es pegado como el texto del mensaje inmediatamente después de que los archivos se adjuntan. Si la persona sube los archivos y pega su propio texto, el prompt está roto. No escribas el prompt en el chat. Está en el archivo.

El enlace del proyecto de Design y la URL compartida se escriben en la interfaz de la película terminada.

9. Lo que no es esto

Esto esEsto no es
un plano de producción a partir de un briefuna sugerencia de concepto, un moodboard, una idea
un archivo de proyecto ejecutableuna descripción textual de una animación
una cadena de verificación con una salida comprobableuna promesa de que "se ve bien"
una lista de activos con defectos conocidosuna carpeta de imágenes sin mantenimiento

10. Fin

Skills relacionados