gnipbao /story-to-handdrawn-video

About story-to-handdrawn-video

Give it a Chinese story or a set of ordered images and it makes a 3:4 vertical hand-drawn video. An Agent skill plans the storyboard and draws the pages, then Remotion renders the animation. The MP4 comes out silent, so voiceover or music goes on later. New art needs an image tool your Agent can call, and the docs are mostly Chinese.

Best for: Storytellers who want a silent hand-drawn vertical clip from a Chinese story, ready to dub later.

• Browses 297 style recipes and 30 palettes offline, across 11 categories
• Animates two ways: layered reveal (text, then grayscale, then color) or page flip
• Saves your own styles from reference images under .story-video/styles/
• Plans storyboard beats per sentence and keeps character references consistent
• Exports silent H.264 MP4 at 720×960 preview or 1080×1440 final, 30 fps

1. 1
   Install the renderer: the command below, then cd story-to-handdrawn-video, npm ci, npm run check

   git clone https://github.com/gnipbao/story-to-handdrawn-video.git

   Copy
2. 2
   Copy the skill into your Agent's skills folder, e.g. the command below (or ~/.claude/skills/, ~/.agents/skills/)

   cp -R skill-package/story-to-handdrawn-video ~/.codex/skills/

   Copy
3. 3
   If you call it from outside the project, set the command below

   export STORY_VIDEO_PROJECT=/absolute/path/to/story-to-handdrawn-video

   Copy
4. 4
   Ask your Agent in plain language, e.g. the command below

   使用 $story-to-handdrawn-video，把下面的故事生成手绘动画，先给我预览版：

   Copy
5. 5
   After the master pages are checked, run the command below, then --mode preview, then --mode render

   python3 scripts/run_story_video.py --mode import

   Copy

• story-to-handdrawn-video vs shuohao-skills
• story-to-handdrawn-video vs drama-skills