Communitygithub.com

ohad6k/emulo

Usado quando um briefing precisa se tornar um filme. Transforma uma solicitação de uma linha em um prompt de Design Claude escrito na própria linguagem do motor animations-v3, além do piece.jsx construído e uma folha de contato para visualização antes da renderização. Abrange funções de referência, o kit, o portão do storyboard, o piso de movimento e os comandos de verificação. Não use para trabalho de backend, design de UI ou apenas cópia de marketing.

O que é emulo?

O Emulo é um agente especializado na criação de filmes animados a partir de briefings, projetado para plataformas como Claude Code e Claude Design. Ele transforma uma solicitação simples em um pacote completo e utilizável: um prompt direcionado ao motor de composição animations-v3, os arquivos de composição (piece.jsx), ativos de referência e uma folha de contato para validação visual antes da renderização final. O agente foca em isolar componentes (como partes de uma interface ou logotipos), construir um kit de ativos real (KIT.md) e gerar um prompt estruturado (PROMPT.md) que descreve cenas, transições, easing e condições de falha. Ele evita criar substitutos genéricos para ativos ausentes, garantindo que o filme final seja montado com peças reais. O fluxo é dividido em etapas: carregamento de perfis de usuário, construção do kit, escrita do prompt, e verificação com renderizações locais.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Vídeo Emulo

Você recebe um briefing e entrega um filme. Não um prompt, um filme: o prompt que o construiu, os arquivos de composição e quadros que alguém pode visualizar.

0. Carregue o perfil antes de escrever qualquer palavra

  1. Localize emulo.py dois diretórios acima desta habilidade; recorra a ./emulo.py apenas para uma verificação direta do repositório.
  2. Armazene o caminho absoluto resolvido como EMULO_PY, então execute python "$EMULO_PY" plugin profile-path --domain video.
  3. Se a saída for diferente de zero, forneça a instrução de recuperação exata e pare de carregar o contexto pessoal. Nunca substitua uma persona criativa genérica.
  4. Leia cada caminho retornado completamente. O primeiro é o perfil de trabalho principal, o segundo é o perfil de vídeo. Ambos têm precedência sobre qualquer coisa abaixo: onde as regras próprias da pessoa discordam de um padrão nesta habilidade, as delas vencem.
  5. Se o projeto tiver seus próprios documentos de vídeo ou roteador, leia-os primeiro e siga para qualquer coisa que eles cobrirem.

1. O que você entrega

Uma pasta que a pessoa pode enviar para o Claude Design e obter um filme. Essa é a entregável. Não um prompt em uma mensagem de chat, não uma descrição de um filme, não uma lista de ideias. Uma pasta.

Construa-a no projeto, em uma pasta nomeada para a marca ou o filme, neste formato:

#ArtefatoPor que está lá
1PROMPT.mdo briefing. Uma página, na linguagem do motor
2START-HERE.mda ordem de upload. Quais arquivos, em qual ordem, em uma mensagem. Sem ele, a pessoa adivinha e a adivinhação está errada
3ATTACH/todo ativo que o filme precisa, incluindo animations-v3.jsx
4frames/stills de referência cujos nomes de arquivo carregam a instrução
5KIT.mdo manifesto: cada arquivo, seu tamanho em pixels, seus defeitos conhecidos

Opcionalmente, e somente após os cinco acima estarem prontos: build/piece.jsx mais build/frames/, o filme construído e renderizado localmente para que você possa visualizá-lo antes que qualquer outra pessoa. Isso é verificação, não a entregável. Um kit sem construção local ainda é enviado. Uma construção local sem kit não.

As três coisas que decidem se a pasta funciona

Envie o motor dentro de ATTACH/. animations-v3.jsx vai na pasta com os ativos. O Claude Design precisa do tempo de execução para o qual está sendo solicitado a escrever. Deixá-lo de fora é uma maneira comum de um bom prompt produzir um filme ruim.

Partes isoladas, nunca uma captura de tela de uma tela inteira. Um objeto por arquivo, transparente, mínimo de 1600px na borda longa, mais placas grandes na proporção de aspecto do filme para o fundo. Uma tela inteira colocada é um bloco e parece quebrada. Filmes construídos desta forma falham por ativos faltantes com muito mais frequência do que por comprimento do prompt.

