ice-film
A film made from scratch. A finished MP4 plus a delivery report.
Ice Motion Director
A motion design and video director for your coding agent. It plans, writes the film as code, renders it and checks it.
npx skills add Omar-Tnzxo/ice-motion-director -g --all Open source, Apache-2.0, for Claude Code, Codex, Cursor, Gemini CLI and 40+ more agents.
One request, one route
One router skill reads your request and your project, then hands it to exactly one of six workflows.
Try the router
“Cut this podcast recording into three vertical shorts with Arabic captions.”
ice-editYou supply footage to cut
ice-explainer
A voice explains something. A narrated explainer with captions.
ice-remake
Make it like this. A new film in that style, with your content.
ice-edit
An edit of your own footage. The cut, captions, vertical versions.
ice-lottie
Lottie and UI motion. Lottie JSON or animated SVG plus a developer handoff.
ice-ideas
Ideas before anything is built. A concept set and a script, ready to build.
You
/ice-motion-director:ice Make a 20-second launch film for my note-taking app. Here is the site: <your URL>
Ice
I looked at your site and the ad rules for your field. Two decisions are still open; the first option in each is my recommendation.
- Where will it play?Vertical, for socialWide, for the siteSquareAll three
- Should a voice speak?Music and on-screen textA voiceoverVoice and captionsSilent
Then I pitch, write, storyboard and build. If you are here, you see the style frames once before the full build.
/ice-04-storyboard
Review card: storyboard
- What was made
- Options and the winner
- Three openings considered. B won: the product is on screen from the first second.
- Critic's notes
- Shot 5 holds too long; trimmed to fit the beat.
- Still open
- End card in coral or navy.
- Next
- Say "approved, go on" to start
/ice-05-look
Example session written for this page.
One prompt, or every stage
For everyone
In Claude Code, start your first message with /ice-motion-director:ice, then describe the film in your own words, short or long; the command makes sure the director starts, even with other video skills installed. Ice researches your business first, then asks about every decision your prompt leaves open: four options per question with the recommended one first, at most four questions per message, and more than one message when many decisions are open. It asks nothing when your prompt already covers everything, or when you say "don't ask"; otherwise it waits for your answers, because silence is never taken as a yes. Then, only if you are there to answer, one preview (the style frames or the animatic), and after that it runs to the final file with no more questions. As each stage lands it sends you two lines and its stills without waiting for a reply, so a note can reach it mid-way. Everything it decided is logged and explained in the delivery note.
For people who want to steer
Run one stage at a time, from /ice-01-brief to /ice-10-deliver (in Claude Code the form that always works is /ice-motion-director:ice-01-brief). Each stage ends with a review card: what was made, the options and why one won, the critic's notes, the choices still open. Ask for changes as often as you like; say "approved" to lock a stage, or "approved, go on" to lock it and start the next one. /ice-status shows where you are.
Prompt length changes who makes each decision, never the quality. Switch at any time: type a stage command in the middle of a run, or /ice to let it finish on its own.
Ten stages, every film
Every route runs on one spine of ten stages, the way a production company works. The numbers stay the same; the order changes with the kind of film.
Leads with Story. The default order. 04 and 05 run side by side, then 08a is made while 07 builds, and 08b mixes on the draft.
brief
concept
script
storyboardlook
animatic
buildsound
mix
review
deliver
All ten stages run, in this order. Two blocks on one step run side by side when your agent has sub-agents, one after another when it does not: 04 storyboard with 05 look, then 08a sound while 07 builds; 08b mixes on the draft. At stage 10, each language and aspect ratio renders in parallel.
Stage 01, brief
Research first: the business brief (what it is, audience, product truth, market and competitors, brand identity and real material, current campaigns, tone), the brand material plan and the industry and platform ad rules; then the project brief and the questions on every open decision: four options each, at most four per message, more than one message when needed.
Main artifacts ice/BRIEF.mdice/research/COMPLIANCE.mdice/assets/brand-sheet.jsonice/DIRECTION.md
Rules come from ice-direction intake, ice-assets
At this size Full spine, lean crew, review rounds by the crew tiers in ice-film.
| ice-film | brief |
|---|---|
| ice-explainer | brief |
| ice-remake | brief plus reference analysis |
| ice-edit | brief plus ingest |
| ice-lottie | brief |
| ice-ideas | brief |
No two films look alike
Templates and demos are references, never defaults. A film has to differ from its nearest bundled template on at least four of six axes before it moves on. A look you chose yourself (a reference, a named style, your brand's own identity) is exempt on the axes it fixes.
Try the rule. Mark what your film changes from its nearest template:
2 of 6
Too close to its template. The film goes back to direction.
Research dated today
Every film starts with fresh research built only from your brief. A query term that does not trace to your brief is dropped before it runs.
A divergent pitch
Several directions, at least two of them unexpected, judged by a separate critic.
A fingerprint per film
The palette, type and structure of each finished film are stored on your machine, so the next one cannot repeat them.
The default-look gate
Blue and purple everywhere, with no reason in the brief, fails the film's own gate.
The builder never grades itself
Separate critic roles review storyboards, frames, motion, sound and the exported file. A film meets every gate in this order.
Before the build
Storyboard lint and pre-render lint, then a contact sheet before anything renders.
Checks storyboard and plan
Frames and seams
Frame and seam checks, motion density and dead air, and the craft gate on the render itself, so nothing stalls, jumps or goes missing.
Checks every frame
The slop scan
Slop and PowerPoint-look scans catch the stock AI look before you do.
Checks the look
The default-look gate
A film dominated by blue and purple, with no reason in the brief, fails.
Checks the palette
Distance and fingerprint
Template distance and a fingerprint check against your previous films.
Checks sameness
Words and sound
Captions and sync validators, loudness and spec checks on the exported file, and a mix audit that proves every sound effect is heard, with a short list for your ears.
Checks the exported file
A stranger's read
A fresh viewer who never saw the brief must understand the film, a brand film must read as its brand in random frames, and the climax is compared against a reference.
Checks the viewer
The delivery note
Render approval and a delivery report where every claim comes with measured numbers.
Checks ice/review/NOTE.md
The gates measure the rendered video itself: pace, depth, finishing, grade, fixed marks, the speaker's light and whether every sound effect is heard. Every claim in the delivery report comes with measured numbers, in ice/review/NOTE.md.
Every film is code
HTML, CSS, GSAP, Remotion, Lottie or FFmpeg. A film renders the same way every time, on a normal laptop, with no GPU and no paid video model.
Nothing is generated as stock footage. Text, numbers and logos are always set in code, exactly as you approved them. The engine is picked per film:
- HyperFrames
- Remotion
- HTML canvas with Playwright and FFmpeg
- Three.js
- Lottie
- p5
- FFmpeg alone
Real brands get their real material
When a film is about a real company, product or app, Ice researches it and gathers its real material: live captures of its site and app, official brand kits, colors and fonts read from its own site, logos used untouched. A brand's look is never guessed; when the material cannot be obtained, it says so and asks you. No "unofficial" line and no AI label is burned into the film: for a concept about a brand you do not work for, that line goes in the delivery note and the suggested post caption.
your-project/ ice/ state.jsonroute, current stage, timestamps BRIEF.mdevery slot names its source DIRECTION.mdeach decision, its options and its reason research/dated research notes plan/script, storyboard, shot plan, cue sheet review/NOTE.mdthe delivery report, measured renders/final/the film and its versionsice/ folder in your project, so any session can resume where the last one stopped.Arabic is first class
Arabic and right-to-left rules apply whenever a film is in Arabic or mixes it with another language, from the first text decision.
مـخـرج
فيلم لتطبيق Notes مدته ٢٠ ثانية
- Letterforms and dots in motion
- Kashida, stretched at the right joins
- Bidi isolation for mixed lines
- Arabic-Indic or Western numerals
- Line breaking and Arabic captions
- Safe zones and cover text sizes for Arabic
- Font choice with per-language font checks
- Dialect as a setting for scripts and voiceover
- Speech recognition used for timing only
156 styles, one command
Type /ice-style to browse the library by family, or name a style and what your film is about to start one in it.
A preset locks the look family only. The brief, research, concept and quality gates still run, so the film is not a copy of the style's demo.
Satellite Briefing
Real, licence-clean, georeferenced satellite or aerial imagery graded down to an analyst's...
Best for environmental change over time, distances and scale, investigations...
Source lemo-opuscar (LemoLab)
Start a film in it
/ice-style satellite-briefing <what your film is about>
Films, and how each was made
Films made with Ice Motion Director, each shown with its whole workflow and every round of feedback it took.
Every film gets its own page: the final film, the prompt that made it and every stage from the brief to delivery, with the options weighed, the critic rounds and the checks. They are made one film at a time and published as each one is approved.
Spotify concept ad
Unofficial concept, not affiliated with Spotify
View workflowMohawalat Fahm reel
An unofficial edit made with Ice Motion Director; not an Al Jazeera production. The footage and marks belong to their owners.
View workflowCarney on Alberta
An unofficial test made with Ice Motion Director. It is not an Al Jazeera production and not a Government of Canada production. The footage and marks belong to their owners: the Prime Minister of Canada, Al Jazeera, The Canadian Press, CPAC and AFP.
View workflow
Install on every agent
One line installs into every agent it finds on your machine. The big agents also get a native plugin path, and every agent and OS has a manual copy path.
Any agent
Claude Code, Codex, Cursor, Gemini, Copilot, Windsurf, Cline, Roo, Kilo, OpenCode, Antigravity, Amp, Goose, Kiro, Qwen, Trae, Zed, Warp and more.
npx skills add Omar-Tnzxo/ice-motion-director -g --all - It installs every Ice skill into every agent it finds on your machine, with no prompts.
- Install them all: the skills open each other, so picking only some breaks the run.
- Needs Node 22.20 or newer. Update later with
npx skills update.
Claude Code
Install it as a plugin from any shell.
claude plugin marketplace add Omar-Tnzxo/ice-motion-director claude plugin install ice-motion-director@ice-motion-director - Inside a session:
/plugin marketplace add Omar-Tnzxo/ice-motion-director, then/plugin install ice-motion-director@ice-motion-director.
Claude.ai and Desktop
Open Customize, Plugins, Add, Add marketplace, and enter Omar-Tnzxo/ice-motion-director.
- Turn on Code execution and file creation in Settings, Capabilities first.
- Update with Check for updates on the plugin page.
- What works there: the brief, research, concepts, scripts and storyboards. Rendering needs a browser and FFmpeg on a computer, which the chat's code sandbox may not offer (not verified), so render the film with a local agent such as Claude Code.
Codex
CLI and app.
codex plugin marketplace add Omar-Tnzxo/ice-motion-director codex plugin add ice-motion-director@ice-motion-director - Or run
/pluginsin Codex and install it from there, then start a new session. - Update:
codex plugin marketplace upgrade ice-motion-director. In the Codex app, use the Plugins tab.
Cursor
Install the skills for Cursor.
npx skills add Omar-Tnzxo/ice-motion-director -a cursor Gemini CLI and Antigravity
Gemini CLI extension and Antigravity CLI plugin.
gemini extensions install https://github.com/Omar-Tnzxo/ice-motion-director agy plugin install https://github.com/Omar-Tnzxo/ice-motion-director - Update Gemini with
gemini extensions update ice-motion-director; run the sameagycommand again to update Antigravity CLI. - Antigravity app and IDE:
npx skills add Omar-Tnzxo/ice-motion-director -a antigravity.
GitHub Copilot
CLI and 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, paste
https://github.com/Omar-Tnzxo/ice-motion-director. - Update:
copilot plugin update ice-motion-director.
Qwen Code
Install it as an extension.
qwen extensions install Omar-Tnzxo/ice-motion-director - Update:
qwen extensions update ice-motion-director.
Every other agent
Windsurf, Cline, Roo Code, Kilo Code, OpenCode, Amp, Goose, Kiro, Trae, Zed, Warp, Augment and others.
npx skills add Omar-Tnzxo/ice-motion-director -a <agent> - Agent ids:
windsurf,cline,roo,kilo,opencode,amp,goose,kiro-cli,trae,zed,warp,augment. - Manual copy paths for every agent and every OS are in the install matrix in the repo.
What your machine needs
Your agent checks these for the route you pick and tells you what is missing, with the one command for your system. Free packages and models a route needs it installs on its own at pinned versions and names in the delivery note; anything paid or behind an account is asked first. Ideas and scripts need nothing. Lottie needs Node. Every delivered film (films, explainers, remakes and edits) needs Node, FFmpeg, a browser and Python 3 with the quality-check packages: without Python a film can be built but not delivered, because its richness check cannot run.
| Need | Command |
|---|---|
| Node.js (LTS) | winget install --id OpenJS.NodeJS.LTS -e |
| FFmpeg | winget install --id Gyan.FFmpeg -e |
| Chrome or Chromium | winget install --id Google.Chrome -e |
| Python 3 | winget install --id Python.Python.3.13 -e |
Windows notes
- Every command works the same in PowerShell and cmd.
- If PowerShell says running scripts is disabled, use
npx.cmd skills add, or allow scripts for your user once withSet-ExecutionPolicy -Scope CurrentUser RemoteSigned. --allworks the same in PowerShell and cmd (in cmd,--skill '*'does not work; quote it as--skill "*").- In WSL, install inside WSL only when your agent also runs inside WSL.
| Need | Command |
|---|---|
| Node.js (LTS) | brew install node@24 |
| FFmpeg | brew install ffmpeg |
| Chrome or Chromium | brew install --cask google-chrome |
| Python 3 | brew install python |
| Need | Command |
|---|---|
| Node.js (LTS) | nvm, then nvm install --lts |
| FFmpeg | sudo apt install ffmpeg |
| Chrome or Chromium | Chrome .deb or sudo snap install chromium |
| Python 3 | sudo apt install python3 python3-venv |
| Need | Command |
|---|---|
| Node.js (LTS) | sudo dnf install nodejs |
| FFmpeg | sudo dnf install ffmpeg-free |
| Chrome or Chromium | sudo dnf install chromium |
| Python 3 | sudo dnf install python3 |
| Need | Command |
|---|---|
| Node.js (LTS) | sudo pacman -S nodejs npm |
| FFmpeg | sudo pacman -S ffmpeg |
| Chrome or Chromium | sudo pacman -S chromium |
| Python 3 | sudo pacman -S python |
Exact minimum versions live in skills/ice-engines/references/versions.json. Manual copy paths for every agent: the install matrix.
What it does not do
- It does not shoot live action. It edits footage you supply and builds everything else as motion design in code.
- It is not a photoreal CGI or character-animation studio. Complex character rigs, lip sync and heavy photoreal 3D are outside its range; stylized 2D, kinetic type, collage, pixel, hand-drawn and light 3D are its home.
- It is not an AI video generator. AI images, video or voices are optional extras you can ask for, never the main engine. Text, numbers and logos are always set in code.
- It does not invent facts about real brands. Real brands get their real material; anything it cannot obtain, it asks you for.
Privacy and network
- Runs locally. Films render on your machine with your browser and FFmpeg. Nothing is uploaded by these skills.
- Network calls, all disclosed. Web research for direction (through your agent's own search tool); downloads of free real media it picks on its own (music, sound effects, footage, photos, flags, maps, fonts) from public libraries and official sources, each recorded in your project with its source and license status, with portraits of named public figures and official flags looked up through Wikidata and Wikimedia Commons, and your own library folders (local_libraries in sources.json) searched first; Ice's own CC0 sound-effects pack (128 recorded effects), fetched once from the project's GitHub Release and checked by SHA-256; installs of free tools and models at pinned versions, named in the delivery note; Google Fonts when the chosen font comes from there. Turn the downloads off with
--offlineorICE_OFFLINE=1, or make them ask first in ~/.ice-motion-director/sources.json. Before large downloads and renders it checks free disk space and works on a drive with room. - Optional, only on request. AI image, video or voice generation, hosted transcription or TTS. These may cost money and are never used without your say-so.
- Local memory. A small fingerprint file at
~/.ice-motion-director/fingerprints.jsonlstores the palette, type and structure of each finished film so the next one does not repeat it. Delete it any time. - No telemetry.
42 credited sources
Ice Motion Director merges and rewrites the best open-source motion and video skills into one system. Every source, its author and its license:
- hyperframesheygen-
com, HeyGen, Inc. and contributors Apache-2.0 - hyperframes-
community- heygen-skills com, HyperFrames community contributors Apache-2.0 - reelmimicedenfunf, ReelMimic contributorsMIT
- herk-
edit- nateherkai, Nate Herk and the kit contributorsMIT, plus the Herk Edit Kit Use Permission for pipeline resourceskit - claude-
code- digitalsamba, Digital SambaMITvideo- toolkit - anidoodlealexgreensh, Alex GreenshpunApache-2.0 (NOTICE kept)
- lemo-
opuscar lemomo-ai, LemoLab MIT (code and docs) - huashu-
art- alchaincyf, alchaincyf (花叔 · 花生)MITmotion - mg-
styles- Vincentwei1021, Vincentwei1021MIT15 - motion-
video- echris6, echris6MITkit - product-
launch- AbubakrChan, Abubakr ChanMITmotion - claude-
motion- howseen-design ai, Raphaël Aubry, founder of Howseen MIT - claude-
remotion- haidrrrry, haidrrrryMITskill - motion-
skills iart-ai, iart.ai MIT - motion-
graphics Barty-Bart, Bart MIT (icon paths from Lucide, ISC) - charlie947/
motion- charlie947, Charlie Hills (newsletter, link back requested by the author)MITgraphics- skills - bang-
motion bangtutorial, Bang TutorialMIT - pixel2motionnolangz, Nolan LaiMIT
- motionmaxxingTejashmakwana, Tejas Makwana (FinalMotion)Apache-2.0 (NOTICE kept)
- lottiediffusionstudio, Diffusion Studio Inc.MIT
- explainroovincentsch, Vincent SchmalbachMIT
- video-
use browser-use, Browser Use MIT - claude-
video bradautomates, Bradley BonannoMIT - video-
ad- majedphotos, Majed AlzaabiMITeditor - awesome-
opus5- yihui-5- videos dev, yihui- MIT (list)dev (list); every video and prompt belongs to its creator - awesome-
claude- zhuyansen, zhuyansen (list); listed names and descriptions belong to their authorsCC0 1.0 (list)video- skills - remotion-
dev/ remotion-skills dev, Remotion No license file (Remotion License applies upstream) - remotionremotion-
dev, Remotion Remotion License (source available) - vibe-
motion/ vibe-skills motion, vibe- No license filemotion - imMamdouhaboammar/
motion- imMamdouhaboammar, Mamdouh AboammarProprietary, all rights reservedgraphics- skills - YouTube tutorials du47cp9LccY, vyX-
4ACMmp0, q4okDye8Xw4, ItJb2PFd- Muhamd HelalStandard YouTube licenceME, Xwmf57_bS68, 7LjFsMQAdhk, tpXmHvmZo4Q, xXYS7ypXUlI - YouTube tutorial sv4v8OnjkUg and the author's public asset folderAhmed MaherStandard YouTube licence; the asset folder carries no licence
- YouTube tutorials qDkAbFRDO_M, TXE746k1rbsIsmail Ait toulbaStandard YouTube licence
- YouTube tutorial Vxccy35yxYwAhmed EltananyStandard YouTube licence
- YouTube tutorial 5Npr0d75050Soni Designer (Hossam Abdelrahman)Standard YouTube licence
- YouTube tutorial XjREwYRUEGgChannel name not recordedStandard YouTube licence
- YouTube tutorial 2ePEfR_FBb8Victor GrubbeStandard YouTube licence
- Six public Al Jazeera reels (Al Jazeera Arabic, Al Jazeera 360, Al Jazeera English)Al Jazeera Media NetworkStandard YouTube licence
- onetakefeitangyuan, PatrickPolyForm Noncommercial 1.0.0
- video-
talkcraft Vincentwei1021, Vincent WeiPolyForm Noncommercial 1.0.0 - anything2explainerVincentwei1021, Vincent WeiPolyForm Noncommercial 1.0.0
- hypithypit-
ai, Hypit.AI Hypit Open Source License (Apache-2.0 with added conditions; no commercial redistribution, keep the Hypit name, logo and copyright information) - video-
production- by Omar-studio Tnzxo Apache-2.0 - motion-
interaction- by Omar-studio Tnzxo Apache-2.0 - brand-
identity- by Omar-studio Tnzxo Apache-2.0 - commercial-
motion- by Omar-design Tnzxo Apache-2.0
- Copied, with the original license kept
- Ideas only, rewritten in our own words
- Noncommercial folders, own license
- Vendored with its own license
- The founder's own skills
Full details, what was used and where it lives: CREDITS.md. Original license texts: LICENSES/.
Questions people ask
No. Films are written as code and rendered with a browser and FFmpeg on a normal laptop.
Yes, the films you make are yours. A few bundled folders named noncommercial/ carry their authors' noncommercial licenses; the workflows check your project's commercial-use answer and skip them for commercial work. Outside material it finds or you supply (footage, music, logos) is listed with its license status in the delivery note; clearing those rights before you publish is yours.
ice-engines picks per film: HyperFrames, Remotion, HTML canvas with Playwright and FFmpeg, Three.js, Lottie, p5 or FFmpeg alone. Remotion needs a company license for some businesses; the skill tells you when that applies.
Say "decide for me" or "don't ask". It will choose, log every reason in ice/DIRECTION.md, and list every choice in the delivery report, so you can change any of them in one reply. If you simply do not answer, it waits: silence is never taken as a yes.
Your agent checks it for the route you pick and tells you what is missing, with the one command for your system. Free packages and models a route needs (transcription, stem separation and similar) it installs on its own at pinned versions and names in the delivery note; anything paid or behind an account is asked first. Ideas and scripts need nothing. Lottie needs Node. Every delivered film needs Node, FFmpeg, a browser and Python 3.
From you: one prompt that starts with /ice-motion-director:ice in Claude Code, then the questions on every open decision (four options each, at most four per message, none if your prompt covers everything or you say "don't ask") and, if you are there, one preview, where you also hear two or three real music options laid on the film and pick one (three unless you set music_options to 2 in sources.json). While it runs, each stage reaches you as two lines and its stills, so you can step in mid-way. Behind it, your agent runs all ten stages with several helper agents, so even a short ad runs for a while and uses far more of your plan than a chat answer. If your agent hits a usage limit in the middle, type /ice later: it resumes from ice/state.json where it stopped.
Yes. Ice Motion Director is open source under Apache-2.0. Folders named noncommercial/ and vendor/hypit/ keep their own licenses, stated inside them.
Give your agent a director
Paste one line, then ask for a film in plain words. Ice takes it from brief to delivery and shows you its work at every step you want to see.
npx skills add Omar-Tnzxo/ice-motion-director -g --all 