What it does
Ice Motion Director is an open-source set of agent skills for motion graphics, motion design and video editing in Claude Code, Codex, Cursor, Gemini CLI and 40+ other coding agents. You describe the video in one prompt (or hand it your footage, or a reference), and your agent takes it from the brief and the script to a rendered MP4, writing every frame as code and checking it before you see it. It is free under Apache-2.0 and needs no After Effects and no paid video model.
Who it is for: founders and marketers who need an ad, a launch film or social cuts without a studio; editors and newsrooms who want reels, shorts and talking-head edits cut from long footage; designers and developers who want Lottie and UI motion with a handoff; and anyone who writes in Arabic or mixes Arabic and English.
One router skill reads your request and sends it to the right workflow:
| You ask for | It runs | You get |
|---|
| A film made from scratch: launch film, app ad, brand film, logo sting, kinetic type, data story, social short | ice-film | A finished MP4 plus a delivery report |
| A video where a voice explains something | ice-explainer | A narrated explainer with captions |
| "Make it like this" with a reference video, site or images | ice-remake | A new film in that style, with your content |
| An edit of your own footage: YouTube, podcast clips, talking-head ads, shorts, news reels, B-roll | ice-edit | The cut, captions, vertical versions |
| Lottie, loaders, icons, UI motion for an app or site | ice-lottie | Lottie JSON or animated SVG plus a developer handoff |
| Ideas, hooks, scripts, storyboards | ice-ideas | A concept set and a script, ready to build |
Every film is code (HTML, CSS, GSAP, Remotion, Lottie or FFmpeg) and renders the same way every time. Nothing is generated as stock footage: text, numbers and logos are always set in code, exactly as you approved them.
Quick start
About a minute of your time; the film itself takes longer (see the note below). This uses Claude Code; every other agent is in Install.
1. Install (needs Node, FFmpeg, Chrome and Python 3 on your computer: prerequisites):
claude plugin marketplace add Omar-Tnzxo/ice-motion-director
claude plugin install ice-motion-director@ice-motion-director
2. Open Claude Code in an empty folder and send one message:
/ice-motion-director:ice Make a 20-second launch film for my note-taking app. Here is the site: <your URL>
3. Answer its questions, then let it run. It researches your business first, then asks about every decision your message leaves open, four options each with the recommended one first (say "decide yourself" to skip them). If you are there, it shows you one preview and lets you pick the music from real tracks laid on the film. Then it runs to the end: the film lands in ice/renders/final/ and the delivery note, with every decision and its measured checks, in ice/review/NOTE.md.
Two ways to use it
- One prompt, 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 Claude Code load the director's instructions itself, so the run starts the right way even when other video skills are installed. A prompt without the command usually works too, but then the agent picks the skill on its own, which is not guaranteed. Other agents: see how to type the commands. The director 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 (including which official brand files it may use). It asks nothing when your prompt already covers everything, or when you say "don't ask" or "decide yourself". Then, only if you are there to answer, one preview: the style frames or the animatic. After that it runs to the final file with no more questions. Everything it decided is logged and explained in the delivery note.
- Step by step, for people who want to steer. Run one stage at a time with numbered commands. In Claude Code the form that always works is
/ice-motion-director:ice-01-brief to /ice-motion-director:ice-10-deliver. Each stage stops with a review card; talk it through, ask for changes or other options as often as you like. Say "approved" to lock the stage (it then names the next command), or "approved, go on" to lock it and start the next stage. See Workflow, step by step.
You can switch at any time: type a stage command in the middle of a one-prompt run, or /ice to let it finish the rest on its own.
What a first film takes. From you: one prompt that starts with the command, 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. 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 (or send the same prompt) later: it resumes from ice/state.json where it stopped.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
