Ice Motion Director

Lingua

Installa

Ice Motion Director

Un regista di motion design e video per il tuo agente di coding. Pianifica, scrive il video come codice, lo renderizza e lo verifica.

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

Open source, Apache-2.0, per Claude Code, Codex, Cursor, Gemini CLI e oltre 40 altri agenti.

Installa per il tuo agente e il tuo sistema

Ice, la mascotte di Ice Motion Director: un cubetto di ghiaccio voxel con un basco blu navy da regista, seduto su una sedia da regista in legno con un ciak in mano

Una richiesta, un percorso

Una skill router legge la tua richiesta e il tuo progetto, poi la affida a uno solo dei sei workflow.

Prova il router

«Taglia questa registrazione del podcast in tre short verticali con sottotitoli in arabo.»

ice-editFornisci footage da tagliare

ice-film

Un video creato da zero. Un MP4 finito più un report di consegna.

ice-explainer

Una voce spiega qualcosa. Un explainer narrato con sottotitoli.

ice-remake

Fallo come questo. Un nuovo video in quello stile, con i tuoi contenuti.

ice-edit

Un montaggio del tuo footage. Il montaggio, i sottotitoli, le versioni verticali.

ice-lottie

Lottie e motion per UI. Lottie JSON o SVG animato più le consegne per gli sviluppatori.

ice-ideas

Idee prima di costruire. Una serie di concept e un copione, pronti da costruire.

Tu

/ice-motion-director:ice Crea un video di lancio di 20 secondi per la mia app di appunti. Ecco il sito: <il tuo URL>

Ice

Ho guardato il tuo sito e le regole pubblicitarie del tuo settore. Restano aperte due decisioni; in ognuna la prima opzione è quella che ti consiglio.

  1. Dove andrà in onda?Verticale, per i socialOrizzontale, per il sitoQuadratoTutti e tre
  2. Serve una voce?Musica e testo a schermoUna voce fuori campoVoce e sottotitoliMuto

Poi propongo, scrivo, disegno lo storyboard e costruisco. Se ci sei, vedi gli style frame una volta prima della build completa.

/ice-04-storyboard

Scheda di revisione: storyboard

Cosa è stato fatto
Opzioni e vincitrice
Tre aperture valutate. Ha vinto la B: il prodotto è in scena dal primo secondo.
Note del critico
L'inquadratura 5 dura troppo; accorciata per stare sul tempo.
Ancora aperto
Chiusura in corallo o blu navy.
Prossimo passo
Scrivi «approvato, vai avanti» per avviare /ice-05-look

Sessione di esempio scritta per questa pagina.

Un solo prompt, o ogni fase

Per tutti

In Claude Code, inizia il primo messaggio con /ice-motion-director:ice, poi descrivi il video con parole tue, in breve o nei dettagli; il comando garantisce che parta il regista, anche se hai installato altre skill video. Ice prima studia la tua attività, poi chiede ogni decisione che il prompt lascia aperta: quattro opzioni per domanda con quella consigliata per prima, al massimo quattro domande per messaggio, e più messaggi quando le decisioni aperte sono tante. Non chiede nulla se il prompt copre già tutto, o se scrivi «non chiedere»; altrimenti aspetta le tue risposte, perché il silenzio non viene mai preso per un sì. Poi, solo se ci sei per rispondere, un'anteprima (gli style frame o l'animatic), e da lì procede fino al file finale senza altre domande. Man mano che ogni fase si conclude ti invia due righe e i suoi fotogrammi senza aspettare una risposta, così una tua nota può raggiungerlo a metà strada. Ogni decisione presa viene registrata e spiegata nella nota di consegna.

Per chi vuole guidare

Esegui una fase alla volta, da /ice-01-brief a /ice-10-deliver (in Claude Code la forma che funziona sempre è /ice-motion-director:ice-01-brief). Ogni fase si chiude con una scheda di revisione: cosa è stato fatto, le opzioni e perché ha vinto una, le note del critico, le scelte ancora aperte. Chiedi modifiche tutte le volte che vuoi; scrivi «approvato» per bloccare una fase, o «approvato, vai avanti» per bloccarla e avviare la successiva. /ice-status ti dice a che punto sei.

