Repolode
Submit
unclejobs-ai

unclejobs-ai/motion-video-skill

A Claude Code and Codex agent skill that guides you through making 30-90 second motion graphics videos, with stage-by-stage quality gates.

View on GitHub
Stars
120
Forks
14
Open issues
0
Last commit
2 days ago

What is it?

motion-video-production is an Agent Skills format production guide for building motion graphics and short videos of 30 to 90 seconds, from story planning through final assembly. It works in Codex, Claude Code, and other skill-compatible runtimes, using the same skill folder.

The skill splits production into six stages. Each stage has a gate script, harness/gate.py, which measures the outputs and returns a pass or block exit code. It also includes a list of 29 common pitfalls with prevention notes, covering issues such as character drift across clips, beat-aligned cut lengths, and ffmpeg audio delay handling.

Some checks, such as whether a character stays consistent across frames, cannot be judged by a script. For those, the gates require a human to review frame strips and record the decision in a review file. Image generation, music, and voice tools are external and must be set up separately.

Key features

  • 01Provides a six-stage workflow from story and scene planning to final assembly.
  • 02Runs gate.py per stage, returning exit code 0 for pass and 1 for block.
  • 03Generates frame strips per clip for visual review of character consistency.
  • 04Documents 29 common production pitfalls with symptoms, causes, and prevention.
  • 05Installs via npx skills or by copying the skill folder into Codex or Claude Code directories.

Use cases

  • Producing a short character-driven motion graphics video with an AI coding agent.
  • Checking clip length, frame count, and audio loudness before final export.
  • Following a structured checklist to keep character appearance consistent across shots.

Quick start

  1. 1

    Install the skill with the Node.js skills CLI

    npx skills add unclejobs-ai/motion-video-skill --skill motion-video-production
  2. 2

    Restart your runtime if the skill does not appear, then invoke it with a request such as a 30-second opening video

  3. 3

    After each production stage, run the quality gate script

    python3 "$SKILL_ROOT/harness/gate.py" <단계> "$PROJECT_ROOT"

Things to know

  • Generation tools such as Suno, ElevenLabs and ChatGPT/Grok Imagine are separate, and some require paid accounts.
  • Windows needs WSL because the shell scripts require Bash.
  • Requires ffmpeg, ffprobe, Python 3 and Node.js with Remotion installed separately; Remotion composition code is not included.
  • Visual checks cannot be automated and rely on manual review records.

Topics

#claude-code#agent-skills#video-production#motion-graphics#ffmpeg#quality-gate#ai-video

FAQ

What is motion-video-skill?
A Claude Code and Codex agent skill that guides you through making 30-90 second motion graphics videos, with stage-by-stage quality gates. motion-video-production is an Agent Skills format production guide for building motion graphics and short videos of 30 to 90 seconds, from story planning through final assembly. It works in Codex, Claude Code, and other skill-compatible runtimes, using the same skill folder.
Is motion-video-skill free to use? What license does it have?
motion-video-skill is open source under the MIT license. Check the license terms before using it in commercial products.
Is motion-video-skill still maintained?
Actively maintained. The last commit to motion-video-skill was on Oct 18, 2026.
What can I use motion-video-skill for?
Producing a short character-driven motion graphics video with an AI coding agent. Checking clip length, frame count, and audio loudness before final export. Following a structured checklist to keep character appearance consistent across shots.
How do I install motion-video-skill?
Install the skill with the Node.js skills CLI: npx skills add unclejobs-ai/motion-video-skill --skill motion-video-production Restart your runtime if the skill does not appear, then invoke it with a request such as a 30-second opening video After each production stage, run the quality gate script: python3 "$SKILL_ROOT/harness/gate.py" <단계> "$PROJECT_ROOT"
Where can I get motion-video-skill?
The source code and installation instructions are on GitHub: https://github.com/unclejobs-ai/motion-video-skill

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects