Ice Motion Director

Idioma

Instalar

Ice Motion Director

Um diretor de motion design e vídeo para o seu agente de programação. Ele planeja, escreve o filme como código, renderiza e confere o resultado.

npx skills add Omar-Tnzxo/ice-motion-director -g --all

Open source, Apache-2.0, para Claude Code, Codex, Cursor, Gemini CLI e mais de 40 outros agentes.

Instale para o seu agente e sistema

Ice, o mascote do Ice Motion Director: um cubo de gelo voxel com uma boina de diretor azul-marinho, sentado em uma cadeira de diretor de madeira e segurando uma claquete

Um pedido, uma rota

Uma skill roteadora lê o seu pedido e o seu projeto e o encaminha para exatamente um dos seis fluxos de trabalho.

Teste o roteador

“Corte esta gravação de podcast em três vídeos curtos verticais com legendas em árabe.”

ice-editVocê fornece material para cortar

ice-film

Um filme feito do zero. Um MP4 finalizado e um relatório de entrega.

ice-explainer

Uma voz explica algo. Um vídeo explicativo narrado, com legendas.

ice-remake

Faça igual a isto. Um filme novo nesse estilo, com o seu conteúdo.

ice-edit

Uma edição do seu material. O corte, as legendas, as versões verticais.

ice-lottie

Lottie e animação de interface. Lottie JSON ou SVG animado, com entrega para desenvolvedores.

ice-ideas

Ideias antes de construir. Um conjunto de conceitos e um roteiro, prontos para construir.

Você

/ice-motion-director:ice Faça um filme de lançamento de 20 segundos para o meu app de anotações. O site é este: <sua URL>

Ice

Olhei o seu site e as regras de publicidade do seu setor. Duas decisões ainda estão em aberto; a primeira opção de cada uma é a minha recomendação.

  1. Onde ele vai passar?Vertical, para redes sociaisHorizontal, para o siteQuadradoOs três
  2. Vai ter voz?Música e texto na telaUma locuçãoVoz e legendasSem som

Depois eu apresento a ideia, escrevo, faço o storyboard e construo. Se você estiver por perto, vê os style frames uma vez antes da construção completa.

/ice-04-storyboard

Cartão de revisão: storyboard

O que foi feito
Opções e a vencedora
Três aberturas avaliadas. A B venceu: o produto aparece na tela desde o primeiro segundo.
Notas do crítico
O plano 5 dura demais; foi cortado para caber na batida.
Ainda em aberto
Cartela final em coral ou azul-marinho.
Próximo passo
Diga “aprovado, pode seguir” para começar /ice-05-look

Sessão de exemplo escrita para esta página.

Um prompt só, ou etapa por etapa

Para todo mundo

No Claude Code, comece a primeira mensagem com /ice-motion-director:ice e descreva o filme com as suas palavras, curto ou longo; o comando garante que o diretor entre em ação, mesmo com outras skills de vídeo instaladas. O Ice pesquisa o seu negócio primeiro e depois pergunta sobre cada decisão que o prompt deixou em aberto: quatro opções por pergunta, com a recomendada primeiro, no máximo quatro perguntas por mensagem e mais de uma mensagem quando há muitas decisões em aberto. Ele não pergunta nada quando o prompt já cobre tudo ou quando você diz “não pergunte”; caso contrário, ele espera as suas respostas, porque o silêncio nunca é tomado como um sim. Depois, só se você estiver lá para responder, vem uma prévia (os style frames ou o animatic) e, a partir daí, ele vai até o arquivo final sem mais perguntas. A cada etapa concluída, ele envia a você duas linhas e os stills dela sem esperar resposta, para que uma observação sua possa chegar até ele no meio do caminho. Tudo o que ele decidiu fica registrado e explicado na nota de entrega.

Para quem quer conduzir

Rode uma etapa por vez, de /ice-01-brief a /ice-10-deliver (no Claude Code, a forma que sempre funciona é /ice-motion-director:ice-01-brief). Cada etapa termina com um cartão de revisão: o que foi feito, as opções e por que uma venceu, as notas do crítico e as escolhas ainda em aberto. Peça mudanças quantas vezes quiser; diga “aprovado” para fechar uma etapa ou “aprovado, pode seguir” para fechá-la e começar a próxima. /ice-status mostra onde você está.

