SKILL.md
$27
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.