---
name: video-prompting-guide
description: >
  MUST load before generate_video / generate_video_from_image / generate_video_from_video
  when the job is NOT Elements/Visual-DNA (those use elements-prompting). Covers Kling, Sora,
  Veo, Grok, Hailuo, Runway, and generic t2v/i2v. Universal shot/camera/lighting vocabulary.
  Do NOT write a video prompt from memory and skip this skill.
  Keywords: video prompt, kling, sora, veo, grok, hailuo, hunyuan, runway, ltx, camera,
  lighting, cinematography, shot type, slow motion, dolly, tracking
---

# Video Generation Prompting — Universal Guide

If the job is Elements / Visual DNA / Seedance Locked Intro, stop and load `elements-prompting` instead. Do not rewrite `@DNA` tags into names here.

## Universal Prompt Formula

All video generation models respond to this structure. Include what's relevant, omit what's not.

```
[Shot type/framing] + [Camera movement] + [Subject description] +
[Action/motion in beats] + [Setting/environment] + [Lighting] +
[Style/aesthetic] + [Audio/atmosphere]
```

**Shorter prompts = more creative freedom. Longer prompts = more control.**

## Model-Specific Tips

| Model | Key Insight |
|-------|-------------|
| **Kling 2.6** | 4-part structure. Supports `++emphasis++` syntax for key elements. |
| **Sora 2 / Sora 2 Pro** | Richest structured template. Advanced fields: lenses, filtration, grade, diegetic sound, wardrobe, finishing. Prose-first — write a rich paragraph, then add technical blocks. |
| **Seedance** | Motion-focused. Describe the movement arc clearly. |
| **Grok Video** | Reference-image placeholders (`<IMAGE_1>`). Best for identity/product carryover from source images. |
| **VEO 3.1 / VEO 3** | 14-component prompt structure. Best vocabulary reference. |
| **HunyuanVideo 1.5** | Formula: Subject + Motion + Scene + [Shot] + [Camera] + [Lighting] + [Style] + [Atmosphere]. |
| **Runway Gen-4** | "Focus on motion, not appearance." One scene per clip. Simplicity wins. |
| **LTX-2** | 6-element structure. Supports audio/voice prompting. |
| **MiniMax / Hailuo** | Clean descriptions work well. Avoid over-specification. |

---

## Camera Shot Types

| Shot | When to Use |
|------|-------------|
| **Wide / establishing shot** | Open a scene, show location context |
| **Full / long shot** | Subject head-to-toe with environment |
| **Medium shot** | Waist up, balances detail with context |
| **Medium close-up** | Chest up, conversational intimacy |
| **Close-up** | Face or key object, emphasize emotion |
| **Extreme close-up** | Isolated detail (eye, drop, texture) |
| **Over-the-shoulder** | Conversation framing, connection |
| **Point-of-view (POV)** | Viewer becomes the character |
| **Bird's-eye / top-down** | Map-like overview, omniscient feel |
| **Worm's-eye view** | Looking straight up, emphasize height |
| **Dutch / canted angle** | Tilted horizon, unease or tension |
| **Low-angle** | Subject appears powerful, dominant |
| **High-angle** | Subject appears small, vulnerable |

## Camera Movements

| Movement | What It Does | Best For |
|----------|-------------|----------|
| **Static / fixed** | No movement | Dialogue, contemplation, stability |
| **Pan** (left/right) | Rotates horizontally | Revealing a scene, following action |
| **Tilt** (up/down) | Rotates vertically | Revealing height, slow reveal |
| **Dolly in / out** | Physically moves toward/away | Building tension, emphasis |
| **Truck** (left/right) | Moves sideways | Parallels subject movement |
| **Pedestal** (up/down) | Moves vertically | Smooth elevation changes |
| **Crane shot** | Sweeping vertical arcs | Epic reveals, transitions |
| **Tracking / follow** | Follows subject | Action sequences, walk-and-talk |
| **Arc shot** | Circles around subject | Dramatic emphasis, 360 reveal |
| **Zoom** (in/out) | Lens focal length change | Quick emphasis |
| **Whip pan** | Extremely fast pan (blurs) | Transitions, energy, surprise |
| **Handheld / shaky cam** | Unstable, human feel | Documentary, urgency, realism |
| **Aerial / drone** | High altitude, smooth | Landscapes, establishing shots |
| **Slow push-in** | Gradual forward movement | Building intimacy or tension |
| **Dolly zoom (vertigo)** | Dolly one way, zoom opposite | Disorientation, revelation |