La lunghezza del prompt cambia chi prende ogni decisione, mai la qualità. Puoi passare da un modo all'altro quando vuoi: scrivi un comando di fase a metà lavoro, oppure /ice per lasciarlo finire da solo.

Guarda le dieci fasi

Dieci fasi, ogni video

Ogni percorso poggia su un'unica spina dorsale di dieci fasi, come lavora una casa di produzione. I numeri restano gli stessi; l'ordine cambia con il tipo di video.

Tipo di video
Dimensione del lavoro

Al centro: Storia. L'ordine predefinito. 04 e 05 girano in parallelo, poi la 08a si realizza mentre la 07 costruisce, e la 08b mixa sulla bozza.

  1. brief

  2. concept

  3. copione

  4. storyboardlook

  5. animatic

  6. buildaudio

  7. mix

  8. revisione

  9. consegna

Si eseguono tutte e dieci le fasi, in quest'ordine. Due blocchi sullo stesso passo girano in parallelo se il tuo agente ha sub-agenti, uno dopo l'altro se non li ha: 04 storyboard con 05 look, poi 08a audio mentre la 07 costruisce; la 08b mixa sulla bozza. Alla fase 10, ogni lingua e ogni formato si renderizzano in parallelo.

Fase 01, brief

Prima la ricerca: il brief sull'attività (cos'è, pubblico, verità del prodotto, mercato e concorrenti, identità del brand e materiale reale, campagne in corso, tono), il piano del materiale di brand e le regole pubblicitarie di settore e piattaforma; poi il brief di progetto e le domande su ogni decisione aperta: quattro opzioni ciascuna, al massimo quattro per messaggio, più messaggi se serve.

Artefatti principali ice/BRIEF.mdice/research/COMPLIANCE.mdice/assets/brand-sheet.jsonice/DIRECTION.md

Regole da ice-direction (raccolta), ice-assets

A questa dimensione Spina completa, squadra ridotta, giri di revisione secondo i livelli di squadra di ice-film.

Cosa significa la fase 01 in ogni percorso
ice-filmbrief
ice-explainerbrief
ice-remakebrief più analisi del riferimento
ice-editbrief più acquisizione
ice-lottiebrief
ice-ideasbrief

Nessun video uguale a un altro

