muapi-cinema-director

Original：🇺🇸 English

Translated

1 scriptsChecked / no sensitive code detected

Direct high-fidelity cinematic video with AI — translates creative intent into technical cinematographic directives for Veo3, Kling, and Luma video models via muapi.ai

2installs

Sourcesamuraigpt/generative-media-skills

Added on2026-03-06

NPX Install

npx skill4agent add samuraigpt/generative-media-skills muapi-cinema-director

SKILL.md Content

View Translation Comparison →

🎬 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.

bash

# 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.