O tamanho do prompt muda quem toma cada decisão, nunca a qualidade. Troque de modo quando quiser: digite um comando de etapa no meio de uma execução, ou /ice para ele terminar sozinho.

Ver as dez etapas

Dez etapas, todo filme

Toda rota segue uma mesma espinha de dez etapas, do jeito que uma produtora trabalha. Os números não mudam; a ordem muda conforme o tipo de filme.

Tipo de filme
Porte do trabalho

Começa por: História. A ordem padrão. 04 e 05 rodam lado a lado, depois 08a é feita enquanto 07 constrói, e 08b mixa sobre o rascunho.

  1. briefing

  2. conceito

  3. roteiro

  4. storyboardvisual

  5. animatic

  6. construçãosom

  7. mixagem

  8. revisão

  9. entrega

As dez etapas rodam, nesta ordem. Dois blocos no mesmo passo rodam lado a lado quando o seu agente tem subagentes, e um depois do outro quando não tem: 04 storyboard com 05 visual, depois 08a som enquanto 07 constrói; 08b mixa sobre o rascunho. Na etapa 10, cada idioma e cada proporção renderizam em paralelo.

Etapa 01, briefing

Pesquisa primeiro: o briefing do negócio (o que é, público, verdade do produto, mercado e concorrentes, identidade da marca e material real, campanhas atuais, tom), o plano de material da marca e as regras de publicidade do setor e da plataforma; depois, o briefing do projeto e as perguntas sobre cada decisão em aberto: quatro opções cada, no máximo quatro por mensagem, mais de uma mensagem quando preciso.

Principais artefatos ice/BRIEF.mdice/research/COMPLIANCE.mdice/assets/brand-sheet.jsonice/DIRECTION.md

As regras vêm de intake do ice-direction, ice-assets

Neste porte Espinha completa, equipe enxuta, rodadas de revisão conforme os níveis de equipe do ice-film.

O que a etapa 01 significa em cada rota
ice-filmbriefing
ice-explainerbriefing
ice-remakebriefing e análise da referência
ice-editbriefing e ingestão
ice-lottiebriefing
ice-ideasbriefing

Nenhum filme igual ao outro

Templates e demos são referências, nunca padrões. Um filme precisa diferir do template incluído mais próximo em pelo menos quatro de seis eixos antes de seguir. Um visual que você mesmo escolheu (uma referência, um estilo com nome, a identidade da sua própria marca) fica isento nos eixos que ele fixa.

Teste a regra. Marque o que o seu filme muda em relação ao template mais próximo:

2 de 6

Perto demais do template. O filme volta para a direção.

  • Pesquisa com a data de hoje

    Todo filme começa com uma pesquisa nova, feita só a partir do seu briefing. Um termo de busca que não vem do seu briefing é descartado antes de rodar.

  • Uma apresentação divergente

    Várias direções, pelo menos duas delas inesperadas, avaliadas por um crítico separado.

  • Uma impressão digital por filme

    A paleta, a tipografia e a estrutura de cada filme finalizado ficam guardadas na sua máquina, para que o próximo não as repita.

  • A verificação do visual padrão

    Azul e roxo por toda parte, sem motivo no briefing, reprovam o filme na própria verificação.

Quem constrói nunca dá a própria nota

Críticos separados revisam storyboards, quadros, movimento, som e o arquivo exportado. Um filme passa por todas as verificações nesta ordem.

