muapi-cinema-director

Q: How do I install muapi-cinema-director?

Run npx skills add https://github.com/samuraigpt/generative-media-skills --skill muapi-cinema-director in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/muapi-cinema-director/ (personal) or .claude/skills/muapi-cinema-director/ (project).

by samuraigptMedia & Creative

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

Installs: 3.1K
Last 24h: +8
Trending rank: #9384
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/samuraigpt/generative-media-skills --skill muapi-cinema-director

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads muapi-cinema-director automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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

FAQ

What does the muapi-cinema-director skill do?

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

How do I install muapi-cinema-director?

Run npx skills add https://github.com/samuraigpt/generative-media-skills --skill muapi-cinema-director in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/muapi-cinema-director/ (personal) or .claude/skills/muapi-cinema-director/ (project).

Which AI agents can use muapi-cinema-director?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is muapi-cinema-director safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains muapi-cinema-director?

It is published by samuraigpt in samuraigpt/generative-media-skills. It has 3,115 recorded installs.