shot-design
Installation
SKILL.md
Shot Design
Workflow
- Read core contract,
VISIBLE_DIALOGUE_SYNC.md, dramaturgy rules, film grammar, prompt packet schema, screenplay scene, line manifest, breakdown, director book, continuity, production capabilities when present, performance blocking when present, and approved reference manifest. - Assign stable
SHOT-###IDs within the project sequence. - Design the minimum coverage needed for the intended cut.
- Write one model-neutral JSON object per shot to
04_generation/shot_briefs.jsonl. - Each shot must include
line_idsfor the source production units it covers when a line manifest exists, plus purpose, dramatic job, beat, scene ID, duration, subjects, location, continuity, framing, composition, camera, movement reason, eye trace, action, environmental pressure, micro-action, anchor, lighting, dialogue, ambience, music, SFX, references, cut intent, and constraints. - Resolve applicable visual-bible capture behavior into
capture_behaviorwithout inventing camera hardware. - When the viewer must see a character speak an exact screenplay line, add the model-neutral
lip_syncrecord with exactLINE-###, speaker, visibility, cut policy, and measured timing when available. Do not force lip sync onto off-screen dialogue. When approved audio exists, preserve itsMEDIA-###, SHA-256 authority, and start time and run dialogue timing preflight before expensive generation. - Add
end_frameonly when chained generation, match on action, last-frame conditioning, or editorial continuity needs an explicit final state. When motion state also matters, add a temporal-continuity handoff that uses the approved previous shot and a visual-only tail; do not import prior-shot audio. - Add optional
frame_regionsonly when multi-subject screen placement needs explicit control or the downstream route supports regional conditioning. Use semantic zones unless normalized bounds were deliberately planned. - Check screen direction, eyelines, eye trace, and geography across adjacent shots.
- If the requested camera/action combination is unavailable or conditional in
production_capabilities.json, redesign, split, or mark the blocker rather than pretending it is executable. - Delete shots that do not change a relationship or emotion, advance action or information, increase pressure, or satisfy an explicit practical coverage need.