How mromidev/claude-animated-shorts works
Claude Animated Shorts is a Claude Code skill and example project for creating short, vertically framed animated stories. Its documented workflow runs from choosing a topic and checking facts through scripting, voice, shot planning, stills, rendering, and sound mix. The bridge example separates scene/story construction and visual effects from procedural audio generation and mixing; helper scripts support stills, shot merging, and frame QA. The README documents the overall workflow, while sampled source and the SOURCE INDEX support the implementation links shown. Unsampled subsystems are represented only where the README or tree establishes their role.
Main entry points: Bridge.tsx Scene renderer · mix.py Stem mix · world.ts World assembly · music.py March score
Components 30
Creation workflow
- Claude skill
SKILL.md - Topic and facts
SKILL.md - Story script
templates/SCRIPT_example.md - Voice track
SKILL.md - Shot merge
templates/scripts/bridge_merge.py - Rendered short
- Final short and mix
Bridge visual production
- Shot plan
templates/bridge/story.ts - Still generation
templates/scripts/bridge-stills.mjs - Scene renderer
templates/bridge/Bridge.tsx - Story and camera
templates/bridge/story.ts - World assembly
templates/bridge/world.ts - Town geometry
templates/bridge/build.ts - Painted textures
templates/bridge/paint.ts - Character cards
templates/bridge/cast.ts - 2D character art
templates/bridge/toon.ts - Ink pass
templates/bridge/ink.ts - Color grade
templates/bridge/grade.ts - Lens blur
templates/bridge/lensblur.ts
Audio production
- Audio timing
templates/audio/timeline.py - March score
templates/audio/music.py - Synth instruments
templates/audio/instruments.py - Sound effects
templates/audio/sfx.py - SFX synthesis
templates/audio/sfx_gen.py - Audio DSP
templates/audio/dsp.py - Stem mix
templates/audio/mix.py
Reference and review
- Frame QA
templates/scripts/short_qa.py - Style study
references/STYLE_BIBLE.md - Measured reports
references/reports
Other components
- Creator
Connections 37
- Creator → Claude skill: requests creation
README.md - Claude skill → Topic and facts: guides research
README.md - Topic and facts → Story script: informs story
README.md - Story script → Voice track: precedes recording
README.md - Voice track → Shot plan: guides shots
README.md - Shot plan → Still generation: plans frames
README.md - Still generation → Scene renderer: previews frames
- Scene renderer → Rendered short: renders frames
- Scene renderer → World assembly: creates world
templates/bridge/Bridge.tsx - Scene renderer → Story and camera: reads timeline
templates/bridge/Bridge.tsx - Scene renderer → Ink pass: uses pass
templates/bridge/Bridge.tsx - Scene renderer → Color grade: uses grade
templates/bridge/Bridge.tsx - Scene renderer → Lens blur: uses blur
templates/bridge/Bridge.tsx - World assembly → Town geometry: uses geometry
templates/bridge/world.ts - World assembly → Painted textures: uses textures
templates/bridge/world.ts - Town geometry → Painted textures: uses textures
templates/bridge/build.ts - Town geometry → Story and camera: reads constants
templates/bridge/build.ts - World assembly → Character cards: assembles cast
templates/bridge/world.ts - Character cards → 2D character art: draws characters
templates/bridge/cast.ts - Scene renderer → Shot merge: supports shot merge
- Shot merge → Frame QA: prepares review
- Frame QA → Rendered short: checks frames
README.md - Style study → Claude skill: guides visual formula
README.md - Measured reports → Claude skill: guides look checks
README.md - Audio timing → March score: times cues
templates/audio/music.py - Audio timing → Sound effects: times effects
templates/audio/sfx.py - March score → Synth instruments: uses instruments
templates/audio/music.py - March score → Audio DSP: uses DSP
templates/audio/music.py - Sound effects → SFX synthesis: generates cues
templates/audio/sfx.py - Sound effects → Audio DSP: uses DSP
templates/audio/sfx.py - Synth instruments → Audio DSP: uses DSP
templates/audio/instruments.py - Stem mix → March score: mixes score
templates/audio/mix.py - Stem mix → Sound effects: mixes effects
templates/audio/mix.py - Stem mix → Audio DSP: uses DSP
templates/audio/mix.py - Stem mix → Audio timing: reads timing
templates/audio/mix.py - Rendered short → Final short and mix: joins sound mix
- Stem mix → Final short and mix: provides sound