muapi-cinema-director

name muapi-cinema-director version 0.1.0 description Direct high-fidelity cinematic video with AI — translates creative intent into technical cinematographic directives for Veo3, Kling, and Luma video models via muapi.ai 🎬 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.