/film-creator

name: film-creator
description: |
  AI-powered film creation assistant that transforms a single sentence or image into a complete 30-second film.
  Automatically generates screenplay with scenes, dialogue, and camera directions, then produces cinematic video.
  Use when user wants to create a movie, film, or video story from text or image input.
  Trigger phrases: '创作电影', '生成电影', 'film creator', 'make a movie', 'create a film'.
allowed-tools: Bash, Read, Write, Edit
version: 1.0.0
license: MIT

Film Creator - AI Film Production Assistant

Transform a single idea or image into a complete 30-second cinematic film with professional screenplay and video generation.

Overview

This skill provides end-to-end film creation capabilities: 1. **Creative Analysis**: Analyzes text prompt or image to extract core creative elements 2. **Screenplay Generation**: Writes professional screenplay with scenes, dialogue, shot descriptions, and camera movements 3. **Scene Planning**: Breaks screenplay into 5-6 scenes (5 seconds each) optimized for video generation 4. **Video Production**: Generates high-quality video for each scene using AI Gateway 5. **Film Assembly**: Combines scenes into a cohesive 30-second film with transitions

Prerequisites

**Required Environment Variable:**

• `AI_GATEWAY_API_KEY`: Your AI Gateway API key (automatically configured in HappyCapy)

**Required Tools:**

• Node.js 24+ (pre-installed in HappyCapy)
• FFmpeg (pre-installed in HappyCapy)

Quick Start

Create a Film from Text

node scripts/create_film.js "A lonely robot discovers the last flower on Earth"

Create a Film from Image

node scripts/create_film.js --image "/path/to/image.jpg" "Transform this into a cinematic story"

Create a Film with Custom Settings

node scripts/create_film.js \
  "A time traveler's final journey" \
  --model "openai/sora-2" \
  --aspect-ratio "16:9" \
  --output "my_film.mp4"

Features

Screenplay Generation

• **Story Structure**: Three-act structure adapted for 30-second format
• **Scene Breakdown**: 5-6 distinct scenes with clear transitions
• **Visual Descriptions**: Detailed shot compositions and camera movements
• **Cinematic Language**: Professional terminology (establishing shot, close-up, tracking shot, etc.)
• **Emotional Arc**: Clear beginning, middle, and end with emotional progression

Video Generation

• **Multi-Scene Production**: Generates 5-6 individual scenes
• **Cinematic Quality**: Uses professional video generation models
• **Smart Prompting**: Converts screenplay into optimized video generation prompts
• **Continuity**: Maintains visual consistency across scenes

Film Assembly

• **Scene Stitching**: Seamlessly combines individual scenes
• **Transitions**: Smooth cuts or fade transitions between scenes
• **Duration Control**: Precisely timed to 30 seconds total
• **Quality Preservation**: No re-encoding loss

Supported Models

Recommended for Film Creation

| Model | Best For | Duration per Scene | |-------|----------|-------------------| | `google/veo-3.1-generate-preview` | Balanced quality and reliability (Recommended) | 5-6 seconds | | `openai/sora-2` | Cinematic quality with complex scenes | 4-6 seconds | | `openai/sora-2-pro` | Professional-grade cinematic output | 4-6 seconds | | `byteplus/seedance-1-0-pro` | Flexible aspect ratios | 5-6 seconds |

Usage Examples

Basic Film Creation

# From a simple concept
node scripts/create_film.js "A cat astronaut explores a distant planet"

# With specific genre
node scripts/create_film.js "A noir detective story set in the rain"

# From an uploaded image
node scripts/create_film.js --image "concept_art.jpg" "Make this into an epic adventure"

Advanced Options

# Use premium model for highest quality
node scripts/create_film.js \
  "An emotional reunion at a train station" \
  --model "openai/sora-2-pro" \
  --output "reunion.mp4"

# Create vertical video for mobile
node scripts/create_film.js \
  "A day in the life of a street performer" \
  --aspect-ratio "9:16" \
  --model "byteplus/seedance-1-0-pro"

# Generate only the screenplay
node scripts/generate_screenplay.js "A magical library where books come alive"

Workflow

Step 1: Creative Analysis

The system analyzes your input (text or image) to identify:

• Core concept and theme
• Emotional tone
• Visual style
• Key story elements

Step 2: Screenplay Writing

Generates a professional screenplay including:

• **Scene Headings**: INT./EXT. location and time
• **Action Lines**: Visual descriptions of what happens
• **Camera Directions**: Shot types and movements
• **Timing**: Duration for each scene

Example screenplay output:

FADE IN:

EXT. ABANDONED CITY - DAY

WIDE ESTABLISHING SHOT: A desolate cityscape covered in rust and vines.
The sun casts long shadows through broken buildings.

A small ROBOT (weathered, curious) rolls through debris, its single eye
scanning the ground.

CLOSE-UP: The robot's sensors light up as it detects something.

LOW ANGLE: The robot stops at a crack in the concrete where a single
FLOWER blooms in brilliant red.

EXTREME CLOSE-UP: The robot's optical lens focuses on the flower,
reflecting its petals.

The robot extends a gentle mechanical hand, not to touch, but to protect.

FADE OUT.

Step 3: Scene-by-Scene Generation

Each scene is converted to an optimized video prompt:

• Camera angles and movements specified
• Visual details enhanced
• Lighting and mood emphasized
• Continuity elements maintained

Step 4: Video Assembly

All scenes are combined with:

• Frame-accurate stitching
• Optional transitions (cut/fade)
• Audio-ready format (MP4)
• Optimized compression

Command Reference

create_film.js (Main Script)

**Parameters:**

• `prompt` (required): Text description or story concept
• `--image PATH` (optional): Image file to use as creative inspiration
• `--model MODEL` (optional): Video generation m