Video Script Generator

---

name: Video Script Generator description: How to generate video scripts for the Video Generator from user prompts. version: 5.0.0

---

Video Script Generation Skill

This skill provides instructions on how to transform a user's storytelling prompt into a valid input-scripts.json entry for the video generator.

1. JSON Structure

Every script must be an object within the main array in input/input-scripts.json.

{
  "id": "unique-id",
  "title": "Display Title",
  "orientation": "landscape" | "portrait",
  "voice": "en-US-JennyNeural" | "en-US-GuyNeural",
  "script": "The actual narrative content..."
}

2. Director Mode (Manual Visual Cues)

To ensure high-quality, relevant stock footage, use "Director Mode" tags. Place them at the start of the sentence or block they describe.

Syntax: [Visual: Descriptive Query]

Best Practice: Be specific. Instead of [Visual: nature], use [Visual: green forest sunlight rays].

Placement: The visual will stay active until the next [Visual: ] tag appears.

Example: > "[Visual: futuristic city neon night] The city never sleeps. [Visual: robotic arm assembly] High-tech manufacturing is the backbone of the economy."

3. Audio & Voice Settings

You can choose from several high-quality neural voices. Specify these in the voice field of your JSON job.

#### Available Voices

| Gender | Voice ID | Style/Region | | :--- | :--- | :--- | | 👨 Male | en-US-GuyNeural | Deep, Authoritative (Recommended) | | 👨 Male | en-US-ChristopherNeural | Calm, Steady | | 👨 Male | en-GB-RyanNeural | British Accent | | 👨 Male | en-IN-PrabhatNeural | Indian Accent | | 👩 Female | en-US-JennyNeural | Warm, Professional (Recommended) | | 👩 Female | en-US-AriaNeural | Friendly, Helpful | | 👩 Female | en-US-SaraNeural | Cheerful, Bright | | 👩 Female | en-GB-SoniaNeural | British Accent |

4. Job Settings Keys

| Key | Type | Description | | :--- | :--- | :--- | | id | String | Unique slug for the video (used for the folder name). | | title | String | The main title displayed in the video. | | orientation | String | landscape (16:9) or portrait (9:16). | | voice | String | Use one of the Voice IDs from the table above. | | showText | Boolean | (Optional) Set to false to hide captions. | | defaultVideo | String | (Optional) Local filename for fallback (in input-assests/). | | script | String | The content to be spoken, including [Visual: ...] tags. |

5. Script Writing Rules

1. Scene Breaks: Aim for scene changes every 5-10 seconds. Longer scenes can get repetitive. 2. Voiceovers: The script text is exactly what will be spoken. Do NOT include instructions like (Scene 1) in the script text, as the TTS will read it. 3. Troubleshooting Visuals: If a search is too specific and returns 0 results, the system will automatically try fallbacks (Pixabay -> Generic). * Tip: Use keywords that describe the *action* or *vibe* (e.g., "morning sunrise", "fast car driving").