# Cinematic Script Writer

> Writes cinematic scripts for animated and comic AI video generation, with camera angles, lighting, d

Writes cinematic scripts for animated and comic AI video generation, with camera angles, lighting, dialogue, character and voice consistency, era-accurate environment checks, AI image prompts, YouTube metadata, and saving project files to Google Drive or local storage. Use when the user wants a full video script or storyboard for an animated or comic video, needs consistent character or voice profiles across shots, wants cinematography or color grading suggestions, or asks to save script files to Google Drive.

- Page: https://ss33.ai/skills/praveenspeaks/cinematic-script-writer-60535847593
- Publisher: praveenspeaks
- Category: [Creative & Media](https://ss33.ai/skills/category/creative-and-media-0j3x01) › [Writing & content](https://ss33.ai/skills/category/creative-and-media-0j3x01/writing-and-content-wiip6z)
- License: MIT
- Source: https://github.com/praveenspeaks/cinematic-script-writer/blob/f84f7d24814ba3836a88fb2599ac53d6f5fd770d/skills/cinematic-script-writer/SKILL.md

## Skill

SKILL.md: https://ss33.ai/api/v1/ss33/download/praveenspeaks/cinematic-script-writer-60535847593

# Cinematic Script Writer

Create professional cinematic scripts for AI video generation with character consistency, comprehensive cinematography knowledge, and Google Drive storage integration.

## Description

This skill helps you create complete cinematic scripts for animated/comic videos. It includes:

- **Story Generation**: Create contexts, characters, and generate story ideas
- **Cinematic Scripts**: Full scripts with camera angles, shots, lighting, and dialogue
- **Character Consistency**: Ensures characters look the same across all shots
- **Voice Consistency**: Maintains consistent speech patterns for each character
- **Environment Consistency**: Era-appropriate architecture, clothing, and props
- **Anachronism Detection**: Prevents modern items in historical settings
- **Google Drive Storage**: Auto-saves all content to organized folders
- **YouTube Metadata**: Generates titles, descriptions, and tags

## Features

### Cinematography Database (175+ Techniques)
- 20+ Camera Angles (eye-level, low-angle, dutch-angle, bird-eye, POV)
- 20+ Camera Movements (dolly, crane, gimbal, rack-focus, snorricam)
- 25+ Shot Types (extreme-wide, close-up, insert, silhouette)
- 30+ Lighting Techniques (three-point, chiaroscuro, god-rays, neon)
- 20+ Composition Rules (rule-of-thirds, golden-ratio, leading-lines)
- 20+ Color Grading Styles (teal-orange, noir, vintage, dayglow)
- 25+ Visual Aesthetics (Pixar-3D, anime, film-noir, indian-miniature)
- 15+ Genre Cinematography Guides

### Consistency System
- Character reference sheets with visual details
- Voice profiles with pitch, vocabulary, catchphrases
- Environment style guides for era accuracy
- Prompt builder with consistency enforcement
- Anachronism validation

### Storage Integration
- Google Drive OAuth connection
- Local storage with persistent custom path (`~/.cinematic-script/config.json`)
- Organized folder structure
- Complete project export

## Usage Examples

### Basic Story Creation

```javascript
// Create a story context
const context = await skill.createContext(
  "Kutil's Adventure",
  "A cursed rakshasa's journey",
  [{
    name: "Kutil",
    description: "Cute purple rakshasa",
    personality: "Mischievous, kind",
    appearance: "Purple fur, golden eyes",
    role: "protagonist"
  }],
  "Ramayana Era",
  "Ancient India",
  "Lanka",
  "short",
  "comedy",
  "All ages",
  "Pixar 3D style"
);

// Generate story ideas
const ideas = await skill.generateStoryIdeas(context.id, 3);

// Create script
const script = await skill.createCinematicScript(
  context.id,
  ideas[0].id,
  ideas[0]
);
```

### Using Cinematography

```javascript
// Get camera techniques
const angles = skill.getAllCameraAngles();
const lighting = skill.suggestLighting('interior-day', 'comedy');
const grading = skill.suggestColorGrading('comedy');

// Get complete setup
const setup = skill.getRecommendedCameraSetup(
  'dialogue-intimate',
  'emotional',
  'intermediate'
);
```

### Character Consistency

```javascript
// Create character reference
const ref = skill.createCharacterReference(
  "char-123",
  "Kutil",
  "Purple fur, small horns, golden eyes",
  "Ramayana Era",
  "pixar-3d"
);

// Generate consistent prompts
const prompt = skill.generateCharacterConsistencyPrompt("char-123");

// Validate for anachronisms
const result = skill.validatePrompt(
  "Kutil wearing sunglasses",
  ["char-123"],
  context.id
);
// Returns error: glasses don't belong in Ramayana Era
```

### Save to Google Drive

```javascript
// Connect Google Drive
const auth = await skill.connectGoogleDrive();
// Visit auth.authUrl, authorize, paste code
await skill.connectGoogleDrive(userAuthCode);

// Save everything
const result = await skill.saveScriptToStorage(
  "Story Title",
  context.id,
  script.id
);
console.log(result.shareLink);
```

## Tools

### Context Management
- `createContext()` - Create story world
- `listContexts()` - List all contexts
- `getContext()` - Get specific context
- `deleteContext()` - Delete context

### Story Generation
- `generateStoryIdeas()` - Generate story ideas
- `createCinematicScript()` - Create full script
- `generateYouTubeMetadata()` - Generate YouTube data

### Consistency
- `createCharacterReference()` - Character visual reference
- `createVoiceProfile()` - Voice consistency profile
- `createEnvironmentStyleGuide()` - Era-appropriate guide
- `buildConsistentPrompts()` - Build consistent prompts
- `validatePrompt()` - Check for anachronisms

### Cinematography
- `getAllCameraAngles()` - All camera angles
- `getAllCameraMovements()` - All movements
- `getAllShotTypes()` - All shot types
- `getAllLightingTechniques()` - All lighting
- `suggestCameraTechnique()` - Suggest techniques
- `suggestLighting()` - Suggest lighting
- `suggestColorGrading()` - Suggest grading

### Storage
- `connectGoogleDrive()` - Connect Google Drive
- `connectLocalStorage()` - Use local storage
- `saveScriptToStorage()` - Save to storage
- `getStorageStatus()` - Check connection

## File Structure

When saved to Google Drive, creates:

```
📁 Story Title/
├── 00_INDEX.md                    # Navigation
├── 01_SCRIPT_README.md            # Human-readable script
├── 02_IMAGE_PROMPTS.md            # AI generation prompts
├── 03_CHARACTER_REFERENCES.md     # Design guides
├── 04_VOICE_GUIDELINES.md         # Dialogue guides
├── 05_YOUTUBE_METADATA.md         # Upload info
└── 99_CONTEXT_INFO.md             # Background
```

## Requirements

- Node.js 18+
- OpenClaw Agent with memory permissions
- Google Drive API (optional, for storage)

## Tags

creative, video, script, cinematography, consistency, character-design, voice, storage, google-drive, youtube

## Version

1.4.3

## Author

Praveen Kumar

## License

MIT