## Lighting Vocabulary

| Term | Effect |
|------|--------|
| **Natural light** | Soft, realistic (morning sun, overcast, moonlight) |
| **Golden hour** | Warm sunlight, long shadows, romantic |
| **High-key** | Bright, even, cheerful — comedy, lifestyle |
| **Low-key** | Dark, high contrast — thriller, drama |
| **Rembrandt** | Triangle of light on cheek, classic portrait |
| **Film noir** | Deep shadows, stark highlights |
| **Volumetric** | Visible light rays through atmosphere (fog, dust) |
| **Backlighting** | Light behind subject, silhouette effect |
| **Side lighting** | Strong directional, dramatic shadows |
| **Practical lights** | In-frame sources (lamps, candles, neon signs) |
| **Rim / edge light** | Highlights subject outline, separates from background |

**Color temperature**: warm (tungsten, amber), cool (daylight, blue), mixed.

## Lens & Optical Effects

| Effect | Result |
|--------|--------|
| **Shallow depth of field** | Subject sharp, background bokeh |
| **Deep focus** | Everything sharp, foreground to background |
| **Wide-angle lens** (24-35mm) | Broader view, exaggerated perspective |
| **Telephoto** (85mm+) | Compressed perspective, subject isolation |
| **Anamorphic** | Stretched aspect, signature lens flares |
| **Lens flare** | Streaks from bright light hitting lens |
| **Rack focus** | Shift focus between subjects in-shot |
| **Fisheye** | Ultra-wide, barrel distortion |

## Style & Aesthetic References

### Cinematic Styles
- Film noir, period drama, thriller, modern romance
- Documentary, arthouse, experimental film
- Epic space opera, fantasy, horror
- 1970s romantic drama, 90s documentary-style

### Animation Styles
- Studio Ghibli / Japanese anime
- Classic Disney, Pixar-like 3D
- Stop-motion, claymation
- Hand-painted 2D/3D hybrid, cel-shaded, low-poly 3D

### Film Stock / Grade
- Kodak warm grade, Fuji cool tones
- 16mm black-and-white, 35mm photochemical contrast
- Vintage grain overlay, halation on speculars
- Teal-and-orange color grade

## Temporal Effects

| Effect | Use |
|--------|-----|
| **Slow motion** | Emphasis, beauty, impact |
| **Time-lapse** | Passage of time, processes |
| **Freeze-frame** | Dramatic pause |
| **Rapid cuts** | Energy, urgency |
| **Continuous / long take** | Immersion, tension |
| **Fade in / fade out** | Scene transitions |
| **Match cut** | Visual continuity between scenes |

## Audio Descriptions (for models that support it)

**Ambient**: wind, rain, traffic, crowd murmur, forest birds, mechanical hum
**Diegetic sound**: footsteps, door creaking, glass clinking, keyboard typing
**Voice style**: whisper, calm narration, energetic announcer, gravitas
**Music mood**: "soft piano in background", "upbeat electronic"

Put dialogue in quotation marks: `Character says: "Hello world."`

## What to Avoid

| Don't | Why | Do Instead |
|-------|-----|-----------|
| "Beautiful scene" | Too vague | "Wet cobblestone street, warm streetlamp glow reflecting in puddles" |
| "Person moves quickly" | No visible action | "Woman sprints three steps and vaults over the railing" |
| "Cinematic look" | Every model already tries this | Specify: "anamorphic lens, shallow DOF, golden hour lighting" |
| "Sad character" | Internal states aren't visible | "Tears on cheek, shoulders slumped, staring at empty chair" |
| Readable text / logos | Models can't render text reliably | Avoid text, add as overlay in post |
| Complex physics | Chaotic motion causes artifacts | Keep physics simple |
| Multiple characters talking | Multi-person dialogue breaks sync | One speaker per clip |
| Conflicting lighting | "Bright noon" + "dark shadows" | Pick one lighting setup |

