Muapi Cinema Director
Turn a one-line creative brief into model-ready cinematography prompts (framing, movement, lighting, lens) for Veo3 or Kling clips.
Overview
MuAPI Cinema Director is an agent skill for the Build phase that translates high-level cinematic intent into technical shot directives and shell-ready flags for Veo3 or Kling generation.
Install
npx skills add https://github.com/samuraigpt/generative-media-skills --skill muapi-cinema-directorWhat is this skill?
- Intent modes: reveal, tense, and epic with distinct framing, movement, lighting, and lens recipes
- CLI wrapper generate-film.sh with --subject, --model (veo3|kling), aspect, duration, audio, and preview flags
- Maps high-level creative intent into technical cinematographic directives
- Default 16:9 cinematic aspect with 5s or 10s duration options
- Optional --no-audio and --view for iteration loops
- 3 intent presets in the director logic table (reveal, tense, epic)
- 2 video models supported via --model (veo3, kling)
Adoption & trust: 721 installs on skills.sh; 3.5k GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
You have a vague video idea but your model prompts lack framing, camera movement, and lighting, so generations look generic.
Who is it for?
Solo creators shipping landing pages, ads, or demo reels who want consistent cinematic language without hiring a DP.
Skip if: Teams needing full storyboards, shot lists across scenes, or legal clearance workflows—this skill only maps intent to single-clip directives.
When should I use this skill?
You need AI-generated film clips from a subject description with cinematic intent, model choice, duration, and optional audio control.
What do I get? / Deliverables
You get intent-specific cinematography parameters and a generate-film.sh invocation tuned for model, duration, aspect, and audio options.
- Parameterized generate-film.sh command
- Shot grammar (framing, movement, lighting, lens) for the chosen intent
Recommended Skills
Journey fit
Build is where solo builders produce marketing and product visuals; this skill generates directed video specs rather than distributing or optimizing them. Frontend/content surface covers hero videos, launch teasers, and UI-adjacent motion assets that need deliberate shot language.
How it compares
A prompt director layer for generative video—use instead of pasting generic “cinematic 4k” strings with no shot grammar.
Common Questions / FAQ
Who is muapi-cinema-director for?
Indie builders and marketers using Veo3 or Kling who want reusable cinematography recipes from short creative briefs.
When should I use muapi-cinema-director?
During Build when drafting hero videos, product reveals, or mood clips before Launch distribution—especially when iterating intent modes reveal, tense, or epic.
Is muapi-cinema-director safe to install?
The skill is a local bash workflow; confirm any outbound API keys and billing for your video provider separately, and review the Security Audits panel on this Prism page.
SKILL.md
READMESKILL.md - Muapi Cinema Director
#!/bin/bash # Expert Skill: AI Cinema Director # Translates high-level intent into technical cinematographic directives. SUBJECT="" INTENT="cinematic" MODEL="veo3" ASPECT="16:9" DURATION=5 AUDIO_FLAG="" VIEW_FLAG="" while [[ $# -gt 0 ]]; do case $1 in --subject) SUBJECT="$2"; shift 2 ;; --intent) INTENT="$2"; shift 2 ;; --model) MODEL="$2"; shift 2 ;; --aspect) ASPECT="$2"; shift 2 ;; --duration) DURATION="$2"; shift 2 ;; --no-audio) AUDIO_FLAG="--no-audio"; shift ;; --view) VIEW_FLAG="--view"; shift ;; *) shift ;; esac done if [ -z "$SUBJECT" ]; then echo "Usage: bash generate-film.sh --subject 'description' [--intent reveal|tense|epic] [--model veo3|kling] [--duration 5|10] [--no-audio] [--view]" exit 1 fi # Director's Logic Table (Internal Knowledge) case $INTENT in "reveal") FRAMING="Extreme wide shot" MOVEMENT="Slow crane up and tilt down" LIGHTING="Golden hour, volumetric god rays" LENS="Deep focus, high clarity" ;; "tense") FRAMING="Dutch angle, close-up" MOVEMENT="Handheld jittery movement" LIGHTING="Low key, harsh shadows, flickering neon" LENS="Shallow depth of field, anamorphic lens flare" ;; "epic") FRAMING="Low angle wide shot" MOVEMENT="Dolly in with circular orbit" LIGHTING="Dramatic rim lighting, high contrast" LENS="Anamorphic, 35mm film grain" ;; "melancholy") FRAMING="Medium shot, profile" MOVEMENT="Slow dolly out" LIGHTING="Blue hour, soft desaturated tones" LENS="Shallow bokeh, soft focus" ;; *) FRAMING="Cinematic medium shot" MOVEMENT="Smooth pan" LIGHTING="Natural studio lighting" LENS="Standard 50mm" ;; esac # Construct the technical Director's Prompt DIRECTOR_PROMPT="[DIRECTOR_BRIEF] SCENE: $SUBJECT FRAMING: $FRAMING CAMERA_MOTION: $MOVEMENT LIGHTING_DESIGN: $LIGHTING OPTICS: $LENS [EXECUTE] High-fidelity cinematic footage. Professional color grade, 4k, hyper-realistic physics." # Call the Core primitive SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )" CORE_SCRIPT="$SCRIPT_DIR/../../../../core/media/generate-video.sh" bash "$CORE_SCRIPT" --prompt "$DIRECTOR_PROMPT" --model "$MODEL" --aspect-ratio "$ASPECT" --duration "$DURATION" $AUDIO_FLAG $VIEW_FLAG --async --json --- 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 1. **Shot Composition Analysis**: Mapping emotional beats to appropriate framing (e.g., Extreme Close-Up for intimacy, Wide Shot for isolation). 2. **Camera Movement Orchestration**: Directing complex physical movements (Dolly, Truck, Crane) and lens-based effects (Rack Focus, Dolly Zoom). 3. **Lighting & Atmosphere Design**: Specifying temporal and stylistic lighting (Golden Hour, Chiaroscuro, Volumetric God Rays). 4. **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 / Volumetri