Template e demo sono riferimenti, mai punti di partenza predefiniti. Un video deve differire dal template incluso più vicino su almeno quattro assi su sei prima di andare avanti. Un look scelto da te (un riferimento, uno stile con nome, l'identità del tuo brand) è esentato sugli assi che fissa.

Prova la regola. Segna cosa cambia il tuo video rispetto al template più vicino:

2 su 6

Troppo vicino al suo template. Il video torna alla regia.

  • Ricerca aggiornata a oggi

    Ogni video parte da una ricerca nuova costruita solo dal tuo brief. Un termine di ricerca che non riconduce al tuo brief viene scartato prima di partire.

  • Una proposta divergente

    Diverse direzioni, almeno due inaspettate, giudicate da un critico separato.

  • Un'impronta per ogni video

    Palette, tipografia e struttura di ogni video finito vengono salvate sul tuo computer, così il prossimo non può ripeterle.

  • Il controllo del look predefinito

    Blu e viola ovunque, senza un motivo nel brief, fanno fallire il controllo del video.

Chi costruisce non si giudica mai da solo

Ruoli critici separati esaminano storyboard, fotogrammi, movimento, audio e il file esportato. Un video affronta ogni controllo in quest'ordine.

Ice esamina una striscia di fotogrammi con una lente voxel, il ciak sotto il braccio

  1. Prima della build

    Lint dello storyboard e lint pre-rendering, poi un provino a contatto prima di qualsiasi rendering.

    Verifica storyboard e piano

  2. Fotogrammi e giunture

    Controlli su fotogrammi e giunture, densità di movimento e tempi morti, e il controllo di mestiere sul render stesso, così niente si blocca, salta o manca.

    Verifica ogni fotogramma

  3. La scansione anti-slop

    Le scansioni di slop e dell'effetto PowerPoint scovano il look da IA di serie prima di te.

    Verifica il look

  4. Il controllo del look predefinito

    Un video dominato da blu e viola, senza un motivo nel brief, non passa.

    Verifica la palette

  5. Distanza e impronta

    Distanza dai template e controllo dell'impronta rispetto ai tuoi video precedenti.

    Verifica somiglianza

  6. Parole e audio

    Validatori di sottotitoli e sincronia, controlli di loudness e specifiche sul file esportato, e un audit del mix che dimostra che ogni effetto sonoro si sente, con una breve lista per le tue orecchie.

    Verifica il file esportato

  7. Lo sguardo di un estraneo

    Uno spettatore nuovo che non ha mai visto il brief deve capire il video, un video di marca deve leggersi come la sua marca in fotogrammi a caso, e il climax viene confrontato con un riferimento.

    Verifica lo spettatore

  8. La nota di consegna

    Approvazione del rendering e un report di consegna in cui ogni affermazione ha numeri misurati.

    Verifica ice/review/NOTE.md

I controlli misurano il video renderizzato stesso: ritmo, profondità, finitura, color grading, loghi fissi, la luce su chi parla e se ogni effetto sonoro si sente. Ogni affermazione del report di consegna è accompagnata da numeri misurati, in ice/review/NOTE.md.

Ogni video è codice

HTML, CSS, GSAP, Remotion, Lottie o FFmpeg. Un video si renderizza sempre allo stesso modo, su un normale portatile, senza GPU e senza modelli video a pagamento.

Niente viene generato come footage di repertorio. Testi, numeri e loghi sono sempre impostati nel codice, esattamente come li hai approvati. Il motore si sceglie video per video:

  • HyperFrames
  • Remotion
  • canvas HTML con Playwright e FFmpeg
  • Three.js
  • Lottie
  • p5
  • solo FFmpeg

I brand reali hanno il loro materiale reale

Quando un video parla di un'azienda, un prodotto o un'app reali, Ice fa ricerca e raccoglie il materiale vero: acquisizioni dal vivo del sito e dell'app, brand kit ufficiali, colori e font letti dal sito stesso, loghi usati senza modifiche. Il look di un brand non viene mai indovinato; quando il materiale non si trova, Ice lo dice e ti chiede. Nessuna riga «non ufficiale» e nessuna etichetta AI viene impressa nel video: per un concept su un brand per cui non lavori, quella riga va nella nota di consegna e nella didascalia suggerita per il post.

your-project/  ice/    state.jsonpercorso, fase corrente, timestamp    BRIEF.mdogni voce cita la sua fonte    DIRECTION.mdogni decisione, le sue opzioni e il suo motivo    research/note di ricerca datate    plan/copione, storyboard, piano delle inquadrature, cue sheet    review/NOTE.mdil report di consegna, misurato    renders/final/il video e le sue versioni
Tutto vive in una cartella ice/ nel tuo progetto, così qualsiasi sessione riprende da dove si era fermata l'ultima.

L'arabo è di prima classe

Le regole per l'arabo e per la scrittura da destra a sinistra valgono ogni volta che un video è in arabo o lo mescola con un'altra lingua, fin dalla prima decisione sul testo.

مـخـرج

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

مخرج significa regista. La kashida allunga la parola solo nei punti di giunzione che l'arabo ammette; la riga sotto mescola un nome latino e delle cifre senza rompere l'ordine di lettura.
  • Forme delle lettere e punti in movimento
  • Kashida, allungata nelle giunzioni giuste
  • Isolamento bidi per le righe miste
  • Cifre arabo-indiane o occidentali
  • A capo e sottotitoli in arabo
  • Aree sicure e dimensioni del testo di copertina per l'arabo
  • Scelta del font con verifiche per ogni lingua
  • Il dialetto come impostazione per copioni e voce fuori campo
  • Riconoscimento vocale usato solo per i tempi

156 stili, un comando

Scrivi /ice-style per sfogliare la libreria per famiglia, oppure indica uno stile e l'argomento del video per avviarne uno in quello stile.

Un preset blocca solo la famiglia di look. Brief, ricerca, concept e controlli di qualità girano comunque, quindi il video non è una copia della demo dello stile.

Satellite Briefing

Immagini satellitari o aeree reali, georeferenziate e con licenza pulita, tarate sui toni di un analista...

Ideale per cambiamenti ambientali nel tempo, distanze e scala, inchieste...

Fonte lemo-opuscar (LemoLab)

Avvia un video in questo stile

/ice-style satellite-briefing <di cosa parla il tuo video>

Installa su ogni agente

Una sola riga installa Ice in ogni agente che trova sul tuo computer. Gli agenti principali si installano anche come plugin nativo, e per ogni agente e sistema operativo c'è una procedura di copia manuale.

Qualsiasi agente

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

npx skills add Omar-Tnzxo/ice-motion-director -g --all
  • Installa ogni skill di Ice in ogni agente che trova sul tuo computer, senza domande.
  • Installale tutte: le skill si richiamano a vicenda, quindi sceglierne solo alcune interrompe il lavoro.
  • Richiede Node 22.20 o successivo. Per aggiornare in seguito: npx skills update.

Claude Code

Installalo come plugin da qualsiasi shell.

claude plugin marketplace add Omar-Tnzxo/ice-motion-director
claude plugin install ice-motion-director@ice-motion-director
  • Dentro una sessione: /plugin marketplace add Omar-Tnzxo/ice-motion-director, poi /plugin install ice-motion-director@ice-motion-director.

Claude.ai e Desktop

Apri Customize, Plugins, Add, Add marketplace, e inserisci Omar-Tnzxo/ice-motion-director.

  • Prima attiva Code execution and file creation in Settings, Capabilities.
  • Aggiorna con Check for updates nella pagina del plugin.
  • Cosa funziona lì: brief, ricerca, concept, copioni e storyboard. Il rendering richiede un browser e FFmpeg su un computer, che la sandbox di codice della chat potrebbe non offrire (non verificato): renderizza quindi il video con un agente locale come Claude Code.

Codex

CLI e app.

codex plugin marketplace add Omar-Tnzxo/ice-motion-director
codex plugin add ice-motion-director@ice-motion-director
  • Oppure esegui /plugins in Codex e installalo da lì, poi apri una nuova sessione.
  • Aggiornamento: codex plugin marketplace upgrade ice-motion-director. Nell'app Codex, usa la scheda Plugins.

Cursor

Installa le skill per Cursor.

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

Gemini CLI e Antigravity

Estensione per Gemini CLI e plugin per Antigravity CLI.

gemini extensions install https://github.com/Omar-Tnzxo/ice-motion-director
agy plugin install https://github.com/Omar-Tnzxo/ice-motion-director
  • Aggiorna Gemini con gemini extensions update ice-motion-director; esegui di nuovo lo stesso comando agy per aggiornare Antigravity CLI.
  • App e IDE 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: Command Palette, Chat: Install Plugin From Source, incolla https://github.com/Omar-Tnzxo/ice-motion-director.
  • Aggiornamento: copilot plugin update ice-motion-director.

Qwen Code

Installalo come estensione.

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

Tutti gli altri agenti

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

npx skills add Omar-Tnzxo/ice-motion-director -a <agent>
  • Id degli agenti: windsurf, cline, roo, kilo, opencode, amp, goose, kiro-cli, trae, zed, warp, augment.
  • I percorsi di copia manuale per ogni agente e ogni sistema operativo sono nella matrice di installazione del repository.

Cosa serve sul tuo computer

Il tuo agente controlla questi requisiti per il percorso che scegli e ti dice cosa manca, con l'unico comando per il tuo sistema. I pacchetti e i modelli gratuiti che un percorso richiede li installa da solo a versioni fissate e li indica nella nota di consegna; tutto ciò che è a pagamento o dietro un account viene chiesto prima. Idee e copioni non richiedono nulla. Lottie richiede Node. Ogni video consegnato (video, explainer, remake e montaggi) richiede Node, FFmpeg, un browser e Python 3 con i pacchetti per i controlli di qualità: senza Python un video si può costruire ma non consegnare, perché il controllo di ricchezza non può girare.

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

Note per Windows

  • Ogni comando funziona allo stesso modo in PowerShell e in cmd.
  • Se PowerShell dice che l'esecuzione degli script è disabilitata, usa npx.cmd skills add, oppure consenti gli script per il tuo utente una volta con Set-ExecutionPolicy -Scope CurrentUser RemoteSigned.
  • --all funziona allo stesso modo in PowerShell e in cmd (in cmd, --skill '*' non funziona; scrivilo tra virgolette doppie: --skill "*").
  • In WSL, installa dentro WSL solo se anche il tuo agente gira dentro WSL.
RequisitoComando
Node.js (LTS)brew install node@24
FFmpegbrew install ffmpeg
Chrome o Chromiumbrew install --cask google-chrome
Python 3brew install python
RequisitoComando
Node.js (LTS)nvm, then nvm install --lts
FFmpegsudo apt install ffmpeg
Chrome o 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 o Chromiumsudo dnf install chromium
Python 3sudo dnf install python3
RequisitoComando
Node.js (LTS)sudo pacman -S nodejs npm
FFmpegsudo pacman -S ffmpeg
Chrome o Chromiumsudo pacman -S chromium
Python 3sudo pacman -S python

Le versioni minime esatte sono in skills/ice-engines/references/versions.json. Procedure di copia manuale per ogni agente: la matrice di installazione.

Cosa non fa

  • Non gira riprese dal vero. Monta il footage che fornisci tu e costruisce tutto il resto come motion design in codice.
  • Non è uno studio di CGI fotorealistica o di animazione dei personaggi. Rig complessi dei personaggi, lip sync e 3D fotorealistico pesante sono fuori dalla sua portata; 2D stilizzato, tipografia cinetica, collage, pixel art, disegno a mano e 3D leggero sono il suo terreno naturale.
  • Non è un generatore di video con IA. Immagini, video o voci con IA sono extra facoltativi che puoi chiedere, mai il motore principale. Testi, numeri e loghi sono sempre impostati nel codice.
  • Non inventa fatti sui brand reali. I brand reali hanno il loro materiale reale; quello che non riesce a ottenere, te lo chiede.

Privacy e rete

  • Gira in locale. I video si renderizzano sul tuo computer, con il tuo browser e FFmpeg. Queste skill non caricano nulla.
  • Chiamate di rete, tutte dichiarate. Ricerca web per la regia (tramite lo strumento di ricerca del tuo agente); download di media reali e gratuiti che sceglie da solo (musica, effetti sonori, footage, foto, bandiere, mappe, font) da librerie pubbliche e fonti ufficiali, ciascuno registrato nel tuo progetto con la sua fonte e lo stato della licenza, con i ritratti di personaggi pubblici citati per nome e le bandiere ufficiali cercati tramite Wikidata e Wikimedia Commons, e le tue cartelle di libreria (local_libraries in sources.json) consultate per prime; il pacchetto di effetti sonori CC0 di Ice (128 effetti registrati), scaricato una volta dalla GitHub Release del progetto e verificato con SHA-256; installazione di strumenti e modelli gratuiti a versioni fissate, indicati nella nota di consegna; Google Fonts quando il font scelto viene da lì. Disattiva i download con --offline o ICE_OFFLINE=1, oppure fai in modo che chiedano prima in ~/.ice-motion-director/sources.json. Prima di download e render di grandi dimensioni controlla lo spazio libero su disco e lavora su un'unità che ne ha.
  • Facoltativo, solo su richiesta. Generazione di immagini, video o voci con IA, trascrizione in cloud o TTS. Possono avere un costo e non vengono mai usate senza il tuo via libera.
  • Memoria locale. Un piccolo file di impronte in ~/.ice-motion-director/fingerprints.jsonl salva palette, tipografia e struttura di ogni video finito, così il prossimo non le ripete. Puoi cancellarlo quando vuoi.
  • Nessuna telemetria.
  • Copiato, con la licenza originale
  • Solo idee, riscritte con parole nostre
  • Cartelle non commerciali, licenza propria
  • Incluso con la propria licenza
  • Le skill del fondatore

Tutti i dettagli, cosa è stato usato e dove si trova: CREDITS.md. Testi originali delle licenze: LICENSES/.

Domande frequenti

Ice con cuffie voxel blu navy, entrambe le mani sui padiglioni, il ciak in piedi accanto ai suoi piedi

No. I video sono scritti come codice e renderizzati con un browser e FFmpeg su un normale portatile.

Sì, i video che realizzi sono tuoi. Alcune cartelle incluse chiamate noncommercial/ hanno le licenze non commerciali dei loro autori; i workflow controllano cosa hai indicato sull'uso commerciale del progetto e, nei lavori commerciali, le escludono. Il materiale esterno che trova o che fornisci (filmati, musica, loghi) è elencato con il suo stato di licenza nella nota di consegna; liberare quei diritti prima di pubblicare spetta a te.

ice-engines lo sceglie video per video: HyperFrames, Remotion, canvas HTML con Playwright e FFmpeg, Three.js, Lottie, p5 o solo FFmpeg. Alcune aziende devono acquistare una licenza aziendale di Remotion; la skill ti avvisa se è il tuo caso.

Scrivi «decidi tu» o «non chiedere». Sceglierà, registrerà ogni motivo in ice/DIRECTION.md ed elencherà ogni scelta nel report di consegna, così puoi cambiarne una qualsiasi con una sola risposta. Se semplicemente non rispondi, aspetta: il silenzio non viene mai preso per un sì.

Il tuo agente lo controlla per il percorso che scegli e ti dice cosa manca, con l'unico comando per il tuo sistema. I pacchetti e i modelli gratuiti che un percorso richiede (trascrizione, separazione delle tracce e simili) li installa da solo a versioni fissate e li indica nella nota di consegna; tutto ciò che è a pagamento o dietro un account viene chiesto prima. Idee e copioni non richiedono nulla. Lottie richiede Node. Ogni video consegnato richiede Node, FFmpeg, un browser e Python 3.

Da parte tua: un prompt che in Claude Code inizia con /ice-motion-director:ice, poi le domande su ogni decisione aperta (quattro opzioni ciascuna, al massimo quattro per messaggio, nessuna se il prompt copre tutto o se scrivi «non chiedere») e, se ci sei, un'anteprima, dove ascolti anche due o tre vere opzioni musicali messe sul video e ne scegli una (tre, a meno che tu non imposti music_options a 2 in sources.json). Mentre lavora, ogni fase ti arriva come due righe e i suoi fotogrammi, così puoi intervenire a metà strada. Dietro le quinte, il tuo agente esegue tutte e dieci le fasi con diversi agenti di supporto, quindi anche uno spot breve richiede un po' di tempo e consuma una parte del tuo piano molto più grande di una risposta in chat. Se il tuo agente raggiunge un limite di utilizzo a metà, scrivi /ice più tardi: riprende da ice/state.json dove si era fermato.

Sì. Ice Motion Director è open source con licenza Apache-2.0. Le cartelle chiamate noncommercial/ e vendor/hypit/ mantengono le proprie licenze, indicate al loro interno.

Dai un regista al tuo agente

Incolla una riga, poi chiedi un video con parole semplici. Ice lo porta dal brief alla consegna e ti mostra il lavoro a ogni passo che vuoi vedere.

npx skills add Omar-Tnzxo/ice-motion-director -g --all
Ice tiene il ciak aperto, pronto a dare l'azione