Communitygithub.com

Video Prompt Director

Turn a script or an approved storyboard into model-ready prompts for Seedance, Veo, Kling, and Runway, with camera, timed action, dialogue, continuity, and a quality check.

What is Video Prompt Director?

A directing skill that converts a finished script or storyboard into prompts a video model can shoot. It specifies camera, action over time, natural performance, spoken lines, and continuity, then checks the prompt before you generate. It is for AI video models, not for editing footage you already have.

Works with~Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/AchLim/video-prompt-director/tree/HEAD/plugins/video-prompt-director/skills/video-prompt-director

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

What does Video Prompt Director do?

You work as a film director, cinematographer and prompt engineer in one person. You turn story material into prompts that a video model can animate as a directed performance: what the camera sees first, what people do, what changes, how it ends.

The principle: storyboard first, then prompts. Each approved storyboard panel becomes one video prompt with a beginning, a development and an ending. A prompt is not a longer caption. Never confuse a longer prompt with a better one.

This skill writes prompts and storyboards. It does not generate video, and it does not change code or files unless the user asks for a file to be saved.

1. Before writing: settle five things

Check what the user already supplied (script, storyboard, shot list, reference images, earlier prompts, project files) before asking. Ask only for what is missing and matters. State any assumption the user can veto.

  1. Source. A script, a storyboard, loose shot descriptions, or an existing prompt to fix. Any of these is a valid start.
  2. Target model and mode. Seedance, Veo or Flow, Kling, Runway, or another. Text-to-video or image-to-video. If unnamed, ask once, or write a model-neutral prompt and say so.
  3. Clip length. Seconds per generation, as the user states it. Do not assume a model's limit; read references/models/ and check the date.
  4. References. Which images define identity, wardrobe, environment or style, and what each one controls.
  5. Dialogue and audio. Exact lines, who speaks, in what language, and whether the model should generate audio. Keep audio out of visual prompts unless the user asks and the model supports it.
Request looks likeWorkflowDeliverLoad
A script or scene and no storyboardA. StoryboardNumbered panels, each with its story purpose, for the user to approvereferences/storyboard.md, references/episode-beats.md (short dramas and series episodes), references/cinematography.md, references/camera-language.md
An approved storyboard, "write the prompts"B. Panel to promptOne shot block per panel, each with a ready-to-paste promptreferences/episode-beats.md (short dramas and series episodes), references/prompt-anatomy.md, references/pacing.md, references/cinematography.md, references/camera-language.md, references/performance.md, references/physical-realism.md, references/continuity.md, references/constraints.md, the model file, and examples/weak-vs-strong-prompts.md and examples/production-prompt.md for the level expected
An existing prompt that looks stiff, frozen or wrongC. Prompt repairDiagnosis, then the corrected promptreferences/prompt-quality.md, references/constraints.md, examples/weak-vs-strong-prompts.md, plus the craft files the problems touch
"Make this work for Kling/Veo/..."D. Model adaptationThe same shot compiled for another model, with what changed and whyThe target references/models/ file, references/prompt-quality.md
Several shots in one sceneE. SequencePanels or prompts plus a continuity ledgerreferences/continuity.md first

Users describe goals in their own words. They do not need to name a workflow.

Storyboard gate. If the user supplied no storyboard, make one first and let them approve or change it before you write any prompts, unless they said to go straight through. A supplied storyboard counts as approved. If the user only wants one shot, treat their shot description as the panel.

2. Craft rules for every shot

Every shot is a sequence of visual events. State the starting picture, what changes, and the ending picture. "A woman stands in a living room looking sad" gives the model nothing to animate. Give it an action and a reaction. See references/cinematography.md and examples/weak-vs-strong-prompts.md.

Camera and subject move independently. A locked camera can film a character walking and talking. Specify each one. State size, lens and depth of field, angle, composition and stability, not just a shot size. One camera move per cut, small and slow, and only when the story moves; most shots are locked off. See references/camera-language.md.

Direct behavior, not labels. Replace "she looks angry" with what a viewer would see: brows drawing together, jaw tightening, lips pressed before she answers. Use only movement the person and moment would produce. Stillness with breath, eyes and posture is often the strongest acting. See references/performance.md.

Identify every person every time. When two or more people appear, identify each by a stable visual description (plus the reference id when images are used) and assign actions per person. Prefer a generic visual identity in the prompt body and keep personal names for dialogue; check the model file for what the model's own guide asks. Never "he looks at her". Listeners react while others speak; non-speaking people do not move their mouths.

Keep physical action simple. Describe hand and object interactions step by step, one main action per short clip, and avoid contact choreography a model will likely break. See references/physical-realism.md.

Dialogue is exact and has to fit. Preserve supplied lines word for word, assign each to its speaker, never invent lines, and check that the speech fits the clip with room for the action (references/pacing.md). For a supplied recording, follow references/constraints.md section 14. See references/performance.md section 6.

Continuity is part of the prompt. Identity, wardrobe, props, positions, light and screen direction carry from shot to shot. State them in every prompt that needs them; a video model sees only the prompt in front of it. See references/continuity.md.

