Repolode
Submit
makevoid

makevoid/motion-graphics-music-video-skill

A Claude Code plugin that turns a music track and a creative prompt into a motion graphics music video using AI image and video generation via Fal.ai.

View on GitHub
Stars
168
Forks
22
Open issues
0
Last commit
7 days ago

What is it?

This is a Claude Code plugin that produces motion graphics music videos from a song and a text prompt. The agent researches visual ideas, writes a character and scene plan for your approval, then generates the assets in waves of sub-agents and assembles a final HD MP4 in an output directory.

Generation runs through Fal.ai APIs: image generation and editing for characters and graphics, video models that animate characters on a greenscreen background, and audio tools for stem isolation, lip-sync and sound effects. Node.js with P5.js handles the animation, local Python handles analysis, cutouts and audio mixing, and an optional Swift module provides image and video effects on macOS.

API keys are stored in Claude Code's credential storage and passed only to the bundled Ruby MCP server. Setup installs Ruby gems, npm packages and a Python environment inside a separate video project rather than the plugin itself.

Key features

  • 01Generates characters, graphics and scenes from a song and a creative prompt.
  • 02Shows a plan and cost estimate for approval before paid generation runs.
  • 03Animates characters on greenscreen backgrounds using Fal.ai video models.
  • 04Isolates audio stems for lip-sync and creates sound effects.
  • 05Uses Node.js with P5.js for animation and Python for analysis and audio mixing.
  • 06Keeps API keys in Claude Code's secure credential storage.

Use cases

  • Making a music video for an original song without a film crew.
  • Prototyping motion graphics concepts for a track before committing to a full production.
  • Experimenting with AI-generated characters animated over music.

Quick start

  1. 1

    Add the plugin marketplace

    claude plugin marketplace add makevoid/motion-graphics-music-video-skill
  2. 2

    Install the plugin

    claude plugin install motion-graphics-music-video@makevoid-music-video --scope user
  3. 3

    Set your Fal API key in Claude Code

    /plugin configure motion-graphics-music-video
  4. 4

    Run the skill and supply a song and creative prompt

    /motion-graphics-music-video:motion-graphics-music-video

Things to know

  • Requires a paid Fal.ai API key; the README estimates about $30 of Fal credits plus around 3M Opus tokens for a 3-minute video.
  • Requires substantial disk space, as a 3-minute video can generate about 5GB of assets.
  • Swift VFX and the full test suite need macOS 14+ with Xcode command line tools.
  • The README recommends Claude Code in the terminal, as the desktop version works less well.

Topics

#claude-code#motion-graphics#video-generation#fal-ai#music-video#p5js#plugin#generative-ai

FAQ

What is motion-graphics-music-video-skill?
A Claude Code plugin that turns a music track and a creative prompt into a motion graphics music video using AI image and video generation via Fal.ai. This is a Claude Code plugin that produces motion graphics music videos from a song and a text prompt. The agent researches visual ideas, writes a character and scene plan for your approval, then generates the assets in waves of sub-agents and assembles a final HD MP4 in an output directory.
Is motion-graphics-music-video-skill free to use? What license does it have?
motion-graphics-music-video-skill is open source under the MIT license. Check the license terms before using it in commercial products.
Is motion-graphics-music-video-skill still maintained?
Actively maintained. The last commit to motion-graphics-music-video-skill was on Oct 13, 2026.
What can I use motion-graphics-music-video-skill for?
Making a music video for an original song without a film crew. Prototyping motion graphics concepts for a track before committing to a full production. Experimenting with AI-generated characters animated over music.
How do I install motion-graphics-music-video-skill?
Add the plugin marketplace: claude plugin marketplace add makevoid/motion-graphics-music-video-skill Install the plugin: claude plugin install motion-graphics-music-video@makevoid-music-video --scope user Set your Fal API key in Claude Code: /plugin configure motion-graphics-music-video Run the skill and supply a song and creative prompt: /motion-graphics-music-video:motion-graphics-music-video
Where can I get motion-graphics-music-video-skill?
The source code and installation instructions are on GitHub: https://github.com/makevoid/motion-graphics-music-video-skill

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

Related projects