# Video Generation

Generates videos from structured prompts and an optional reference image.

- Repository: https://github.com/bytedance/deer-flow (84840 stars)
- Category: Media
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add bytedance/deer-flow --skill video-generation -g -a claude-code -y`
Codex: `npx skills add bytedance/deer-flow --skill video-generation -g -a codex -y`
Cursor: `npx skills add bytedance/deer-flow --skill video-generation -g -a cursor -y`
Gemini CLI: `npx skills add bytedance/deer-flow --skill video-generation -g -a gemini-cli -y`

## Description

Use this skill when the user requests to generate, create, or imagine videos. Supports structured prompts and reference image for guided generation.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Video Generation Skill

## Overview

This skill generates high-quality videos using structured prompts and a Python script. The workflow includes creating JSON-formatted prompts and executing video generation with optional reference image.

## Core Capabilities

- Create structured JSON prompts for AIGC video generation
- Support reference image as guidance or the first/last frame of the video
- Generate videos through automated Python script execution

## Workflow

### Step 1: Understand Requirements

When a user requests video generation, identify:

- Subject/content: What should be in the image
- Style preferences: Art style, mood, color palette
- Technical specs: Aspect ratio, composition, lighting
- Reference image: Any image to guide generation
- You don't need to check the folder under `/mnt/user-data`

### Step 2: Create Structured Prompt

Generate a structured JSON file in `/mnt/user-data/workspace/` with naming pattern: `{descriptive-name}.json`

### Step 3: Create Reference Image (Optional when image-generation skill is available)

Generate reference image for the video generation.

- If only 1 image is provided, use it as the guided frame of the video

### Step 3: Execute Generation

Call the Python script:
```bash
python /mnt/skills/public/video-generation/scripts/generate.py \
  --prompt-file /mnt/user-data/workspace/prompt-file.json \
  --reference-images /path/to/ref1.jpg \
  --output-file /mnt/user-data/outputs/generated-video.mp4 \
  --aspect-ratio 16:9
```

Parameters:

The rest: https://github.com/bytedance/deer-flow/blob/HEAD/skills/public/video-generation/SKILL.md