Ice examinando uma tira de quadros de filme com uma lupa voxel, a claquete presa embaixo de um braço

  1. Antes da construção

    Lint do storyboard e lint pré-renderização, depois uma folha de contatos antes de qualquer renderização.

    Verifica storyboard e plano

  2. Quadros e emendas

    Verificações de quadros e emendas, densidade de movimento e tempo morto, e o portão de acabamento no próprio render, para que nada trave, pule ou falte.

    Verifica cada quadro

  3. A varredura de slop

    Varreduras de slop (conteúdo genérico de IA) e de cara de PowerPoint pegam o visual de IA de prateleira antes de você.

    Verifica o visual

  4. A verificação do visual padrão

    Um filme dominado por azul e roxo, sem motivo no briefing, é reprovado.

    Verifica a paleta

  5. Distância e impressão digital

    Distância do template e verificação da impressão digital contra os seus filmes anteriores.

    Verifica a semelhança

  6. Palavras e som

    Validadores de legenda e sincronia, verificações de loudness e de especificação no arquivo exportado, e uma auditoria de mixagem que prova que cada efeito sonoro é ouvido, com uma lista curta para os seus ouvidos.

    Verifica o arquivo exportado

  7. O olhar de um estranho

    Um espectador novo, que nunca viu o briefing, precisa entender o filme, um filme de marca precisa se ler como a sua marca em quadros aleatórios, e o clímax é comparado com uma referência.

    Verifica o espectador

  8. A nota de entrega

    Aprovação da renderização e um relatório de entrega em que cada afirmação vem com números medidos.

    Verifica ice/review/NOTE.md

As verificações medem o próprio vídeo renderizado: ritmo, profundidade, acabamento, correção de cor, marcas fixas, a luz sobre quem fala e se cada efeito sonoro é ouvido. Cada afirmação do relatório de entrega vem com números medidos, em ice/review/NOTE.md.

Todo filme é código

HTML, CSS, GSAP, Remotion, Lottie ou FFmpeg. Um filme renderiza do mesmo jeito sempre, em um notebook comum, sem GPU e sem modelo de vídeo pago.

Nada é gerado como filmagem de banco de imagens. Textos, números e logos são sempre definidos em código, exatamente como você aprovou. O motor é escolhido para cada filme:

  • HyperFrames
  • Remotion
  • Canvas HTML com Playwright e FFmpeg
  • Three.js
  • Lottie
  • p5
  • Só FFmpeg

Marcas reais recebem o material real delas

Quando um filme é sobre uma empresa, produto ou app real, o Ice pesquisa e reúne o material real: capturas ao vivo do site e do app, brand kits oficiais, cores e fontes lidas do próprio site, logos usados sem alteração. O visual de uma marca nunca é adivinhado; quando não dá para obter o material, ele avisa e pergunta a você. Nenhuma linha “não oficial” e nenhum selo de IA é gravado no filme: num conceito sobre uma marca para a qual você não trabalha, essa linha vai na nota de entrega e na legenda sugerida para o post.

your-project/  ice/    state.jsonrota, etapa atual, horários    BRIEF.mdcada campo cita a sua fonte    DIRECTION.mdcada decisão, suas opções e seu motivo    research/notas de pesquisa datadas    plan/roteiro, storyboard, plano de filmagem, cue sheet    review/NOTE.mdo relatório de entrega, medido    renders/final/o filme e suas versões
Tudo fica em uma pasta ice/ no seu projeto, então qualquer sessão pode continuar de onde a anterior parou.

Árabe com suporte completo

As regras de árabe e de escrita da direita para a esquerda valem sempre que um filme está em árabe ou o mistura com outro idioma, desde a primeira decisão de texto.

مـخـرج

فيلم لتطبيق Notes مدته ٢٠ ثانية

مخرج significa diretor. A kashida estica a palavra só nas ligações que o árabe permite; a linha abaixo mistura um nome latino e números sem quebrar a ordem de leitura.
  • Formas das letras e pontos em movimento
  • Kashida, esticada nas ligações certas
  • Isolamento bidi para linhas mistas
  • Algarismos arábico-índicos ou ocidentais
  • Quebra de linha e legendas em árabe
  • Áreas seguras e tamanhos de texto de capa para árabe
  • Escolha de fonte com verificação por idioma
  • Dialeto como configuração de roteiro e locução
  • Reconhecimento de fala usado só para sincronizar

156 estilos, um comando

Digite /ice-style para navegar pela biblioteca por família, ou diga o nome de um estilo e o assunto do filme para começar um nele.

Um preset trava só a família visual. O briefing, a pesquisa, o conceito e as verificações de qualidade continuam rodando, então o filme não é uma cópia da demo do estilo.

Satellite Briefing

Imagens reais de satélite ou aéreas, georreferenciadas e com licença livre, tratadas até a cara de um analista...

