When to use
Load this skill whenever you are writing or reviewing scene-by-scene video direction JSON. Use the example files to calibrate the expected level of phased detail, physical metaphor, and visual richness for each scene.
How to use
Contextual examples (read 0-N based on the script)
Analyze the script first, then read ONLY the example files whose category matches the visual patterns your scenes will need. Most scripts match 2-4 categories. Do NOT read every file.
| Category | Read when the script involves... | File |
|---|---|---|
| Hook scenes (ALWAYS for Scene 0) | Every video has a hook | references/examples/hook-scenes.md |
| UI Mockups | Apps, websites, dashboards, phone screens, checkout forms, product pages, game interfaces | references/examples/ui-mockup-scenes.md |
| Data & Statistics | Charts, gauges, bar graphs, line graphs, data panels with axes and labels | references/examples/data-stats-scenes.md |
| Process & Flow | Step-by-step processes, "how X works", pipelines, circular tracks, node-to-node traversals | references/examples/process-flow-scenes.md |
| Comparisons | "vs", "compared to", before/after, side-by-side, contrasting two alternatives | references/examples/comparison-scenes.md |
| Metaphor & Physics | Abstract concepts shown through physical metaphors -- weight, gravity, orbits, growth, pressure | references/examples/metaphor-physics-scenes.md |
| Cinematic & Atmospheric | Dramatic reveals, science phenomena, nature events, cosmic events, large-scale transformations | references/examples/cinematic-atmospheric-scenes.md |
| Text & Typography | Text-dominant scenes, kinetic typography, word-by-word reveals, editorial corrections | references/examples/text-typography-scenes.md |
| Multi-Element Layouts | Grids, radial arrangements, many items needing spatial organization without overlap | references/examples/multi-element-layout-scenes.md |
| Simple Statements | Short punchy text, bridge transitions, emotional asides, big number reveals, outros | references/examples/simple-statement-scenes.md |
| Object Interaction | Physical objects moving, morphing, emitting signals, connecting, mechanical interaction | references/examples/object-interaction-scenes.md |
| Screen Fill & Reveal | Many identical elements flooding the screen then a dramatic peel/sweep/clearing effect | references/examples/screen-fill-reveal-scenes.md |
| Narrative & Story | Mini-stories within a scene -- setup, event, outcome. A visual narrative arc | references/examples/narrative-story-scenes.md |
Mandatory rule files (read on demand)
- references/ui-mockups.md -- MUST read before writing ANY scene that depicts an app screen, website, dashboard, phone screen, checkout, or game interface.
- references/maps.md -- MUST read before writing ANY scene that involves a world map, country map, geographic distribution, travel route, or location highlight.
Script-to-category matching examples
- "How payment processing works" -> Process & Flow, UI Mockups, Data & Statistics
- "Why most startups fail" -> Metaphor & Physics, Simple Statements, Multi-Element Layouts
- "The speed of light explained" -> Cinematic & Atmospheric, Comparisons, Metaphor & Physics
- "Best mobile app designs of 2025" -> UI Mockups, Multi-Element Layouts, Comparisons
- "How trains changed the world" -> Object Interaction, Narrative & Story, Process & Flow
- "The water cycle explained" -> Process & Flow, Cinematic & Atmospheric, Screen Fill & Reveal