How lintsinghua/paint-mv-skills works
paint-mv-skills is an AI-agent workflow for turning a song and lyrics into a hand-painted animated music video. The main path runs from project setup and audio/lyric timing through storyboard, shared art direction, chapter animation, review, and MP4 rendering. The graph also captures the separately documented skill guidance and generated-project inputs. Engine, storyboard, and render internals are not present in the tree, so those nodes use existing enclosing directories; their links rely on README statements.
Main entry points: new_project.mjs Project setup · SKILL.md Director skill · lyrics_to_ly.mjs Lyric conversion · ch Chapter animation
Components 21
Workflow guidance
- Director skill
skills/paint-mv/SKILL.md - Storyboard skill
skills/paint-mv-storyboard/SKILL.md - Animation guide
skills/paint-mv-animate/SKILL.md - Render guide
skills/paint-mv-render/SKILL.md
Project preparation
- Project setup
skills/paint-mv/scripts/new_project.mjs - Beat analysis
skills/paint-mv/scripts/analyze_audio.mjs - Lyric alignment
skills/paint-mv/scripts/align_lyrics.py - Lyric conversion
skills/paint-mv/scripts/lyrics_to_ly.mjs - Engine retrieval
skills/paint-mv/scripts/fetch_upstream.mjs - Song configuration
skills/paint-mv/template/src/song.js - Timed lyrics
skills/paint-mv/template/src/lyrics.js
Creative production
- Shared cast
skills/paint-mv/template/src/characters.js - Shared sets
skills/paint-mv/template/src/sets.js - Chapter animation
skills/paint-mv/template/src/ch
Review and output
- Animation engine
skills/paint-mv/template - Contact-sheet review
skills/paint-mv-render/SKILL.md - Frame rendering
skills/paint-mv/template - MP4 video
Other components
- MV creator
- Song audio
- Lyrics
Connections 28
- MV creator → Director skill: starts workflow
README.md - Director skill → Project setup: scaffolds project
README.md - Project setup → Beat analysis: analyzes audio
skills/paint-mv/scripts/new_project.mjs - Song audio → Beat analysis: provides audio
README.md - Project setup → Lyric conversion: converts timed lyrics
skills/paint-mv/scripts/new_project.mjs - Lyrics → Lyric alignment: aligns plain text
README.md - Lyric alignment → Lyric conversion: writes SRT
skills/paint-mv/scripts/align_lyrics.py - Lyrics → Lyric conversion: provides timed lyrics
README.md - Project setup → Engine retrieval: fetches engine
skills/paint-mv/scripts/new_project.mjs - Beat analysis → Project setup: returns beat data
skills/paint-mv/scripts/new_project.mjs - Lyric conversion → Project setup: returns lyric data
skills/paint-mv/scripts/new_project.mjs - Project setup → Song configuration: writes song settings
skills/paint-mv/scripts/new_project.mjs - Project setup → Timed lyrics: writes lyric data
skills/paint-mv/scripts/new_project.mjs - Director skill → Storyboard skill: directs story design
README.md - Storyboard skill → Shared cast: specifies characters
README.md - Storyboard skill → Shared sets: specifies settings
README.md - Director skill → Animation guide: assigns chapters
README.md - Animation guide → Chapter animation: guides drawing
README.md - Chapter animation → Animation engine: uses animation engine
README.md - Shared cast → Chapter animation: shares characters
README.md - Shared sets → Chapter animation: shares settings
README.md - Timed lyrics → Animation engine: drives karaoke timing
README.md - Song configuration → Frame rendering: provides render settings
skills/paint-mv/template/src/song.js - Director skill → Contact-sheet review: coordinates review
README.md - Render guide → Contact-sheet review: guides inspection
README.md - Contact-sheet review → Frame rendering: checks rendered sheets
README.md - Frame rendering → MP4 video: encodes MP4
README.md - Song audio → MP4 video: mixes into video