Joker-chichi / claude-mv-skill

# opus-video-skills
A Claude Code skill for producing hand-painted animated videos with Claude Opus 5.5.
## Overview
The skill in this repository teaches Claude Opus 5.5 to produce a complete hand-painted video, covering storyboarding, animation, review, lyric synchronization and final encoding. All imagery is generated procedurally in code; no image or video generation model is involved. Every frame is a pure function of time, rendered in headless Chrome and encoded with ffmpeg.
## Skill
### painted-animation
Draws every shot with p5.js and the p5.brush watercolour library. Characters act through a library of expressions and motion principles. Music videos are cut to the measured beat, and lyric videos carry word-by-word karaoke subtitles. Example: a 31-second lyric video for 陶喆《小镇姑娘》. Documentation.
## Requirements
- Claude Code with Claude Opus 5.5
- Node.js, Google Chrome, ffmpeg
- Python 3 with numpy (painted-animation tempo detection only)
## Installation
**As plugins (recommended).** In Claude Code:
 [code] 
`/plugin update` fetches new versions.
**As personal skills.** Clone the repository once and link the skills you want:
 [code] 
Updating is then a `git pull` in `~/opus-video-skills`.
> **Upgrading from `painted-animation`.** This repository was previously the single `painted-animation` skill, cloned directly into `~/.claude/skills/painted-animation`. That layout no longer works, because the skill now lives in `skills/painted-animation/`. Remove the old clone and install with either method above.
## Usage
Describe the video in Claude Code. The matching skill is selected automatically, or it can be invoked by name:
> Make a 15-second video of Clawd trying to catch a butterfly.
For a music video, provide the song audio and an LRC lyric file, then optionally answer one combined question about the desired story and feeling, recurring imagery and anything to avoid. The question is never split into five fields and may be left blank. The skill scaffolds a project, presents a storyboard, and reviews every shot. It never starts the complete final render without asking for an explicit local-or-cloud choice; choosing local prohibits cloud full rendering and returns exact local commands.
## Repository Structure
| Path | Description |
|---|---|
| `.claude-plugin/marketplace.json` | Plugin marketplace manifest |
| `skills/painted-animation/` | Watercolour animation skill: engine, guides, examples |
## Adding a Style
A new style is a new directory under `skills/` containing a `SKILL.md`, a runnable `template/` and at least one worked example, plus an entry in `.claude-plugin/marketplace.json`. The existing skill's contract is that frames are pure functions of time, `render.mjs` produces contact sheets and parallel frame renders, and every shot is reviewed from rendered images before the final encode.
## Acknowledgements
The painted-animation engine and guide are adapted from ClaudeAnimationBase by John Heibel (MIT License), and the method follows his