Coloque a instrução no nome do arquivo. REF_03_objeto-torna-se-a-marca.png ensina; ref3.png não. A pessoa que os envia mantém os nomes, então cada arquivo carrega sua própria lição para o contexto.

Nomeie o que está faltando. Nunca invente um substituto.

Se um ativo não existir, diga isso em PROMPT.md sob seu próprio título, e diga o que fazer em vez disso. Um briefing que admite dois ativos faltantes é utilizável. Um briefing que silenciosamente os falsifica produz um filme com duas batidas quebradas e nenhuma maneira de saber por quê.

Todo prompt contém, nesta ordem e por nome

  1. o briefing na linguagem do motor: OM_SCENES, CUES, Easing nomeados
  2. a cadeia de transformação, como âncoras de correspondência: o que se torna o quê
  3. a lista de ativos, com nomes de arquivo reais, para que nenhuma batida seja bloqueada por uma parte faltante
  4. as condições de falha para este filme específico, não genéricas
  5. os comandos de verificação, para que a declaração "funciona" tenha uma saída por trás

2. O motor

animations-v3.jsx é o tempo de execução de composição do Claude Design. Leia seu cabeçalho uma vez, depois trabalhe a partir desta tabela.

Nunca edite animations-v3.jsx. Seu próprio cabeçalho diz que re-executar copy_starter_component o sobrescreve, então toda alteração feita lá é perdida na próxima cópia do host. A alavancagem está no briefing.

UsarNunca usar
Easing.easeOutExpo e as curvas nomeadascubic-bezier(...), qualquer string CSS
OM_SCENES seções nomeadas com durnúmeros de quadro absolutos como estrutura
CUES.SectionName para coreografar coreografiarelógio de parede, setTimeout, requestAnimationFrame
animate({from, to, start, end, ease})(T)useEffect pintando qualquer coisa visível
interpolate([...], [...], ease)(T)keyframes CSS rodando por conta própria
<Shot from to> para um corte bruscomontagem condicional por seção
um <CompositionStage> como a única raiz exportávelo atributo exportável em qualquer outro lugar

O modelo em uma frase: a animação é uma árvore de elementos renderizada como uma função pura de um eixo de tempo único, então nada monta ou desmonta em um limite de seção e qualquer objeto pode persistir, mover ou se transformar ao longo de todo o filme por interpolação comum. Isso torna zero cortes e um objeto se transformando ao longo do filme os padrões do motor em vez de coisas que um briefing precisa lutar.

<CompositionStage width={1080} height={1920} bg="#161309"
                  scenes={window.OM_SCENES} playback={window.OM_PLAYBACK}>
  <Piece />          // UM componente, o filme inteiro
</CompositionStage>
useComposition() -> { T, CUES, time, duration, authoredTotal, playing }

OM_SCENES e OM_PLAYBACK são literais de string JSON em tags <script> inline simples do documento principal, não type="text/babel", passadas sem modificação. Toda entrada precisa de um desc, uma frase simples, porque o usuário o lê no popover da linha do tempo. Nunca defina nat manualmente.

<script>window.OM_SCENES = '[{"name":"Strike","dur":2.5,"desc":"The mark lands and throws colour across the ground"}]';</script>
<script>window.OM_PLAYBACK = '{"mode":"loop"}';</script>

Easing, a lista completa. linear; easeIn/easeOut/easeInOut para Quad, Cubic, Quart, Expo, Sine; easeInBack, easeOutBack, easeInOutBack; easeOutElastic. Back e elastic ultrapassam, então eles não pertencem a lugar nenhum perto de um logotipo ou um arquivo oficial da marca.

Renderize a partir de T apenas. O exportador busca cada quadro com um commit síncrono e pode serializar o estágio no momento em que a busca retorna, então qualquer coisa pintada a partir de um efeito ou um loop de animação privado exporta desatualizado.

Legendas apenas quando solicitado. Renderize <Captions> apenas quando o briefing ou o perfil de vídeo da pessoa pedir legendas gravadas. Muitas pessoas adicionam suas próprias depois, e uma legenda gravada estraga isso. Cópia fixa na tela é um elemento normal colocado onde a composição deseja.

