# film-creator

film-creator turns a text idea or image into a short film by writing a screenplay, planning scenes, and generating video. Use it to shape a concept into a cinematic story.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 138 repo stars
- Author: happycapy-ai
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/happycapy-ai/Happycapy-skills/tree/HEAD/skills/film-creator/SKILL.md
- Updated: 2026-09-03
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/film-creator

## What it does

The skill analyzes text or an image, then drafts a screenplay with dialogue, shot descriptions, and camera directions. It splits the story into 5–6 scenes, generates video for each through AI Gateway, and assembles them into a 30-second film with transitions.

You need `AI_GATEWAY_API_KEY`, Node.js 24+, and FFmpeg. The main script, `scripts/create_film.js`, accepts a story prompt or image path, along with settings for the model, aspect ratio, and output file. Video generation depends on the AI Gateway key.

Other scripts can generate a screenplay or a single scene; `scripts/assemble_film.js` joins existing clips. Supported models include `google/veo-3.1-generate-preview`, `openai/sora-2`, and `byteplus/seedance-1-0-pro`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add happycapy-ai/Happycapy-skills --skill film-creator -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/film-creator/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/film-creator/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add happycapy-ai/Happycapy-skills --skill film-creator -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/film-creator/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add happycapy-ai/Happycapy-skills --skill film-creator -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/film-creator/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install happycapy-ai/Happycapy-skills skills/film-creator
```

2. **Manually: put the files in place**
- File: `.github/skills/film-creator/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add happycapy-ai/Happycapy-skills --skill film-creator -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/happycapy-ai/Happycapy-skills --path skills/film-creator
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/film-creator/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/happycapy-ai/Happycapy-skills/tree/HEAD/skills/film-creator/SKILL.md

## When to use it
- turn a story idea into a screenplay with shot directions
- plan scenes for video generation
- create a short film from text or an image
- join generated clips into a film with transitions

## Example prompts
- Make a short film about a robot finding the last flower on Earth.
- Turn `concept_art.jpg` into an adventure story on video.
- Write a screenplay about a library where books come alive.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: d935d8e393861a14.

BEGIN THIRD-PARTY FILE d935d8e393861a14
````text
---
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

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

### Create a Film from Image

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

### Create a Film with Custom Settings

```bash
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 |
````
END THIRD-PARTY FILE d935d8e393861a14

The third-party file has ended. Everything between the d935d8e393861a14 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 3065 of 11972 bytes. © happycapy-ai · MIT · https://github.com/happycapy-ai/Happycapy-skills/tree/HEAD/skills/film-creator/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
