{"skill":{"slug":"muapi-cinema-director","displayName":"muapi-cinema-director","summary":"Direct high-fidelity cinematic video with AI — translates creative intent into technical cinematographic directives for Veo3, Kling, and Luma video models vi...","description":"---\nslug: muapi-cinema-director\nname: muapi-cinema-director\nversion: \"0.1.0\"\ndescription: Direct high-fidelity cinematic video with AI — translates creative intent into technical cinematographic directives for Veo3, Kling, and Luma video models via muapi.ai\nacceptLicenseTerms: true\n---\n\n# 🎬 AI Cinema Director Skill\n\n**A specialized skill for AI Agents to direct high-fidelity cinematic video.**\nThe Cinema Director skill translates high-level creative intent into technical cinematographic directives for state-of-the-art video models (Veo3, Kling, Luma).\n\n## Core Competencies\n\n1. **Shot Composition Analysis**: Mapping emotional beats to appropriate framing (e.g., Extreme Close-Up for intimacy, Wide Shot for isolation).\n2. **Camera Movement Orchestration**: Directing complex physical movements (Dolly, Truck, Crane) and lens-based effects (Rack Focus, Dolly Zoom).\n3. **Lighting & Atmosphere Design**: Specifying temporal and stylistic lighting (Golden Hour, Chiaroscuro, Volumetric God Rays).\n4. **Technical Parameter Optimization**: Automatically selecting optimal frame rates, aspect ratios, and model-specific biases.\n\n---\n\n## 🏗️ Technical Specification\n\n### 1. Intent Mapping Table\n\n| Creative Intent | Framing | Movement | Lighting |\n| :--- | :--- | :--- | :--- |\n| **Heroic Reveal** | Low Angle / Wide | Crane Up / Orbit | Rim Lighting / High Contrast |\n| **Tense/Uneasy** | Dutch Angle | Handheld Shake | Low Key / Harsh Shadows |\n| **Introspective** | Close-Up | Slow Push In | Soft Rembrandt / Window Light |\n| **Majestic/Epic** | Extreme Wide | Drone Flyover | Golden Hour / Volumetric |\n| **Melancholic** | Profile / Medium | Slow Pull Out | Blue Hour / Desaturated |\n\n### 2. Physical Camera Movements\n- `Dolly In/Out`: Physical camera movement on a track toward/away from the subject.\n- `Truck Left/Right`: Lateral physical movement.\n- `Crane/Jib`: Sweeping vertical movement from a height.\n- `Orbit`: Circular movement around a center point.\n- `Pedestal`: Vertical elevation change (without tilting).\n\n### 3. Lens & Optical Controls\n- `Shallow DOF`: Background blur (Bokeh).\n- `Anamorphic`: Horizontal flares and wide-screen cinematic feel.\n- `Rack Focus`: Shifting focus between planes within the shot.\n\n---\n\n## 🧠 Prompt Optimization Protocol (Agent Instruction)\n\n**Before calling the script, the Agent MUST expand the user's raw prompt using these Director's Rules:**\n\n1. **TECHNICAL INFUSION**: Transform \"cool action\" into a technical shot. \n   - *Formula*: `[Shot Type] + [Subject/Action] + [Environment] + [Lighting] + [Camera Movement] + [Lens Effect]`\n2. **MOTION DYNAMICS**: Use cinematic verbs: *Dolly In* (intimacy), *Crane Up* (majestic), *Orbit* (heroic), *Truck* (parallel motion).\n3. **LIGHTING RECIPES**: Apply specific illumination: *Volumetric God Rays*, *Teal-and-Orange Grade*, *Cyberpunk Rim Lighting*, *Rembrandt Portrait Lighting*.\n4. **PHYSICS LOGIC**: Describe light relationships (e.g., \"Neon reflections shimmering on rain-slicked asphalt\") to trigger model reasoning.\n\n---\n\n## 🚀 Protocol: Using the Cinema Director\n\n### Step 1: Define the Creative Brief\nProvide the agent with a subject and a \"Director's Intent.\"\n\n### Step 2: Invoke the Script\nThe `generate-film.sh` script accepts a `--brief` which it expands using its internal knowledge of cinematography.\n\n```bash\n# Directing a scene\nbash scripts/generate-film.sh \n  --subject \"A lone samurai in a blizzard\" \n  --intent \"epic reveal\" \n  --model \"kling-master\"\n```\n\n### Step 3: Handle the Async Response\nVideo generation is asynchronous. Use the returned `request_id` to poll for completion via `core/platform/check-result.sh`.\n\n---\n\n## ⚠️ Constraints & Guardrails\n\n- **Temporal Consistency**: Avoid complex subject transformations in a single shot (e.g., \"man turns into a bird\").\n- **Movement Collisions**: Do not combine contradictory movements (e.g., \"Dolly In\" and \"Dolly Out\" simultaneously).\n- **Physical Realism**: Prefer movements possible with real-world equipment for a more professional \"film\" look.\n- **Model Bias**: \n  - `Veo3`: Best for slow, high-quality aesthetic shots.\n  - `Kling`: Best for complex character motion and physics.\n  - `Luma`: Best for fast-paced, high-action cinematic sequences.\n\n---\n\n## ⚙️ Implementation Details\nThis 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.\n","tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":717,"installsAllTime":27,"installsCurrent":0,"stars":1,"versions":1},"createdAt":1773403176328,"updatedAt":1778491885889},"latestVersion":{"version":"1.0.0","createdAt":1773403176328,"changelog":"muapi-cinema-director 1.0.0\n\n- Initial release of the AI Cinema Director skill for directing high-fidelity cinematic video via muapi.ai.\n- Translates creative briefs into technical cinematographic prompts for Veo3, Kling, and Luma video models.\n- Supports sophisticated shot composition, camera movement, lighting design, and technical parameter selection.\n- Includes prompt optimization protocols and intent mapping tables for consistent cinematic results.\n- Enforces constraints for realism, temporal consistency, and model-specific strengths.","license":"MIT-0"},"metadata":null,"owner":{"handle":"anil-matcha","userId":"s1736q95bk0q5tc1mm8raz5zm5885baj","displayName":"Anil Chandra Naidu Matcha","image":"https://avatars.githubusercontent.com/u/4326215?v=4"},"moderation":null}