Ideal para mudanças ambientais ao longo do tempo, distâncias e escala, investigações...

Fonte lemo-opuscar (LemoLab)

Começar um filme nele

/ice-style satellite-briefing <sobre o que é o seu filme>

Instale em qualquer agente

Uma linha instala em todos os agentes que encontrar na sua máquina. Os principais agentes também têm um caminho de plugin nativo, e todo agente e sistema tem um caminho de cópia manual.

Qualquer agente

Claude Code, Codex, Cursor, Gemini, Copilot, Windsurf, Cline, Roo, Kilo, OpenCode, Antigravity, Amp, Goose, Kiro, Qwen, Trae, Zed, Warp e outros.

npx skills add Omar-Tnzxo/ice-motion-director -g --all
  • Instala todas as skills do Ice em todos os agentes que encontrar na sua máquina, sem perguntas.
  • Instale todas: as skills abrem umas às outras, então escolher só algumas quebra a execução.
  • Exige Node 22.20 ou mais recente. Para atualizar depois, use npx skills update.

Claude Code

Instale como plugin a partir de qualquer shell.

claude plugin marketplace add Omar-Tnzxo/ice-motion-director
claude plugin install ice-motion-director@ice-motion-director
  • Dentro de uma sessão: /plugin marketplace add Omar-Tnzxo/ice-motion-director e depois /plugin install ice-motion-director@ice-motion-director.

Claude.ai e Desktop

Abra Customize, Plugins, Add, Add marketplace e informe Omar-Tnzxo/ice-motion-director.

  • Antes, ative Code execution and file creation em Settings, Capabilities.
  • Para atualizar, use Check for updates na página do plugin.
  • O que funciona lá: o briefing, a pesquisa, os conceitos, os roteiros e os storyboards. Renderizar exige um navegador e o FFmpeg em um computador, o que o sandbox de código do chat pode não oferecer (não verificado); por isso, renderize o filme com um agente local, como o Claude Code.

Codex

CLI e app.

codex plugin marketplace add Omar-Tnzxo/ice-motion-director
codex plugin add ice-motion-director@ice-motion-director
  • Ou rode /plugins no Codex, instale por lá e abra uma nova sessão.
  • Atualizar: codex plugin marketplace upgrade ice-motion-director. No app do Codex, use a aba Plugins.

Cursor

Instale as skills para o Cursor.

npx skills add Omar-Tnzxo/ice-motion-director -a cursor

Gemini CLI e Antigravity

Extensão para o Gemini CLI e plugin para o Antigravity CLI.

gemini extensions install https://github.com/Omar-Tnzxo/ice-motion-director
agy plugin install https://github.com/Omar-Tnzxo/ice-motion-director
  • Atualize o Gemini com gemini extensions update ice-motion-director; rode o mesmo comando agy de novo para atualizar o Antigravity CLI.
  • App e IDE do Antigravity: npx skills add Omar-Tnzxo/ice-motion-director -a antigravity.

GitHub Copilot

CLI e VS Code.

copilot plugin marketplace add Omar-Tnzxo/ice-motion-director
copilot plugin install ice-motion-director@ice-motion-director
  • VS Code: na Command Palette, escolha Chat: Install Plugin From Source e cole https://github.com/Omar-Tnzxo/ice-motion-director.
  • Atualizar: copilot plugin update ice-motion-director.

Qwen Code

Instale como extensão.

qwen extensions install Omar-Tnzxo/ice-motion-director
  • Atualizar: qwen extensions update ice-motion-director.

Todos os outros

Windsurf, Cline, Roo Code, Kilo Code, OpenCode, Amp, Goose, Kiro, Trae, Zed, Warp, Augment e outros.

npx skills add Omar-Tnzxo/ice-motion-director -a <agent>
  • Ids dos agentes: windsurf, cline, roo, kilo, opencode, amp, goose, kiro-cli, trae, zed, warp, augment.
  • Os caminhos de cópia manual para todos os agentes e sistemas estão na matriz de instalação do repositório.

Do que a sua máquina precisa

