How moh4696/cinematic-skill works
Cinematic Skill is an agent-guided toolkit for making deterministic, code-drawn narrated films. Its main workflow runs from agent-authored story and beat review through timed voice and licensed imagery, into a project scene rendered by the Skia engine, then sound mixing and caption finishing. The graph also preserves map generation, asset preparation, and review renders as distinct capabilities. Relationships for sampled code are tied to excerpts; broader stage links use the README’s workflow. Several scripts are unsampled, so their internal calls are not inferred.
Main entry points: render.py Film Renderer · SKILL.md Film Skill · fetch_commons.py Commons Images · burn_captions.py Caption Finisher
Components 19
Story and Project
- Film Skill
skills/cinematic-film/SKILL.md - Project Starter
skills/cinematic-film/scripts/new_project.py - Beat Planner
skills/cinematic-film/scripts/make_beats.py
Media Preparation
- Commons Images
skills/cinematic-film/scripts/fetch_commons.py - Map Builder
skills/cinematic-film/scripts/make_map.py - Asset Preparation
skills/cinematic-film/scripts/prep_assets.py
Scene and Render
- Scene Definition
skills/cinematic-film/assets/template/scene.py - Film Engine
skills/cinematic-film/scripts/engine.py - Film Renderer
skills/cinematic-film/scripts/render.py
Voice and Sound
- Scratch Voice
skills/cinematic-film/scripts/tts_say.py - Take Splitter
skills/cinematic-film/scripts/split_takes.py - Narration Builder
skills/cinematic-film/scripts/build_narration.py - Effects Synth
skills/cinematic-film/scripts/build_sfx.py - Sound Mixer
skills/cinematic-film/scripts/mix_soundtrack.py
Captions and Output
- Caption Styles
skills/cinematic-film/scripts/captions.py - Caption Finisher
skills/cinematic-film/scripts/burn_captions.py
Other components
- Coding Agent
- Wikimedia Commons
- Finished Film
Connections 22
- Coding Agent → Film Skill: uses
README.md - Film Skill → Project Starter: starts project
README.md - Coding Agent → Beat Planner: plans story
README.md - Film Skill → Beat Planner: guides beats
README.md - Coding Agent → Scene Definition: authors scene
README.md - Coding Agent → Commons Images: finds images
README.md - Commons Images → Wikimedia Commons: searches and downloads
skills/cinematic-film/scripts/fetch_commons.py - Coding Agent → Map Builder: builds maps
README.md - Commons Images → Asset Preparation: prepares photos
README.md - Coding Agent → Scratch Voice: creates scratch voice
README.md - Scratch Voice → Take Splitter: splits recordings
README.md - Take Splitter → Narration Builder: times narration
README.md - Scene Definition → Film Renderer: loads scene
skills/cinematic-film/scripts/render.py - Film Renderer → Film Engine: renders frames
skills/cinematic-film/scripts/render.py - Film Renderer → Effects Synth: writes cue list
skills/cinematic-film/scripts/build_sfx.py - Narration Builder → Sound Mixer: mixes voice
README.md - Effects Synth → Sound Mixer: mixes effects
README.md - Film Renderer → Caption Finisher: finishes render
README.md - Caption Finisher → Caption Styles: uses styles
skills/cinematic-film/scripts/burn_captions.py - Caption Finisher → Finished Film: writes captions and SRT
README.md - Sound Mixer → Finished Film: provides soundtrack
README.md - Film Renderer → Finished Film: renders video
README.md