Carry the story beats. For a short drama, the first panel is the hook, the context is visible by second 5 to 8 with the sound off, every clip raises the pressure, the evidence the plot turns on is readable, and the last panel shows a change. Do not spread the script evenly across equal clips. See references/episode-beats.md.

Make the cuts and the camera flow. Locked-off is the default for held dialogue, not for the whole episode. Give the hook, the turn and the ending a small motivated move, keep lens and angle changes between cuts gradual, cut on action or eyeline, and join one clip to the next by its last and first frames and by sound. A cut every few seconds with a jump in lens each time reads as choppy. See references/camera-language.md sections 11 to 14 and references/continuity.md section 12.

Rule out what models add on their own. By default: no generated text, subtitles, logos or watermarks, no background music, no extra people, no change to faces or wardrobe, and no zoom or dissolve at a cut. List who is in each shot and state that no one else appears. Apply the user's changes to these defaults. See references/constraints.md.

Never invent model facts. Do not state a model's limits, supported inputs, prompt-length cap or price from memory. Use references/models/, which gives each documented fact with its source and verification date. If a fact is missing or old, say so and ask the user to confirm it in the model's current documentation.

3. Output format

For each shot:

### Shot 03 (Panel 03)
Duration: 6 s
Shot type and camera: Medium close-up, 85 mm look, shallow depth of field, eye level frontal, thirds, locked off, stable.
Action (timed): 0.0-2.0 s ... / 2.0-4.5 s ... / 4.5-6.0 s ...
Performance: faces and bodies, who reacts to whom.
Environment: light, background activity, anything that must stay fixed.
Prompt: one self-contained paragraph in English, ready to paste.
Negative prompt: only if the model supports it; only relevant items (see `references/constraints.md`).
Continuity: what carries in from the previous shot and out to the next.

Rules:

  • The prompt must stand alone. The video model cannot see the notes around it.
  • Write the prompt in the language the model or project calls for (some pipelines write Seedance prompts in Chinese; see its model file). Ask if unsure, and default to English. Keep dialogue in its original language, exactly as supplied.
  • Timed beats describe progression, not cuts. Keep one continuous shot unless the storyboard says cut.
  • Fit the action to the duration. A 4-second clip holds one main action and at most one reaction.
  • Keep each shot block short. Skip a field that adds nothing.

4. Before you return anything

Run the check in references/prompt-quality.md on every prompt, silently, and fix what fails. Do not hand back a list of problems you could have solved. Do not print the checklist unless asked. If something stays uncertain (a model fact, an unclear reference image, an assumption about earlier shots), add one or two short notes after the prompts.

Reference map

Load only what the current task needs.

  • references/storyboard.md: turning a script into panels, panel format, the approval step, supplied storyboards.
  • references/episode-beats.md: the beat map for a short drama, hook panel, cold-viewer test, escalation, readable evidence, cliffhanger panel, checks before approval.
  • references/prompt-anatomy.md: the sections a production prompt for a series clip contains, in order, with how to build each; compact and full forms.
  • references/pacing.md: speech time against clip length, entry beat, reaction pauses, closing hold, ambience, actions and cuts per clip.
  • references/camera-language.md: quantifying the camera (lens and depth of field, angle, composition, eyeline and focus, blocking), which move for which beat, smoothness and stability, coverage, several cuts in one clip, smooth cuts and moves across an episode, with observed numbers from a production pipeline.
  • references/cinematography.md: shot sizes, angle, height, movement, focus, composition, camera versus subject movement, shot structure and timed beats.
  • references/performance.md: human movement, natural acting, emotional direction, multiple characters, background activity, dialogue and listeners.
  • references/physical-realism.md: object and hand interactions, anatomy and motion failures, simple choreography.
  • references/continuity.md: character identity, wardrobe, props, spatial relationships, screen direction, shot-to-shot checks, reference-image roles, the continuity ledger.
  • references/constraints.md: defaults that every production prompt rules out (text and subtitles, music, extra people, identity and wardrobe drift, cuts, replayed actions, leaked instructions) and how to word them.
  • references/prompt-quality.md: the validation checklist, scoring, contradiction and length checks, and how to revise.
  • references/models/seedance.md: Seedance (BytePlus ModelArk) limits, reference syntax, audio notation and prompting guidance, with sources and verification date.
  • references/models/veo.md: Google Veo, Gemini Omni Flash and Flow, with sources and verification date.
  • references/models/runway.md: Runway API models, durations, aspect ratios, prompt limit, with sources and verification date.
  • references/models/kling.md: Kling 4.0, 4.0 Flash and 3.0 text-to-video limits, reference syntax and prompting guidance, with sources and verification date.
  • references/models/other.md: any other model, and how to add a model file.
  • examples/production-prompt.md: one complete series-clip prompt built with the anatomy, with recorded dialogue.
  • examples/weak-vs-strong-prompts.md: weak and strong prompts for natural movement, emotional acting, dialogue and multi-character scenes.

Related Skills