Paint Video Skill — AI skill for Claude Code

paint-video

中文 | [English](README.en.md)

让 AI agent 用代码画手绘动画短片和 MV 的 skill。

每一帧都是时间 t 的纯函数：用笔刷一笔一笔画出来，无头 Chrome 并行渲染成图片，ffmpeg 合成 MP4。画面里没有一张 AI 生图，全是代码画的。skill 里写的是做片子的整套方法和踩过的坑，agent 读了就能从一句话需求做到成片。

用它做的片子

《呆头鸟》· 蜡笔绘本 MV

2 分 29 秒，36 个镜头。油画棒蜡笔加连环画分格，江南小镇从清晨到夜里，男主一慌就「噗」地变成一只呆头鸟。从剧本到带字幕的成片不到 2 小时。


全片一览


《琵琶曲》· 水彩 MV

2 分 09 秒，39 个镜头。丰子恺式的笔刷小人，不画五官；灯会一段换成剪影配暖光，结尾拉远成一幅画卷。


全片一览


《落款》· 水墨短片

16.8 秒。一滴墨落成远山，小红块走到哪里，芦苇和河就画到哪里，最后坐下成了整幅画的印。场景代码在 `examples/brush/ink.js`。


《拾星》· 水彩短片

14.5 秒，第一支测试片。Clawd 捧着空罐子接住掉下来的星星，一罐星光把夜色一点点焐暖。场景代码在 `examples/brush/stars.js`。


两部 MV 的歌有版权，仓库里不带音频和歌词，上面的预览都是无声画面。

它教给 agent 什么

• 两套画风引擎
  • 水彩、水墨、版画：p5.js + p5.brush，基于 ClaudeAnimationBase，每帧约 1 秒。
  • 蜡笔绘本：本仓库自写的 2D canvas 引擎 crayon-kit/，每帧 10–50ms。
• 做片子的规矩：每个镜头只让观众看一件事、先有原因再有反应；给「看懂」留时间；每个接缝都有转场；画面不写字；丰富但不廉价，不撒火花填空。
• 检查循环：每做完一个镜头就渲出联系表、连续帧、局部放大图，用读图工具自己看，查瞬移、悬空的手、朝向、道具挡脸、颜色发脏。只读代码看不出动画好不好。
• 整首歌的 MV 流程：节拍分析 → 用拍号写逐镜表（改剪辑只改一处）→ 先便宜地试风格 → 零件库 → 分批做、每批自检 → 局部返修 → ffmpeg 调色。
• 歌词字幕：单独一层透明 PNG 叠上去，竖排、按半句出。蜡笔版的字也有纸纹、会随画面抖动；用「探针」记下每帧人物实际画在哪里，自动排版避开人物。
• 反面教材：一支规矩全守却没戏的测试片，逐条写了为什么没戏。

目录

路径	内容
paint-video/	skill 本体。SKILL.md 短片入门，mv-workflow.md 长片与 MV 流程，crayon.md 蜡笔画风
crayon-kit/	蜡笔引擎、角色（3 头身小人和呆头鸟）、零件库、16 秒 demo、歌词字幕工具
examples/brush/	《拾星》《落款》的场景代码，放进 ClaudeAnimationBase 就能跑
tools/	analyze.py 节拍与段落分析，make_shotlist.py 拍号逐镜表模板
docs/	README 用的预览图

安装

git clone https://github.com/nzl153/paint-video-skill

把 `paint-video/` 复制到 agent 的 skills 目录：Claude Code 是 `~/.claude/skills/`，Codex 是 `~/.codex/skills/`。仓库本身留着，skill 会去里面找 `crayon-kit/` 和范例。

需要：

• Node