> ## Content Index
> Fetch the complete content index at: https://claudefox.com/llms.txt
> Use this file to discover other available public pages before exploring further.

# huashu-motion lets Claude Code or Codex make a product launch film with music that you edit by clicking a frame
- URL: https://claudefox.com/huashu-motion-agent-launch-film-skill/
- Published: 2026-11-16T03:18:33.000Z
- Updated: 2026-11-17T13:08:36.000Z
- Description: huashu-motion (alchaincyf/huashu-motion) is an MIT agent skill and CLI that has Claude Code or Codex write a product launch film as one HTML file, compose its music locally, render it in your own Chrome with FFmpeg, and edit only the spot you click.
- Author: hupicake
- Tags: Built with Claude

huashu-motion (GitHub: alchaincyf/huashu-motion) is an MIT-licensed skill plus a command-line tool, om, that runs inside Claude Code, Codex and other skill-capable coding agents. Ask for a 30-second launch film and the agent gathers your product's real screenshots and branding, proposes three directions, writes the film as one HTML file, composes a soundtrack, and opens a browser editor where you click a spot in the frame to have just that changed.

## Quick facts

- Repo: by Huashu (花叔), created October 18, 2026; 2,749 stars and 276 forks as of November 16, 2026\. Version 0.5.0 (November 15) added a Chinese, English and Spanish editor interface.
- Hosts named in the README: Claude Code, Codex, WorkBuddy, Grok Bot, Muse and Dots.
- Needs: Node 22+, an installed Chrome, Chromium or Edge, and FFmpeg. Tested on macOS only so far.
- Licence: MIT. GSAP keeps its no-charge licence and fonts SIL OFL 1.1; the author's cartoon character in the code and demo films is not MIT.
- Cost: no paid music or video API. Your coding agent's model is billed separately, and the README gives no typical figure beyond one example below.
- Jobs: launch films, data stories from a CSV, narration from a script or your recording, talking-head packaging as a transparent overlay, and a vertical 1080x1920 copy. Exports MP4, MOV with alpha, WebM, GIF or a share page.

## How to install

The README offers three routes: ask your agent to install the skill from github.com/alchaincyf/huashu-motion and run the demo, use the skills installer, or clone the repo and link skills/huashu-motion into your agent's skills folder.

```
npx skills add alchaincyf/huashu-motion
```

The CLI is also on npm as huashu-motion; release notes give npm i -g huashu-motion@0.5.0, or git pull --ff-only in a clone, to update.

## First setup

Run om doctor to see what is missing. om samples build optionally downloads about 55 MB of real-instrument samples once; without it music plays on synths. Narration works with macOS system voices, or Kokoro voices (uv, Python 3.12, a model of about 325 MB); word timing needs whisper-cli. A project starts with om new <dir>, optionally from one of 12 templates (om templates). In Codex, approve the local preview server and browser when its sandbox asks.

## How a film gets made

No video model is involved. A film is an index.html driven by one paused GSAP timeline, with Canvas, SVG or Three.js where needed, and every frame is a pure function of time. om render runs several instances of your own Chrome at once (up to eight by default), captures frames and encodes picture and audio with FFmpeg. The author reports 12 to 15 seconds for a 30-second film on a 14-core Mac, or 1 to 1.5 minutes with motion blur.

The skill enforces gates: real material collected with om grab before design, three directions and then a wait for your pick, a treatment.md with a rhythm sheet, om check at zero errors, and om qa on the final file to catch single-frame pops, dead time and a blank first frame. Per the README, its rules come from measuring 21 launch films and 142 popular motion films, organised into 20 motion languages.

