# cinematic-script-writer

Drafts cinematic scripts and video generation prompts for tools like Sora or Midjourney while keeping character appearance and camera lighting consistent.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 842 installs · ★ 1
- Author: praveenspeaks
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/praveenspeaks/cinematic-script-writer/tree/HEAD/SKILL.md
- Updated: 2026-02-10
- HTML: https://affpapa.org/en/nevibecode/skills/cinematic-script-writer

## What it does

This skill generates production-ready scripts and visual prompts for AI video platforms such as Sora, Veo, and Midjourney. It includes a cinematography reference covering shot types, camera angles from Dutch tilt to bird's-eye view, movement styles, and genre-specific color grading presets. Characters get dedicated reference sheets and voice profiles, preventing AI models from morphing facial features across scenes.

It checks prompts for anachronisms against specific historical settings, creates YouTube SEO metadata, and exports files to Markdown, JSON, or plain text. The tool operates through the `cinematic-script` CLI command, which requires Node.js installed on your machine.

Project files save directly to Google Drive via `googleapis` with OAuth2 authentication, using the local downloads folder as a fallback. Without completing the Google Drive sign-in, files will write strictly to local storage.

## Requirements
- Works with: Google Drive

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add praveenspeaks/cinematic-script-writer --skill cinematic-script-writer -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add praveenspeaks/cinematic-script-writer --skill cinematic-script-writer -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add praveenspeaks/cinematic-script-writer --skill cinematic-script-writer -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install praveenspeaks/cinematic-script-writer cinematic-script-writer
```

2. **Manually: put the files in place**
- File: `.github/skills/cinematic-script-writer/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add praveenspeaks/cinematic-script-writer --skill cinematic-script-writer -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/praveenspeaks/cinematic-script-writer
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add praveenspeaks/cinematic-script-writer --skill cinematic-script-writer -a opencode
```

### 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/praveenspeaks/cinematic-script-writer/tree/HEAD/SKILL.md

## When to use it
- generate scene prompts with camera angles and lighting setups for AI video
- track character visual traits and voice profiles across multiple scenes
- detect historical anachronisms in video generation prompts
- produce SEO titles, descriptions, and tags for YouTube uploads
- export completed scripts to Markdown, JSON, or plain text

## Example prompts
- Create a story context set in Ancient India and generate three plot ideas
- Suggest a camera angle and lighting setup for an interior dramatic dialogue
- Validate this Midjourney prompt for era accuracy against character ref char1

## 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: 9498a6b7ce068106.

BEGIN THIRD-PARTY FILE 9498a6b7ce068106
````text
---
name: cinematic-script-writer
version: 1.4.0
description: "Create professional cinematic scripts for AI video generation with character consistency and cinematography knowledge. Use when the user wants to write a cinematic script, create story contexts with characters, generate image prompts for AI video tools (Midjourney, Sora, Veo), or needs cinematography guidance (camera angles, lighting, color grading). Also use for character consistency sheets, voice profiles, anachronism detection, and saving scripts to Google Drive."
metadata:
  openclaw:
    emoji: "🎬"
    requires:
      bins:
        - node
    install:
      - id: npm-install
        kind: npm
        package: "cinematic-script-writer"
        bins:
          - cinematic-script
tags:
  - creative
  - video
  - script
  - cinematography
  - youtube
  - camera
  - lighting
  - consistency
  - character-design
  - voice
  - era-accurate
  - storage
  - google-drive
---

# Cinematic Script Writer

Create professional cinematic scripts for AI video generation with character consistency and cinematography knowledge.

## Installation

```bash
# Install via npm
npm install -g cinematic-script-writer

# Or install via OpenClaw CLI
openclaw skills install cinematic-script-writer
```

## CLI Usage

### Context Management

Create and manage story contexts with characters, era, and settings:

```bash
# Create a new story context
cinematic-script create-context --name "My Story" --era "Ancient India" --period "Ramayana Era"

# List all saved contexts
cinematic-script list-contexts

# Get a specific context
cinematic-script get-context --id <context-id>

# Delete a context
cinematic-script delete-context --id <context-id>
```

### Story Generation

Generate story ideas and create cinematic scripts:

```bash
# Generate story ideas for a context
cinematic-script generate-ideas --context-id <context-id> --count 3

# Create a full cinematic script from an idea
cinematic-script create-script --context-id <context-id> --idea-id <idea-id>

# Generate YouTube metadata for a script
cinematic-script generate-metadata --script-id <script-id>
```

### Cinematography Reference

Access camera angles, lighting, and shot type databases:

```bash
# List all camera angles
cinematic-script list-angles

# List all camera movements
cinematic-script list-movements

# List all shot types
cinematic-script list-shots

# Get camera setup recommendation
````
END THIRD-PARTY FILE 9498a6b7ce068106

The third-party file has ended. Everything between the 9498a6b7ce068106 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 2423 of 10531 bytes. © praveenspeaks · MIT · https://github.com/praveenspeaks/cinematic-script-writer/tree/HEAD/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