O seu agente confere isto para a rota escolhida e avisa o que falta, com o comando exato para o seu sistema. Os pacotes e modelos gratuitos de que uma rota precisa ele instala por conta própria, em versões fixadas, e cita na nota de entrega; qualquer coisa paga ou que exija uma conta é perguntada antes. Ideias e roteiros não precisam de nada. Lottie precisa de Node. Todo filme entregue (filmes, vídeos explicativos, remakes e edições) precisa de Node, FFmpeg, um navegador e Python 3 com os pacotes de verificação de qualidade: sem Python, um filme pode ser construído, mas não entregue, porque a verificação de riqueza não consegue rodar.

RequisitoComando
Node.js (LTS)winget install --id OpenJS.NodeJS.LTS -e
FFmpegwinget install --id Gyan.FFmpeg -e
Chrome ou Chromiumwinget install --id Google.Chrome -e
Python 3winget install --id Python.Python.3.13 -e

Observações para Windows

  • Todos os comandos funcionam igual no PowerShell e no cmd.
  • Se o PowerShell disser que a execução de scripts está desativada, use npx.cmd skills add ou libere scripts para o seu usuário uma vez com Set-ExecutionPolicy -Scope CurrentUser RemoteSigned.
  • --all funciona igual no PowerShell e no cmd (no cmd, --skill '*' não funciona; use aspas duplas: --skill "*").
  • No WSL, instale dentro do WSL só quando o seu agente também roda dentro do WSL.
RequisitoComando
Node.js (LTS)brew install node@24
FFmpegbrew install ffmpeg
Chrome ou Chromiumbrew install --cask google-chrome
Python 3brew install python
RequisitoComando
Node.js (LTS)nvm, then nvm install --lts
FFmpegsudo apt install ffmpeg
Chrome ou ChromiumChrome .deb or sudo snap install chromium
Python 3sudo apt install python3 python3-venv
RequisitoComando
Node.js (LTS)sudo dnf install nodejs
FFmpegsudo dnf install ffmpeg-free
Chrome ou Chromiumsudo dnf install chromium
Python 3sudo dnf install python3
RequisitoComando
Node.js (LTS)sudo pacman -S nodejs npm
FFmpegsudo pacman -S ffmpeg
Chrome ou Chromiumsudo pacman -S chromium
Python 3sudo pacman -S python

As versões mínimas exatas estão em skills/ice-engines/references/versions.json. Caminhos de cópia manual para todos os agentes: a matriz de instalação.

O que ele não faz

  • Ele não filma live action. Ele edita o material que você fornece e constrói todo o resto como motion design em código.
  • Não é um estúdio de CGI fotorrealista nem de animação de personagens. Rigs complexos de personagem, sincronia labial e 3D fotorrealista pesado ficam fora do alcance; 2D estilizado, tipografia cinética, colagem, pixel, desenho à mão e 3D leve são o forte dele.
  • Não é um gerador de vídeo com IA. Imagens, vídeos ou vozes de IA são extras opcionais que você pode pedir, nunca o motor principal. Textos, números e logos são sempre definidos em código.
  • Ele não inventa fatos sobre marcas reais. Marcas reais recebem o material real delas; o que ele não consegue obter, ele pede a você.

Privacidade e rede

  • Roda localmente. Os filmes renderizam na sua máquina, com o seu navegador e o FFmpeg. Estas skills não enviam nada para lugar nenhum.
  • Chamadas de rede, todas declaradas. Pesquisa na web para a direção (pela ferramenta de busca do próprio agente); downloads de mídia real gratuita que ele escolhe por conta própria (música, efeitos sonoros, material filmado, fotos, bandeiras, mapas, fontes) de bibliotecas públicas e fontes oficiais, cada um registrado no seu projeto com a origem e a situação da licença, com retratos de figuras públicas citadas pelo nome e bandeiras oficiais buscados via Wikidata e Wikimedia Commons, e as suas próprias pastas de biblioteca (local_libraries em sources.json) consultadas primeiro; o pacote próprio do Ice de efeitos sonoros CC0 (128 efeitos gravados), baixado uma única vez da GitHub Release do projeto e conferido por SHA-256; instalação de ferramentas e modelos gratuitos em versões fixadas, citados na nota de entrega; Google Fonts quando a fonte escolhida vem de lá. Desative os downloads com --offline ou ICE_OFFLINE=1, ou faça com que perguntem antes em ~/.ice-motion-director/sources.json. Antes de downloads e renders grandes, ele confere o espaço livre em disco e trabalha em uma unidade que tenha espaço.
  • Opcional, só sob pedido. Geração de imagem, vídeo ou voz com IA, transcrição hospedada ou TTS. Podem custar dinheiro e nunca são usadas sem a sua autorização.
  • Memória local. Um pequeno arquivo de impressões digitais em ~/.ice-motion-director/fingerprints.jsonl guarda a paleta, a tipografia e a estrutura de cada filme finalizado, para que o próximo não as repita. Apague-o quando quiser.
  • Sem telemetria.
  • Copiado, com a licença original mantida
  • Só as ideias, reescritas com as nossas palavras
  • Pastas não comerciais, com licença própria
  • Incluído com a própria licença
  • As skills do próprio fundador