![huashu-motion score view: the ABC score as a moving staff, with a red scene mark where the picture cuts on the beat](https://claudefox.com/content/images/lab/2026-11-16/huashu-motion-agent-launch-film-skill-score-first-frame-b6db1f714b.png)

The agent's ABC score becomes a moving staff; the picture cuts where each red scene mark lands. Frame from the project's demo GIF. Image: alchaincyf/huashu-motion (MIT)

## How the music is made, and what you may do with it

For drafts, a built-in direction picks one of three cues for your product type (12 types). For launch films the agent composes: it writes an ABC-notation score inside the HTML with named marks that land on scene labels, and om sound performs it, adds effects from a set of 23 on the frames where motion lands, and warns when a film copies an example score's instrumentation. The sound reference says this step uses no network and no API.

The optional sample pack is downloaded from its original sources and not redistributed by the repo. Most sets are CC0; the Salamander grand piano and Greg Sullivan's Wurlitzer are CC BY 3.0, so credit them if your film uses them, and Versilian asks that its samples not be sold on their own. A NOTICE.txt lists the credits. The sources we checked state no licence for the rendered film or score itself.

## What "point at the frame" means in practice

om studio is a local server bound to 127.0.0.1 that refuses other host names and needs a per-session token for changes; it prints its URL. In it you press C, click the frame and type a note; the comment carries the time, scene, element under the cursor and its source line. The agent waits with om inbox --wait, saves the frame and a close-up with om look, edits only that spot, and replies with om done. The preview reloads in place, every version is kept for om undo and key titles, numbers and colours are editable fields.

![Terminal running om inbox --wait and om look, showing a frame comment with its time and scene next to frame and zoom PNGs of the clicked spot](https://claudefox.com/content/images/lab/2026-11-16/huashu-motion-agent-launch-film-skill-point-to-edit-frame-ad90f8783a.png)

The agent side of a frame comment. The README says this terminal is rebuilt for the demo. Image: alchaincyf/huashu-motion (MIT)

## What stands out

- om share makes a GIF under 10 MB and a draft post; om learn keeps your preferences locally, in \~/.huashu-motion.
- A cheaper model can work: the README's 22-second DeepSeek V4.1 Flash film, made through Claude Code with three rounds of notes, took under half an hour and cost ¥1.95\. The author mostly uses Opus 5.5 and says taste differs between models.

## How it was built with Claude

Nearly every commit on main is co-authored by Claude Opus 5.5 or Claude Fable. The README says the project began as a one-line request to Claude Code to reproduce and outdo Anthropic's Claude Motion. The first day produced an editor, a hundred-odd tests and a dull 19-second 3D film; Claude's own review, the author writes, called it good at proving it wasn't lying and nothing anyone would share. They restarted and focused on film quality.

**Try it with your AI.** Paste this into Claude Code or Codex to try huashu-motion on your own product. It asks before installing, downloading samples or rendering.

```
I want to try the huashu-motion skill (github.com/alchaincyf/huashu-motion) to make a
launch film for [product name, e.g. Acme Notes], using material from [site URL or local
project folder].

1. Check prerequisites and report: Node version (22 or later), whether Google Chrome,
   Chromium or Edge is installed, and whether ffmpeg is on PATH. If anything is missing,
   tell me what to install and stop.
2. Show me how you plan to install the skill, either `npx skills add
   alchaincyf/huashu-motion` or a clone with skills/huashu-motion linked into your
   skills folder, and wait for my confirmation. Install nothing else.
3. Run `om doctor` and show me the output.
4. Ask before `om samples build` (about 55 MB); if I decline, use synths.
5. Create the project with `om new [folder, e.g. ./launch-film]` and use it as <dir>
   below.
6. Collect material with `om grab` from my site or folder only. Mask, crop or ask before
   using anything showing names, messages or accounts.
7. Show me three directions as key frames and wait. Length: [seconds, e.g. 30]; aspect:
   [16:9, or vertical 1080x1920].
8. Write treatment.md, build, run `om check` until it has zero errors, then `om sound`.
   Start `om studio <dir> --no-open`, give me the URL, and handle my frame comments one
   at a time.
9. Ask before `om render`, then run `om qa` on the result.

Do not publish or post anything, do not touch credentials, and do not delete files.
```

## Known limits

- It cannot hear: the agent judges music from the score and an energy curve; the final listen is yours.
- It draws everything in code and generates no people or live footage.
- Windows: v0.1.1 fixed a Chrome 153+ check that caused failed sign-ins during renders; Windows 11 locks an account after 10 in 10 minutes and unlocks it after 10 minutes by default. Issue #3, intermittent zero-byte MP4s on Windows 11, was open on November 16, 2026.
- Privacy: rendering and music are local, but the agent works from the screenshots and files it collects, so treat them as shared with your agent; the skill says to mask, crop or ask.
- Network: om grab fetches URLs you give it, samples and voice models download on first use, and a git clone checks GitHub tags about monthly (write off into .last-update-check to stop it).
- Signature: films of 4 seconds or more end with a 1.2-second "Made with huashu-motion". The skill removes it (data-om-signature="off") only on request or for commissioned client work; fan films about others' products keep it.
- The Grok Bot and Claude Duet showcase films are labelled unofficial fan films.

## FAQ

Does it need a paid music or video API? No. om sound renders music and effects from the composition with no network and no API. Your agent's model is a separate cost.

What renders the video? Your installed Chrome draws the HTML and GSAP film frame by frame, and FFmpeg encodes it, through the project's own render engine.

Can I use the music commercially? Samples are CC0 except two CC BY 3.0 sets that need credit; the rendered film's licence is not stated.

Where can I watch a finished film first? The releases page has full MP4s with sound, including the 53-second film the tool made about itself.

Does it work on Windows? It is untested there; use 0.1.1 or later and watch issue #3.

## Related on claudefox

- [Product Engineering: 45 free agent skills for shipping a product with Claude Code and Codex](https://claudefox.com/product-engineering-45-agent-skills-claude-code-codex/)
- [Agent Autoloop: run Claude Code and Codex in the background and get a card when they need you](https://claudefox.com/agent-autoloop/)
- [BAMA: Claude Code and Codex skills that plan, design and build native macOS apps](https://claudefox.com/bama-build-any-mac-app-agent-skills/)
- [tstack: nine agent skills that take a change to a merged PR in Claude Code and Codex](https://claudefox.com/tstack-claude-code-codex-pr-agent-skills/)

## Problems and feedback

Report bugs on the repository's GitHub issues page, where one issue was open as of November 16, 2026.

Source: [GitHub: alchaincyf/huashu-motion](https://github.com/alchaincyf/huashu-motion?ref=claudefox.com), [huashu-motion README (English)](https://github.com/alchaincyf/huashu-motion/blob/main/README.en.md?ref=claudefox.com), [huashu-motion SKILL.md](https://github.com/alchaincyf/huashu-motion/blob/main/skills/huashu-motion/SKILL.md?ref=claudefox.com), [huashu-motion sound reference](https://github.com/alchaincyf/huashu-motion/blob/main/skills/huashu-motion/references/sound.md?ref=claudefox.com), [huashu-motion music reference](https://github.com/alchaincyf/huashu-motion/blob/main/skills/huashu-motion/references/music.md?ref=claudefox.com), [huashu-motion sample pack builder](https://github.com/alchaincyf/huashu-motion/blob/main/cli/lib/samples-build.js?ref=claudefox.com), [huashu-motion third-party licences](https://github.com/alchaincyf/huashu-motion/blob/main/THIRD%5FPARTY.md?ref=claudefox.com), [huashu-motion package.json](https://github.com/alchaincyf/huashu-motion/blob/main/package.json?ref=claudefox.com), [huashu-motion studio server](https://github.com/alchaincyf/huashu-motion/blob/main/cli/lib/server.js?ref=claudefox.com), [huashu-motion releases](https://github.com/alchaincyf/huashu-motion/releases?ref=claudefox.com), [huashu-motion commit history](https://github.com/alchaincyf/huashu-motion/commits/main?ref=claudefox.com), [huashu-motion issues](https://github.com/alchaincyf/huashu-motion/issues?ref=claudefox.com), [huashu-motion on npm](https://www.npmjs.com/package/huashu-motion?ref=claudefox.com), [huashu-motion issue #3: zero-byte MP4 on Windows 11](https://github.com/alchaincyf/huashu-motion/issues/3?ref=claudefox.com)

This story first appeared in the [claudefox daily briefing for November 16, 2026](https://claudefox.com/daily-2026-11-16/).