motion-video
Skill4 starsChanged 2 days agoMITView on GitHub
Direct and produce finished videos end to end - product films from a deployed URL or codebase, narrated explainers, and generated or motion-graphics pieces - with a written script, emotive TTS narration, generated keyframes and shots, real Creative Commons footage, music, word-timed captions, and a critic pass. Use for /motion-video, teasers, launch films, demos, explainers, and walkthroughs. Not for a quick edit of one existing clip (use ffmpeg directly) or for still images.
17 other projects use a version of this.
Adopted by
Most recently taken up by
- ohong/agent-skillsword for word, first seen Nov 16, 2026
- mayank2424/knacktheir own version, first seen Nov 15, 2026
- crysix/skillstheir own version, first seen Nov 15, 2026
- huypham85/app-3d-video-skilltheir own version, first seen Nov 15, 2026
- whoamnesia/astudio-motiontheir own version, first seen Nov 8, 2026
- jocarrd/crux-agentstheir own version, first seen Nov 8, 2026
Other versions17 projects use a version of this.
Word for word · 1
- ohong/agent-skills★ 4100% same
Edited · 0
None found.
Wrote their own version · 16
- derek-zhuolin/motion-skill★ 107same name
- bestagentkits/motion-video-skill★ 93same name
- farhan-syah/motion-video-skill★ 49same name
- huypham85/app-3d-video-skill★ 18same name
- memi-design/design-skills★ 7same name
- jocarrd/crux-agents★ 4same name
- goosen-x/skills★ 2same name
- juninmd/skills★ 2same name
- Satori28/free-skills★ 2same name
- verbodh-pte-ltd/motion-skills★ 2same name
6 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository10 other files it gives its agents.
- daily-closeSkill
- demo-videoSkill
- draft-zeroSkill
- karasz-coverSkill
- no-ai-slopSkill
- quarterly-derisk-exerciseSkill
- spring-cleaningSkill
- transcribe-youtubeSkill
- video-analysisSkill
- writing-with-smart-brevitySkill
The file
We split this skill into the rules it gives an agent
7 rules. 0 are common, 5 are distinctive, and 2 are very specific to this project.
0
Common
Most of the 11 edited versions we read keep these.
5
Distinctive
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 17
Style: - look, pacing, voice or no voice, music character, and any reference films.
- Very specific: line 23
Run uv run scripts/preflight.py (paths are relative to this skill directory).
- Distinctive: line 27
Read each linked reference when you reach its stage, not before.
- Very specific: line 29
Script and plan: - write brief.md, script.md, and shots.json.
- Distinctive: line 35
Music and sound: - read sound and budget.
- Distinctive: line 44
Truth: Don't fabricate testimonials, metrics, integrations, or product behavior.
- Distinctive: line 45
Consistency: Every generated image or shot that shows a recurring subject receives that subject's reference sheet.
“Common” is measured: kept by at least 6 in 10 of the 11 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Motion Video
You are the director and the editor. You own the idea, the script, every shot, the sound, and the finished file. Tools and subagents extend your hands, but they don't make the creative decisions. The goal is a film that makes a specific viewer understand or want something specific, and that holds up next to the films in the reference atlas.
0. Intake
The user's prompt should state four things:
- What - the subject, the viewer, and what they should feel or do afterward. For a product, the URL or repo.
- Aspect ratio - 16:9, 9:16, 1:1, or 4:5.
- Length - seconds, or a set of cuts such as 10/20/30.
- Style - look, pacing, voice or no voice, music character, and any reference films.
If any are missing, ask for only the missing ones in one short message, and offer a default for each (for a product film: 16:9, 10/20/30-second cuts, restrained editorial look, music, no voiceover). Infer everything else. While you wait, read the subject and the references, but don't spend money. Record the answers in brief.md; they override every default in this skill.
1. Preflight
Run uv run scripts/preflight.py (paths are relative to this skill directory). It reports which tools and keys exist without printing secret values. Report every missing item in one message with the fallback you'll use, then continue.
2. Pipeline
Read each linked reference when you reach its stage, not before.
- Script and plan - write
brief.md,script.md, andshots.json. Read script writing. Narrate like a university professor; the reference lists the machine-writing habits to avoid. - Learn the subject - for a product, capture the real workflow from the running product and read product films: captured UI is the main proof in every cut. For an explainer, source every claim.
- Voice - generate narration per beat with performance direction. Read voice. Re-time
shots.jsonfrom the real audio. - References and keyframes - build a reference sheet for every recurring character, product, or place, then one keyframe per generated shot. Read generation.
- Animatic - cut keyframes, motion-graphics stills, and clip placeholders against the real narration and a temp bed with
scripts/assemble.py --animatic. Watch it and fix story and timing here, where changes are cheap. Generate no video until the animatic works. - Shots - generate video (Seedance for motion-heavy shots, Veo 3.1 for dialogue and native-audio shots), render motion graphics (read motion graphics), and pull real footage (read footage).
- Music and sound - read sound and budget.
- Assemble - build
timeline.otioand render it with ffmpeg. Read assembly. - Captions - word-timed subtitles from the final mix. Read captions.
- Critic - frames, transcript-against-script diff, loudness, and technical checks, then fix and re-render. Read critic. The film isn't done until the critic passes.
Skip stages the brief doesn't need (a silent teaser has no voice or captions stage; a pure motion-graphics piece has no generation stage), and say which ones you skipped in review.md.
Rules for every stage
- Truth. Don't fabricate testimonials, metrics, integrations, or product behavior. Generated imagery can illustrate an idea, but it never stands in for a product's real UI. Real footage must be Creative Commons or otherwise cleared, with an entry in
assets.md. - Consistency. Every generated image or shot that shows a recurring subject receives that subject's reference sheet. Regenerate a shot that drifts off-model instead of excusing it.
- Spending. Fal and Suno calls cost money. Put an itemized estimate in
brief.mdbefore the animatic and again before shot generation. Stay within the user's cap, or $25 per project if they gave none, and ask before you exceed it.scripts/fal_run.pyandscripts/suno.pylog every call tospend.jsonl. - ffmpeg does the manipulation. Trims, scales, reframes, concatenation, mixing, loudness, and caption burn-in go through ffmpeg, directly or through the scripts here.
- Delegation. Scoped work (one scene's motion graphics, the footage search, the sound pass) can go to subagents with the brief, the shot contract, and file boundaries. You keep the concept, the copy, the shot order, and the final selection, and you inspect everything you use.
Delivery
Deliver each requested cut as MP4 (H.264, yuv420p, AAC) at the requested aspect ratio, plus a captioned variant and .srt/.vtt sidecars when there is speech. Keep in the project folder: brief.md, script.md, shots.json, timeline.otio, assets.md, spend.jsonl, review.md (critic results, changes made after review, known limits), and the exact render commands. Show the videos by absolute path and state the creative idea in two sentences. Uploading or posting needs the user's go-ahead.
To improve this skill itself, follow the benchmark procedure.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

