Repolode
alchaincyf

alchaincyf/huashu-motion

A Claude Code / Codex agent skill that turns a product description into a commercial-grade launch film, built from code with a composed score and point-and-click editing.

Stars
780
Forks
77
Open issues
0
Last commit
yesterday

What is it?

huashu-motion is an agent skill for producing product launch films. You ask your coding agent for a 30-second release video, and it reads the product, proposes visual directions, writes a timing plan, and builds the film as a single HTML page using GSAP, Canvas, Three.js or SVG. No video generation model is involved; each frame is determined by code and time.

The project includes a browser-based studio where you click on a frame, leave a comment, and the agent applies the change to that spot only. Music can be written as ABC notation and played with sampled instruments, or generated from built-in fallback styles, with sound effects synced to animation landings. Narration can use system voices, Kokoro, or your own recording with word-level alignment.

Output includes MP4, transparent MOV, WebM, GIF, and a shareable HTML page. The toolchain requires Node 22+, Chrome and FFmpeg, and has been tested on macOS.

Key features

  • 01Turns a product description into a full launch film written as one HTML page.
  • 02Point-and-comment editing in a browser studio, with the agent changing only the selected element.
  • 03Music composed from ABC notation and played with sampled instruments, with a built-in fallback score.
  • 04Sound effects aligned to animation landing frames.
  • 05Narration via system voices, Kokoro, or your own audio with word-level alignment.
  • 06Exports MP4, transparent MOV, WebM, GIF, or a shareable HTML page.

Use cases

  • Creating a 30-second launch video for a software product or app without a video editor.
  • Turning a CSV dataset into a narrated explainer with animated charts.
  • Producing vertical (1080x1920) versions of an existing film.
  • Adding lower-thirds, number cards and captions to a talking-head video as a transparent overlay.

Quick start

  1. 1

    Install the skill with one command

    npx skills add alchaincyf/huashu-motion
  2. 2

    Check your environment and find missing pieces

    om doctor
  3. 3

    Run the bundled demo to see it work

    om demo

Things to know

  • Only tested in practice on macOS.
  • Needs Node 22+, Chrome and FFmpeg installed locally.
  • It cannot generate real people or live footage; visuals are code-drawn.

Topics

FAQ

What is huashu-motion?
A Claude Code / Codex agent skill that turns a product description into a commercial-grade launch film, built from code with a composed score and point-and-click editing. huashu-motion is an agent skill for producing product launch films. You ask your coding agent for a 30-second release video, and it reads the product, proposes visual directions, writes a timing plan, and builds the film as a single HTML page using GSAP, Canvas, Three.js or SVG. No video generation model is involved; each frame is determined by code and time.
Is huashu-motion free to use? What license does it have?
huashu-motion is open source under the MIT license. Check the license terms before using it in commercial products.
Is huashu-motion still maintained?
Actively maintained. The last commit to huashu-motion was on Oct 19, 2026.
What can I use huashu-motion for?
Creating a 30-second launch video for a software product or app without a video editor. Turning a CSV dataset into a narrated explainer with animated charts. Producing vertical (1080x1920) versions of an existing film. Adding lower-thirds, number cards and captions to a talking-head video as a transparent overlay.
How do I install huashu-motion?
Install the skill with one command: npx skills add alchaincyf/huashu-motion Check your environment and find missing pieces: om doctor Run the bundled demo to see it work: om demo
Where can I get huashu-motion?
The source code and installation instructions are on GitHub: https://github.com/alchaincyf/huashu-motion

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

Related projects