Files
calesthio f45ae2f933 docs(prompting): adopt 5-aspect video specification across skills
Incorporate the structured taxonomy from Lin et al. "Building a Precise
Video Language with Human-AI Oversight" (CMU/Harvard, arXiv 2604.21718v2).
The paper proves prompts structured around five aspects (Subject /
Subject Motion / Scene / Spatial Framing / Camera) unlock controllable
cinematography in fine-tuned video generation models. Off-the-shelf VLMs
already nail subject and scene; the gains live in motion, spatial, and
camera, which prompts routinely omit.

Universal layer (skills/creative/video-gen-prompting.md, +125 lines):
- 5-aspect prompt skeleton replaces flat formula
- Camera movements regrouped (translation / rotation / lens-only) with
  dolly!=zoom, pan!=truck, bird's-eye!=aerial disambiguations
- New primitive tables: camera height, camera angle, POV, lens
  distortion (fisheye vs barrel), focus / DoF (rack / pull / tracking),
  playback speed (6 modes), subject transitions
- Order-matters and self-contained-prompt rules
- Identity anchoring rule for multi-shot
- Strict static-shot rule, anti-subjective callout, overlays-not-depth
- Per-model word-count guidance

Per-model guides (sora, veo, hunyuan, ltx, seedance):
- Add the primitives each model honors literally
- Word-count sweet spots per model
- Strengthen seedance verbatim-identity and subject-transition guidance

Pipeline directors (cinematic / explainer / animation scene-director,
cinematic / explainer asset-director):
- 5-aspect scene-plan checklist (per-pipeline adapted)
- Overlays-not-depth callout
- Pre / critique / post self-review loop for generation prompts

Reviewer (skills/meta/reviewer.md):
- CHAI critique-quality rules: accurate / complete / constructive
- Critical findings now require a proposed_fix

Storytelling, cinematic, broll, video-reference-analyst:
- Anti-subjective rule (replace mood adjectives with visual causes)
- Camera-intent-per-beat for script writers
- POV column in stock-footage query templates
- 5-aspect structured output mandatory for reference-video analysis

skills/INDEX.md: video-gen-prompting marked as canonical 5-aspect spec.
2026-04-28 08:11:31 -07:00

3.8 KiB
Raw Permalink Blame History

Sora 2 — Prompting Guide

Source: OpenAI Sora 2 Cookbook For universal vocabulary, see: skills/creative/video-gen-prompting.md

Word count: Sora 2 plateaus around 100–250 words. Past 250, additional detail rarely improves output.

Sora-Specific Prompt Template

Sora responds best to a structured format with prose + cinematography block + action beats:

[Prose scene description — characters, costumes, scenery, weather, details.
 Be as descriptive as possible to match your vision.]

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]
- [Beat 3: reaction or dialogue]

Dialogue:
[Short natural lines, kept brief for clip length]

Advanced Optional Fields

Sora uniquely responds to these production-level details that most models ignore:

Field Example
Lens spec "40mm spherical", "85mm", "Anamorphic 2.0x"
Filtration "Black Pro-Mist 1/4", "slight CPL rotation"
Grade / palette "Warm Kodak-inspired grade", "teal-and-orange LUT"
Film stock emulation "16mm black-and-white", "35mm photochemical contrast"
Diegetic sound "faint rail screech, rain patters window, clock ticks"
Wardrobe "navy coat, sleeves rolled, suspenders loose"
Finishing "fine-grain overlay, mild halation, gate weave, soft vignette"
Shutter "180° shutter angle"
Playback speed "speed ramp from 1x to 0.25x mid-shot", "stop-motion staccato", "time-reversed exhale"
Lens distortion "fisheye barrel distortion at the edges", "subtle barrel curvature on straight lines"
Focus mode "rack focus from foreground bottle to background figure", "deep focus, FG to BG sharp"

What Sora Does Differently

  • Prose-first: Write a rich paragraph, then add technical blocks. Don't lead with camera specs.
  • Character references: Can lock onto up to 2 uploaded character IDs via API.
  • Dialogue sync: Short lines work. Complex multi-character dialogue does not.
  • Edit commands: "Same shot, switch to 85mm" or "Same lighting, new palette: teal, sand, rust" — Sora supports iterative refinement on existing generations.
  • Creative freedom: Shorter prompts → more creative latitude. Longer → more control.

Color Palette Technique

Name 3-5 anchor colors instead of vague "warm tones":

  • "Amber, cream, walnut brown" (vintage warmth)
  • "Teal, sand, rust" (coastal desert)
  • "Cool blues with warm tungsten accents" (noir)

Sora API Parameters (cannot be set in prompt)

  • model: sora-2 or sora-2-pro
  • size: 720x1280, 1280x720, 1080x1920, 1920x1080, 1024x1792, 1792x1024
  • seconds: 4, 8, 12, 16, 20

Example

Style: Hand-painted 2D/3D hybrid animation with soft brush textures,
warm tungsten lighting, tactile stop-motion feel. Subtle watercolor wash;
warm-cool balance; filmic motion blur.

Inside a cluttered workshop, shelves overflow with gears and yellowing
blueprints. Small round robot sits on wooden bench, dented body patched
with mismatched plates. Large glowing blue eyes flicker as it fiddles
with a humming light bulb.

Cinematography:
Camera: medium close-up, slow push-in with gentle parallax from hanging tools
Lens: 35mm virtual; shallow depth of field
Lighting: warm key from overhead practical; cool spill from window
Mood: gentle, whimsical, touch of suspense

Actions:
- Robot taps bulb; sparks crackle
- Flinches, dropping bulb, eyes widening
- Bulb tumbles in slow motion; catches it just in time
- Puff of steam escapes chest — relief and pride

Background Sound:
Rain, ticking clock, soft mechanical hum, faint bulb sizzle