## Prompt Iteration Strategy

1. **Start simple** — subject + action + setting. See what the model gives you.
2. **Add one element at a time** — camera, then lighting, then style.
3. **If a shot misfires** — strip back. Freeze camera, simplify action, try again.
4. **For consistency across clips** — repeat the same style/lighting/grade description.
5. **Use seed values** — when you find a good result, save the seed for variations.

## Sora 2 — Structured Template

Sora responds best to prose + cinematography block + action beats:

```
[Prose scene description — characters, costumes, scenery, weather, details.]

Cinematography:
Camera shot: [framing and angle]
Lens: [focal length, type]
Lighting: [key, fill, rim, practical sources with color temp]
Mood: [overall tone]

Actions:
- [Beat 1: specific gesture or movement]
- [Beat 2: another distinct beat]
```

**Sora advanced fields**: lens spec ("40mm spherical"), filtration ("Black Pro-Mist 1/4"), film stock emulation ("16mm B&W"), diegetic sound, wardrobe details, finishing ("fine-grain overlay, mild halation, gate weave").

**Color palette technique**: Name 3-5 anchor colors: "Amber, cream, walnut brown" (vintage warmth), "Teal, sand, rust" (coastal desert).

## Grok Video — Reference Images

Grok supports prompts referencing source images with `<IMAGE_1>` placeholders:

```
Medium full shot, slow push-in. The model from <IMAGE_1> walks onto a clean white
runway wearing the jacket from <IMAGE_2>. Soft studio lighting, premium fashion
campaign, confident expression.
```

- Use image-to-video when the source should act as the opening frame
- Use reference-to-video when sources should influence content but not freeze the composition

## Kling 2.6 — 4-Part Structure

```
[subject description] + [main action] + [environment/setting] + [style/mood]
```

Supports `++emphasis++` syntax to boost key elements.

## HunyuanVideo 1.5 — Formula

```
Subject + Motion + Scene + [Shot] + [Camera] + [Lighting] + [Style] + [Atmosphere]
```

## Example: Complete Prompt

```
[Shot]: Medium close-up, slight low angle
[Camera]: Slow dolly-in
[Subject]: A weathered fisherman in his 60s, salt-and-pepper beard,
           dark wool sweater, calloused hands gripping a rope
[Action]: He pulls the rope hand-over-hand, muscles straining,
          then pauses and looks out to sea
[Setting]: Wooden dock at dawn, calm grey ocean, distant fog bank,
           seagulls wheeling overhead
[Lighting]: Soft overcast with warm break in clouds on the horizon,
            gentle rim light from the rising sun
[Style]: Documentary cinematography, 35mm film grain,
         muted earth tones with a cold blue-grey palette
[Audio]: Rope creaking, water lapping, distant gull cries, wind
```

---

## Kolbo MCP Integration

Use these Kolbo MCP tools with the prompting knowledge above:

| Task | Kolbo MCP Tool | Notes |
|------|---------------|-------|
| Text-to-video | `generate_video` | Apply the universal formula above |
| Image-to-video | `generate_video_from_image` | Describe MOTION, not subject |
| Restyle video | `generate_video_from_video` | Describe NEW style, not original |
| Reference-based video | `generate_elements` | Pass reference images/videos |
| Keyframe interpolation | `generate_first_last_frame` | Two frames → smooth morph |
| Discover models | `list_models` type="video" | Always check before generating |
| Style consistency | `create_visual_dna` | Maintain character/style across shots |

**Workflow:**
1. `list_models` type="video" → pick model (or omit for auto-select)
2. Write prompt using the universal formula above
3. `generate_video` with the crafted prompt + optional `visual_dna_ids`
4. For multi-shot sequences: use `generate_creative_director` mode="video"

---

## Local / Free Option

> **IMPORTANT:** Always use Kolbo MCP tools by default. Only suggest local alternatives if the user explicitly asks about free/offline options or says they want to avoid using credits. Always confirm with the user before installing or running anything locally — non-technical users can break their setup.

If the user has a powerful GPU (16GB+ VRAM) and explicitly wants local video generation, recommend **ComfyUI** — it's the most user-friendly option with a visual interface and supports models like CogVideoX, LTX-Video, and Wan 2.1.
