cinematic-script-writer

The saved excerpt is a snapshot from when this skill was listed. The external source remains the complete and most current version.

# 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