ai-video-shot-producer

name	ai-video-shot-producer
description	Write keyframe image requests and a video prompt for one shot.

AI Video Shot Producer

Cinematographer Stance

Act as an excellent cinematographer preparing one shot for image-to-video generation: preserve the director's dramatic purpose, compose stable start and end frame requests, protect visual continuity, and keep motion simple enough to generate reliably.

Workflow

1. Read one target shot record from preproduction/shots.yaml by shot_id.
2. Read the shot's frame briefs, motion_brief, relevant preproduction/visual_style.yaml cues, and generated concept references for the shot's concepts.
3. Write shots/<shot_id>/keyframe_plan.yaml as a cinematographer's keyframe plan: build a reference pool in references.concepts, choose the concept IDs needed by each keyframe in start_frame.concepts and end_frame.concepts, and turn the frame briefs into composed image prompts. The start and end frames must be two moments from the same continuous shot, not different scenes.
4. Write shots/<shot_id>/keyframes/start_image_request.yaml using start_frame.prompt.
5. Write shots/<shot_id>/keyframes/end_image_request.yaml using end_frame.prompt.
6. Write shots/<shot_id>/video_prompt.md as one concise English paragraph using assets/templates/video_prompt.md; describe continuous motion from the start frame to the end frame without cuts, transitions, montage, or scene changes.

Required Outputs

Create these outputs for this one shot:

• shots/<shot_id>/keyframe_plan.yaml
• shots/<shot_id>/keyframes/start_image_request.yaml
• shots/<shot_id>/keyframes/end_image_request.yaml
• shots/<shot_id>/video_prompt.md

Resources

Use this skill's bundled template at skills/ai-video-shot-producer/assets/templates/keyframe_plan.yaml as the structure reference for this shot's planning file.

Use this skill's bundled template at skills/ai-video-shot-producer/assets/templates/image_request.yaml for each keyframe image request.

Use this skill's bundled template at skills/ai-video-shot-producer/assets/templates/video_prompt.md to write video_prompt.md.

Each image request must include the relevant concept reference paths and set output_path to either shots/<shot_id>/keyframes/start_v001.png or shots/<shot_id>/keyframes/end_v001.png.

Validate with this skill's bundled validator at skills/ai-video-shot-producer/scripts/validate_outputs.py, passing --project <project> --shot-id <shot_id>. Fix any reported issue before returning.