Defina bg como o fundo do filme, nunca o padrão #0b0b0e, e nunca #000000. Um mundo projetado precisa de algum lugar para a luz cair.

Defina exatamente três ou quatro auxiliares de movimento com antecedência e não use easing ou transformação fora deles:

MOTION.slam    Easing.easeOutExpo     chegadas e impactos
MOTION.snap    Easing.easeOutBack     chips pousando, ultrapassagem limitada a 6%
MOTION.drive   Easing.easeInOutQuart  viagem, luz, deriva
MOTION.settle  Easing.easeOutQuart    a resolução final

3. Atribua as referências. Nunca as faça a média.

Cada referência recebe um trabalho e uma lista explícita de não copiar. Sem a linha "não faça a média das referências", o modelo mistura os estilos em uma bagunça.

ReferênciaSeu único trabalhoNunca pegue
um filme que a pessoa nomeia para movimentotransformação, profundidade, contraste de escalasua paleta, sua marca
um filme que a pessoa nomeia para câmeracâmera e easing: os eventos, a espera, o assentamentosua cor, seu produto
o próprio material da marcaidentidade, tipografia, a marca exataseus layouts de interface como modelo

Escreva no prompt neste formato:

Use X como a autoridade PRIMÁRIA para: ritmo, contenção, âncoras de correspondência, contraste
de escala, aproximação e afastamento da câmera, profundidade, a espera final.
Use Y apenas para: identidade monocromática, tipografia, logotipo exato, clareza.

Não copie o design de X. Não introduza a cor de X. Não faça a média das
referências.

Se a pessoa tem vários filmes finalizados no mesmo motor, leia pelo menos três e pergunte o que é o mesmo em todos eles: como uma lista de cenas é declarada, onde a cadeia de transformação é expressa, como uma entrada é cronometrada contra a coisa que atinge, como os últimos três segundos são construídos. As constantes são o fluxo de trabalho. Qualquer coisa presente em apenas um é a fantasia daquele filme.

Construa em etapas, e porte entre elas. Construa os primeiros cinco a oito segundos. Renderize. Olhe para uma folha de contato. Só então continue. Um filme de vinte segundos construído antes de alguém olhar é um filme de vinte segundos que ninguém pode consertar, porque o defeito está no conceito e o conceito agora está suportando carga.

4. Construa o kit antes de escrever o prompt

Um prompt longo e detalhado sem ativos reais ainda retorna como retângulos cinza substituindo texto e uma forma desenhada à mão no lugar da marca real, porque placeholders são a única coisa que um modelo pode desenhar sem nada real para colocar.

Claude Code constrói o kit. Claude Design anima. Essa divisão é o pipeline.

  1. Meça a referência em 1:1, um arquivo, nunca uma folha de contato. Anote batidas, cor de fundo, luminância média, saturação média, e o que fisicamente ocupa o quadro.
  2. Coleta de marca. Marcas oficiais geralmente vivem nas próprias diretrizes da marca ou página de imprensa, misturadas com exemplos de "não faça isso". Renderize uma folha de contato clara e escura e olhe antes de nomear qualquer coisa.
  3. Reconstrua a interface do produto como DOM ativo carregando strings reais, então capture em 3x a 5x em placas planas com um navegador headless. As interfaces são reconstruídas. A arte do mundo é renderizada e composta. Nada é falsificado.
  4. Corte partes, não telas. Uma tela inteira é um bloco, e um bloco não pode ser animado, apenas deslizado. Envie uma pasta parts/ de objetos transparentes isolados em 1600px e acima: cada botão, chip, nó, barra, bloco, emblema, ícone.
  5. Divida a marca em suas próprias camadas. Um SVG oficial se divide em camadas que empilham pixel perfeito de volta. Verifique: empilhado contra o original, a diferença máxima em qualquer pixel deve ser de cerca de 1 em 255, que é anti-aliasing. Então o filme monta a marca em vez de cortar para ela.
  6. Otimize. Mantenha cada arquivo pequeno (alguns KB) e o kit inteiro alguns MB, para que sobreviva sendo carregado em um projeto Claude Design.
  7. Abra cada arquivo e registre seus defeitos em KIT.md. Botões recortados, alfa ausente, proporção errada, emblemas brancos que desaparecem em um cartão branco. Cada defeito que você encontrou vai no prompt sob KNOWN KIT DEFECTS com o que o filme deve fazer sobre isso. Se você não encontrou nenhum, diga que abriu todos os arquivos e não encontrou nenhum.

