🎬 AI Cinema Director Skill
A specialized skill for AI Agents to direct high-fidelity cinematic video.
The Cinema Director skill translates high-level creative intent into technical cinematographic directives for state-of-the-art video models (Veo3, Kling, Luma).
Core Competencies
- Shot Composition Analysis: Mapping emotional beats to appropriate framing (e.g., Extreme Close-Up for intimacy, Wide Shot for isolation).
- Camera Movement Orchestration: Directing complex physical movements (Dolly, Truck, Crane) and lens-based effects (Rack Focus, Dolly Zoom).
- Lighting & Atmosphere Design: Specifying temporal and stylistic lighting (Golden Hour, Chiaroscuro, Volumetric God Rays).
- Technical Parameter Optimization: Automatically selecting optimal frame rates, aspect ratios, and model-specific biases.
🏗️ Technical Specification
1. Intent Mapping Table
| Creative Intent |
Framing |
Movement |
Lighting |
| Heroic Reveal |
Low Angle / Wide |
Crane Up / Orbit |
Rim Lighting / High Contrast |
| Tense/Uneasy |
Dutch Angle |
Handheld Shake |
Low Key / Harsh Shadows |
| Introspective |
Close-Up |
Slow Push In |
Soft Rembrandt / Window Light |
| Majestic/Epic |
Extreme Wide |
Drone Flyover |
Golden Hour / Volumetric |
| Melancholic |
Profile / Medium |
Slow Pull Out |
Blue Hour / Desaturated |
2. Physical Camera Movements
Dolly In/Out: Physical camera movement on a track toward/away from the subject.
Truck Left/Right: Lateral physical movement.
Crane/Jib: Sweeping vertical movement from a height.
Orbit: Circular movement around a center point.
Pedestal: Vertical elevation change (without tilting).
3. Lens & Optical Controls
Shallow DOF: Background blur (Bokeh).
Anamorphic: Horizontal flares and wide-screen cinematic feel.
Rack Focus: Shifting focus between planes within the shot.
🧠 Prompt Optimization Protocol (Agent Instruction)
Before calling the script, the Agent MUST expand the user's raw prompt using these Director's Rules:
- TECHNICAL INFUSION: Transform "cool action" into a technical shot.
- Formula:
[Shot Type] + [Subject/Action] + [Environment] + [Lighting] + [Camera Movement] + [Lens Effect]
- MOTION DYNAMICS: Use cinematic verbs: Dolly In (intimacy), Crane Up (majestic), Orbit (heroic), Truck (parallel motion).
- LIGHTING RECIPES: Apply specific illumination: Volumetric God Rays, Teal-and-Orange Grade, Cyberpunk Rim Lighting, Rembrandt Portrait Lighting.
- PHYSICS LOGIC: Describe light relationships (e.g., "Neon reflections shimmering on rain-slicked asphalt") to trigger model reasoning.
🚀 Protocol: Using the Cinema Director
Step 1: Define the Creative Brief
Provide the agent with a subject and a "Director's Intent."
Step 2: Invoke the Script
The generate-film.sh script accepts a --brief which it expands using its internal knowledge of cinematography.
# Directing a scene
bash scripts/generate-film.sh
--subject "A lone samurai in a blizzard"
--intent "epic reveal"
--model "kling-master"
Step 3: Handle the Async Response
Video generation is asynchronous. Use the returned request_id to poll for completion via core/platform/check-result.sh.
⚠️ Constraints & Guardrails
- Temporal Consistency: Avoid complex subject transformations in a single shot (e.g., "man turns into a bird").
- Movement Collisions: Do not combine contradictory movements (e.g., "Dolly In" and "Dolly Out" simultaneously).
- Physical Realism: Prefer movements possible with real-world equipment for a more professional "film" look.
- Model Bias:
Veo3: Best for slow, high-quality aesthetic shots.
Kling: Best for complex character motion and physics.
Luma: Best for fast-paced, high-action cinematic sequences.
⚙️ Implementation Details
This skill acts as an "Expert Translator" for the core/media/generate-video.sh primitive. It maintains a dictionary of cinematic styles and injects technical directives into the prompt before execution.
Source: hashgraph-online/awesome-codex-plugins → plugins/SamurAIGPT/Generative-Media-Skills/library/motion/cinema-director/SKILL.md
1---2name: muapi-cinema-director3description: "Direct high-fidelity cinematic video with AI — translates creative intent into technical cinematographic directives for Veo3, Kling, and Luma video models via muapi.ai"4category: media-and-creative5source_repo: hashgraph-online/awesome-codex-plugins6source_path: "plugins/SamurAIGPT/Generative-Media-Skills/library/motion/cinema-director/SKILL.md"7source_url: https://github.com/hashgraph-online/awesome-codex-plugins/blob/HEAD/plugins/SamurAIGPT/Generative-Media-Skills/library/motion/cinema-director/SKILL.md8metadata:9 source: https://skillmd.com/skills/hashgraph-online/muapi-cinema-director10---111213# 🎬 AI Cinema Director Skill1415**A specialized skill for AI Agents to direct high-fidelity cinematic video.**16The Cinema Director skill translates high-level creative intent into technical cinematographic directives for state-of-the-art video models (Veo3, Kling, Luma).1718## Core Competencies19201. **Shot Composition Analysis**: Mapping emotional beats to appropriate framing (e.g., Extreme Close-Up for intimacy, Wide Shot for isolation).212. **Camera Movement Orchestration**: Directing complex physical movements (Dolly, Truck, Crane) and lens-based effects (Rack Focus, Dolly Zoom).223. **Lighting & Atmosphere Design**: Specifying temporal and stylistic lighting (Golden Hour, Chiaroscuro, Volumetric God Rays).234. **Technical Parameter Optimization**: Automatically selecting optimal frame rates, aspect ratios, and model-specific biases.2425---2627## 🏗️ Technical Specification2829### 1. Intent Mapping Table3031| Creative Intent | Framing | Movement | Lighting |32| :--- | :--- | :--- | :--- |33| **Heroic Reveal** | Low Angle / Wide | Crane Up / Orbit | Rim Lighting / High Contrast |34| **Tense/Uneasy** | Dutch Angle | Handheld Shake | Low Key / Harsh Shadows |35| **Introspective** | Close-Up | Slow Push In | Soft Rembrandt / Window Light |36| **Majestic/Epic** | Extreme Wide | Drone Flyover | Golden Hour / Volumetric |37| **Melancholic** | Profile / Medium | Slow Pull Out | Blue Hour / Desaturated |3839### 2. Physical Camera Movements40- `Dolly In/Out`: Physical camera movement on a track toward/away from the subject.41- `Truck Left/Right`: Lateral physical movement.42- `Crane/Jib`: Sweeping vertical movement from a height.43- `Orbit`: Circular movement around a center point.44- `Pedestal`: Vertical elevation change (without tilting).4546### 3. Lens & Optical Controls47- `Shallow DOF`: Background blur (Bokeh).48- `Anamorphic`: Horizontal flares and wide-screen cinematic feel.49- `Rack Focus`: Shifting focus between planes within the shot.5051---5253## 🧠 Prompt Optimization Protocol (Agent Instruction)5455**Before calling the script, the Agent MUST expand the user's raw prompt using these Director's Rules:**56571. **TECHNICAL INFUSION**: Transform "cool action" into a technical shot. 58 - *Formula*: `[Shot Type] + [Subject/Action] + [Environment] + [Lighting] + [Camera Movement] + [Lens Effect]`592. **MOTION DYNAMICS**: Use cinematic verbs: *Dolly In* (intimacy), *Crane Up* (majestic), *Orbit* (heroic), *Truck* (parallel motion).603. **LIGHTING RECIPES**: Apply specific illumination: *Volumetric God Rays*, *Teal-and-Orange Grade*, *Cyberpunk Rim Lighting*, *Rembrandt Portrait Lighting*.614. **PHYSICS LOGIC**: Describe light relationships (e.g., "Neon reflections shimmering on rain-slicked asphalt") to trigger model reasoning.6263---6465## 🚀 Protocol: Using the Cinema Director6667### Step 1: Define the Creative Brief68Provide the agent with a subject and a "Director's Intent."6970### Step 2: Invoke the Script71The `generate-film.sh` script accepts a `--brief` which it expands using its internal knowledge of cinematography.7273```bash74# Directing a scene75bash scripts/generate-film.sh 76 --subject "A lone samurai in a blizzard" 77 --intent "epic reveal" 78 --model "kling-master"79```8081### Step 3: Handle the Async Response82Video generation is asynchronous. Use the returned `request_id` to poll for completion via `core/platform/check-result.sh`.8384---8586## ⚠️ Constraints & Guardrails8788- **Temporal Consistency**: Avoid complex subject transformations in a single shot (e.g., "man turns into a bird").89- **Movement Collisions**: Do not combine contradictory movements (e.g., "Dolly In" and "Dolly Out" simultaneously).90- **Physical Realism**: Prefer movements possible with real-world equipment for a more professional "film" look.91- **Model Bias**: 92 - `Veo3`: Best for slow, high-quality aesthetic shots.93 - `Kling`: Best for complex character motion and physics.94 - `Luma`: Best for fast-paced, high-action cinematic sequences.9596---9798## ⚙️ Implementation Details99This skill acts as an "Expert Translator" for the `core/media/generate-video.sh` primitive. It maintains a dictionary of cinematic styles and injects technical directives into the prompt before execution.100101---102103**Source:** [`hashgraph-online/awesome-codex-plugins`](https://github.com/hashgraph-online/awesome-codex-plugins) → `plugins/SamurAIGPT/Generative-Media-Skills/library/motion/cinema-director/SKILL.md`