codex-storyboard-video-production

这段内容是审核时保存的快照。外部来源才是完整且最新的版本。

---
name: codex-storyboard-video-production
description: Create and manage AI video storyboard projects with automated asset generation through Codex Storyboard workspace
triggers:
  - create a video storyboard project
  - generate video assets for storyboard
  - open the storyboard workspace
  - manage storyboard shots and scenes
  - add visual design guidelines to video project
  - process storyboard generation queue
  - create short video script with shots
  - batch generate storyboard media assets
---

# Codex Storyboard Video Production

> Skill by [ara.so](https://ara.so) — Codex Skills collection.

## Overview

Codex Storyboard is a local-first multi-project storyboard workspace for video production. It enables you to create video projects with detailed shot breakdowns, manage scripts and visual descriptions, and automatically generate image/video assets using Image Generation, HyperFrames, or Remotion. All data is stored locally and accessed through MCP tools.

**Key capabilities:**
- Multi-project video storyboard management
- Shot-by-shot script and visual planning
- Automated asset generation and backfill
- Project-level DESIGN.md for visual consistency
- Multiple aspect ratios (9:16, 16:9, 3:4, 4:3, 1:1)
- Local media upload and preview
- Generation queue management

## Installation

### As Codex Plugin

```bash
codex plugin marketplace add Yuuhann1999/codex-storyboard
codex plugin add codex-storyboard@codex-storyboard
```

After installation, restart Codex or open a new conversation to load MCP tools.

### Standalone Development

```bash
git clone https://github.com/Yuuhann1999/codex-storyboard.git
cd codex-storyboard
npm start
```

Access at `http://127.0.0.1:43218`

## Configuration

### Data Directory

Plugin mode (default):
```
~/.codex-storyboard/
  projects.json
  projects/
    <project-id>/
      project.json
      DESIGN.md
      media/
      generation/
```

Custom data directory via environment variable:
```bash
export CODEX_STORYBOARD_DATA_DIR=/path/to/custom/data
```

Development mode uses `data/` in repository root.

### Port Configuration

Default port is `43218`. The server will auto-increment if occupied.

## Core Workflow

### 1. Open Storyboard Workspace

```text
@codex-storyboard open the Codex storyboard workspace
```

This starts the local server and returns a clickable URL like:
```
http://127.0.0.1:43218
```

### 2. Create a Video Project

**Full project creation with shots:**

```text
@codex-storyboard create a 9:16 vertical video storyboard project about "5 AI coding tips", 
suitable for TikTok, with 5-7 shots, each 3-5 seconds, fast-paced and clean style
```

The MCP tool `create_storyboard_project` supports:
- Project metadata (title, description, aspect ratio)
- Complete shot array (shot type, media type, duration, script, visual description, generation method)
- Optional DESIGN.md content for visual guidelines

**Minimal project creation:**

```text
@codex-storyboard create a new storyboard project called "Product Demo Video" in 16:9 format
```

### 3. Add or Modify Shots

**Add new shots:**

```text
@codex-storyboard add 3 more B-ROLL shots to the current project, 
each showing different code editor features with smooth transitions
```

**Modify existing shot:**

```text
@codex-storyboard update shot 3 to be 8 seconds long, 
change the visual description to "Close-up of keyboard typing with colorful syntax highlighting"
```

**Delete shot:**

```text
@codex-storyboard delete shot 5 from the current project
```

### 4. Add Visual Guidelines (DESIGN.md)

```text
@codex-storyboard add a DESIGN.md to the current project with these guidelines:
- Color palette: Dark mode (#1a1a1a background, #00ff88 accent)
- Typography: SF Pro Display, clean sans-serif
- Style: Minimalist tech aesthetic, high contrast
- Motion: Smooth 60fps, subtle zoom effects
- Composition: Rule of thirds, centered subjects
```

The DESIGN.md is stored at `projects/<project-id>/DESIGN.md` and used as context when generat