Detalhes completos, o que foi usado e onde está: CREDITS.md. Textos originais das licenças: LICENSES/.

Perguntas frequentes

Ice com fones de ouvido voxel azul-marinho, as duas mãos nas conchas, a claquete em pé ao lado dos pés

Não. Os filmes são escritos como código e renderizados com um navegador e o FFmpeg em um notebook comum.

Sim, os filmes que você faz são seus. Algumas pastas incluídas chamadas noncommercial/ têm licenças não comerciais dos autores; os fluxos de trabalho conferem o que o seu projeto respondeu sobre uso comercial e deixam essas pastas de fora em trabalhos comerciais. O material externo que ele encontra ou que você fornece (imagens, música, logotipos) é listado com o status da licença na nota de entrega; liberar esses direitos antes de publicar é com você.

O ice-engines escolhe para cada filme: HyperFrames, Remotion, canvas HTML com Playwright e FFmpeg, Three.js, Lottie, p5 ou só FFmpeg. O Remotion exige licença de empresa para alguns negócios; a skill avisa quando é o caso.

Diga “decida por mim” ou “não pergunte”. Ele vai escolher, registrar cada motivo em ice/DIRECTION.md e listar cada escolha no relatório de entrega, para você mudar qualquer uma delas em uma única resposta. Se você simplesmente não responder, ele espera: o silêncio nunca é tomado como um sim.

O seu agente confere isso para a rota escolhida e avisa o que falta, com o comando exato para o seu sistema. Os pacotes e modelos gratuitos de que uma rota precisa (transcrição, separação de stems e similares) ele instala por conta própria, em versões fixadas, e cita na nota de entrega; qualquer coisa paga ou que exija uma conta é perguntada antes. Ideias e roteiros não precisam de nada. Lottie precisa de Node. Todo filme entregue precisa de Node, FFmpeg, um navegador e Python 3.

Da sua parte: um prompt que começa com /ice-motion-director:ice no Claude Code, depois as perguntas sobre cada decisão em aberto (quatro opções cada, no máximo quatro por mensagem, nenhuma se o prompt cobrir tudo ou se você disser “não pergunte”) e, se você estiver por perto, uma prévia, na qual você também ouve duas ou três opções de música real postas sobre o filme e escolhe uma (três, a menos que você defina music_options como 2 em sources.json). Enquanto roda, cada etapa chega até você em duas linhas e com os seus stills, para que você possa intervir no meio do caminho. Nos bastidores, o seu agente roda as dez etapas com vários agentes auxiliares, então até um anúncio curto leva um bom tempo e consome muito mais do seu plano do que uma resposta no chat. Se o agente bater em um limite de uso no meio, digite /ice mais tarde: ele retoma de onde parou, a partir de ice/state.json.

Sim. O Ice Motion Director é open source sob Apache-2.0. As pastas chamadas noncommercial/ e vendor/hypit/ mantêm as próprias licenças, indicadas dentro delas.

Dê um diretor ao seu agente

Cole uma linha e peça um filme com as suas palavras. O Ice leva do briefing à entrega e mostra o trabalho em cada passo que você quiser ver.

npx skills add Omar-Tnzxo/ice-motion-director -g --all
Ice segurando a claquete aberta, pronto para gritar ação