How leynos/visual-storytelling-skills works
This repository is an agent-skill pack for AI film-production preparation, with a narration phoneticizer and an OpenShot packaging CLI. Its main workflow moves from prose through continuity inventory and reference assets, shot direction and storyboard/prompt outputs, video generation and assembly, then project packaging. README documents these handoffs and optional image-generation calls; the source excerpts show the packaging CLI, project builder, and Markdown-table helper. Most skill implementations were not sampled, so their internal relationships are shown only where the README explicitly describes them.
Main entry points: video-generator/SKILL.md Video generator · shot-specifier/SKILL.md Shot specifier · scene-inventory-extractor-v2/SKILL.md Scene extractor · nanobanana/SKILL.md Nano Banana
Components 24
Story preparation
- Scene extractor
skills/scene-inventory-extractor-v2/SKILL.md - Continuity inventory
skills/scene-inventory-extractor-v2/SKILL.md - Reference library
skills/scene-inventory-extractor-v2/SKILL.md
Visual development
- Shot specifier
skills/shot-specifier/SKILL.md - Shot specifications
skills/shot-specifier/templates/shot-spec-template.md - Storyboard frames
skills/shot-specifier/references/storyboard-generation.md - Prompt manifest
skills/shot-specifier/references/model-routing.md - Nano Banana
skills/nanobanana/SKILL.md
Video generation
- Video generator
skills/video-generator/SKILL.md - Generated takes
skills/video-generator/references/media-upload-and-state.md - Assembly order
skills/video-generator/templates/assembly-order.md
Supporting skills
- Phoneticizer
skills/phoneticize/SKILL.md - Candidate extraction
skills/phoneticize/scripts/extract_candidates.py - Seedance guidance
skills/seedance-2-deep-dive/SKILL.md - Kling guidance
skills/kling-3-0-deep-dive/SKILL.md
Project packaging
- Packaging CLI
tools/media-project/media_project/cli.py - OpenShot builder
tools/media-project/media_project/openshot_project.py - Markdown tables
tools/media-project/media_project/markdown_tables.py - OpenShot project
tools/media-project/media_project/openshot_project.py
Other components
- Filmmaker
- Script or prose
- Image MCP
- Higgsfield MCP
- Eleven v3
Connections 31
- Filmmaker → Script or prose: provides script
README.md - Script or prose → Scene extractor: submits prose
README.md - Scene extractor → Continuity inventory: extracts continuity
README.md - Scene extractor → Reference library: generates references
README.md - Scene extractor → Nano Banana: requests images
README.md - Nano Banana → Image MCP: generates images
README.md - Continuity inventory → Shot specifier: informs direction
README.md - Reference library → Shot specifier: provides references
README.md - Shot specifier → Shot specifications: produces specs
README.md - Shot specifier → Storyboard frames: produces frames
README.md - Shot specifier → Prompt manifest: produces prompts
README.md - Shot specifier → Nano Banana: requests frame work
README.md - Nano Banana → Storyboard frames: returns keyframes
README.md - Shot specifications → Video generator: guides generation
README.md - Storyboard frames → Video generator: provides frames
README.md - Prompt manifest → Video generator: provides prompts
README.md - Reference library → Video generator: provides references
README.md - Video generator → Higgsfield MCP: submits jobs
README.md - Higgsfield MCP → Generated takes: returns clips
README.md - Video generator → Generated takes: downloads takes
README.md - Video generator → Assembly order: writes order
README.md - Generated takes → Assembly order: selects clips
README.md - Assembly order → Packaging CLI: packages selections
README.md - Filmmaker → Phoneticizer: invokes skill
README.md - Phoneticizer → Candidate extraction: detects candidates
- Phoneticizer → Eleven v3: prepares narration
README.md - Filmmaker → Seedance guidance: consults guidance
README.md - Filmmaker → Kling guidance: consults guidance
README.md - Packaging CLI → OpenShot builder: calls builder
tools/media-project/media_project/cli.py - OpenShot builder → Markdown tables: reads tables
tools/media-project/media_project/openshot_project.py - OpenShot builder → OpenShot project: writes project
tools/media-project/media_project/openshot_project.py