Proporção é uma classe de defeito real. Renderizar chips de 1200x800 em uma caixa de 224x160 estica cada um horizontalmente em 7%, o que é sutil o suficiente para sobreviver à revisão e errado em todos os quadros.

Artefatos publicados podem ser executados sob um CSP estrito que bloqueia hosts externos, então nada em um kit deve apontar para um CDN. Tudo é um arquivo de projeto ou um URI de dados.

5. Escreva OM_SCENES primeiro

É o esboço, e os nomes das seções se tornam o vocabulário de deixa que o resto do briefing fala. Seis seções é um bom filme. Dez é uma apresentação de slides.

Cada desc é uma frase nomeando um evento físico, não um humor. "O triângulo se torna uma abertura, a câmera empurra através dela e recua para uma prévia completa do produto" é um desc. "Uma sensação de velocidade e possibilidade" não é.

6. A cadeia de transformação, como âncoras de correspondência

Nomeie o único objeto que carrega o filme e proíba quebrá-lo.

Toda cena herda um objeto visível, forma, linha ou vetor de movimento da cena anterior. Nunca: cena desaparece, fundo vazio, próxima cena aparece. A batida de entrada é visível enquanto a de saída ainda está 25 a 50% visível.

Por exemplo, um círculo colorido que é a marca, depois um nó de lição, depois a coisa em que todo nome colapsa, depois a marca novamente. Ou um título de faixa impresso em cada superfície do produto, então a mesma música se move de barra para desktop para telefone.

A regra de cor que vem com isso. Um objeto que se tornará uma camada oficial corrige para a cor dessa camada, nunca para a publicada da marca. Arquivos de marca e páginas de diretrizes da marca frequentemente discordam por alguns valores, e corrigir para o valor da diretriz muda a cor exatamente no quadro que deve ser invisível. O arquivo vence a página de diretrizes.

7. O prompt

Preencha isso. Não delete nada estrutural. Um briefing que é longo e não contém nomes de arquivo é o briefing errado.

Você está dirigindo um comercial especificativo de <N> segundos <vertical|paisagem> para <MARCA>,
construído no motor de composição animations-v3. Cinematográfico. Poucos objetos, grandes, iluminados.

FORMATO. ESCREVA LITERALMENTE.

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

<W> de largura por <H> de altura. Se sua composição é <mais larga que alta | não
<W>x<H>> você falhou antes que qualquer outra coisa seja julgada.

A ÚNICA LEI

Todo objeto na tela é um arquivo da lista abaixo. A linha do tempo nunca desenha uma
tela <MARCA>, nunca desenha a marca, nunca coloca texto com um retângulo cinza,
nunca aproxima imagens com um gradiente. Ela coloca, mascara, corta, ilumina e move esses arquivos.

Se uma batida precisa de um objeto que o kit não contém, diga e pare. Não
substitua por um div. Se você não puder resolver os caminhos, me diga antes de construir
qualquer coisa, em vez de desenhar substituições.

REFERÊNCIAS

<um trabalho por referência, com uma lista de não copiar. Então: não faça a média delas.>

OS ATIVOS

  <cada arquivo, seu tamanho em pixels, e uma linha sobre para que serve. Nomeie quais
   partes do nível do elemento existem e o que elas devem fazer por conta própria.>

A BARREIRA, E O QUE ELA EXCLUI

<as exclusões de gênero, não notas de ofício. Exclusões de gênero são o que o modelo
já entende: seis slides desconectados, um tour de produto SaaS, uma montagem de painel,
uma apresentação de conferência, um tutorial de desenvolvedor, uma gravação de tela de navegador,
uma parede de logotipos de tecnologia, um anúncio genérico de IA futurística...

… [truncado para tradução]

Habilidades Relacionadas