# Send Cinematic Script Writer to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "cinematic-script-writer",
    "name": "Cinematic Script Writer",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/praveenspeaks/cinematic-script-writer",
    "canonicalUrl": "https://clawhub.ai/praveenspeaks/cinematic-script-writer",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/cinematic-script-writer",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=cinematic-script-writer",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      ".eslintrc.json",
      "CHANGELOG.md",
      "CONTRIBUTING.md",
      "README.md",
      "SETUP-GUIDE.md",
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "cinematic-script-writer",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-29T08:53:51.796Z",
      "expiresAt": "2026-05-06T08:53:51.796Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=cinematic-script-writer",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=cinematic-script-writer",
        "contentDisposition": "attachment; filename=\"cinematic-script-writer-1.4.6.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "cinematic-script-writer"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/cinematic-script-writer"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/cinematic-script-writer",
    "downloadUrl": "https://openagent3.xyz/downloads/cinematic-script-writer",
    "agentUrl": "https://openagent3.xyz/skills/cinematic-script-writer/agent",
    "manifestUrl": "https://openagent3.xyz/skills/cinematic-script-writer/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/cinematic-script-writer/agent.md"
  }
}
```
## Documentation

### Cinematic Script Writer

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

### Installation

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

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

### Context Management

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

# 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:

# 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:

# 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
cinematic-script suggest-camera --scene-type "dialogue" --mood "dramatic"

# Get lighting suggestions
cinematic-script suggest-lighting --scene-type "interior" --mood "mysterious"

# Get color grading suggestions
cinematic-script suggest-grading --genre "action"

# Search cinematography database
cinematic-script search --query "low angle lighting"

### Character Consistency

Create character references and validate prompts:

# Create a character reference sheet
cinematic-script create-character-ref --character-id "char1" --name "Kutil" --visual "Purple rakshasa with golden eyes" --era "Ancient" --style "Pixar 3D"

# Create a voice profile for dialogue consistency
cinematic-script create-voice --character-id "char1" --name "Kutil" --personality "Mischievous, witty" --age "adult" --role "protagonist"

# Validate a prompt for anachronisms
cinematic-script validate-prompt --prompt "Your prompt here" --character-ids "char1,char2" --context-id <context-id>

### Storage

Save projects to Google Drive or local storage:

# Connect to Google Drive
cinematic-script connect-drive

# Connect to local storage
cinematic-script connect-local

# Check storage connection status
cinematic-script storage-status

# Save project to storage
cinematic-script save --title "My Story" --context-id <context-id> --script-id <script-id>

Storage implementation details:

Google Drive: Uses Google OAuth2 for authentication. Credentials are stored securely in memory.
Local Storage: Saves to the user's downloads folder as fallback.
Library: Uses googleapis for Google Drive integration.

### Export

Export scripts in various formats:

# Export as Markdown (default)
cinematic-script export --script-id <script-id> --format markdown

# Export as JSON
cinematic-script export --script-id <script-id> --format json

# Export as plain text
cinematic-script export --script-id <script-id> --format text

### Features

Story Context Management: Create and manage story settings, characters, and eras
Story Idea Generation: Generate multiple story concepts with hooks and twists
Cinematic Script Writing: Full scripts with camera angles, lighting, and shot types
Character Consistency: Reference sheets and voice profiles for consistent characters
Environment Consistency: Era-appropriate style guides and anachronism detection
YouTube Metadata: Generate titles, descriptions, and SEO tags
Storage Integration: Save to Google Drive or local storage
Export Options: JSON, Markdown, or plain text formats

### When to Use

Writing cinematic scripts or screenplays
Creating stories with characters for animation/video
Generating image/video prompts for AI tools (Midjourney, Sora, Veo, Runway)
Getting cinematography guidance (camera angles, lighting, color grading)
Maintaining character consistency across scenes
Saving script projects to Google Drive

### Camera Angles

AngleEmotional ImpactBest ForEye-levelConnection, equality, neutralityDialogue, emotional momentsLow-anglePower, dominance, heroismVillain reveals, hero momentsHigh-angleVulnerability, weakness, overviewDefeat, establishing scaleBird-eyeInsignificance, detachment, patternsEpic scale, isolationWorm-eyeAwe, grandeur, overwhelming presenceMonuments, giants, deitiesDutch angleUnease, disorientation, tensionChaos, dreams, horrorOverheadOmniscience, surveillanceTable scenes, fight choreographyShoulder-levelIntimate, casual, documentary feelWalking conversationsHip-levelCowboy feel, casual tensionWesterns, standoffsKnee-levelChildlike perspective, groundingChildren's stories, humility

### Camera Movements

MovementEffectUse ForStaticStability, observationContemplation, portraitsPanRevealing spaceFollowing action horizontallyTiltRevealing heightFollowing vertical actionDollyImmersion, intimacyMoving toward/away from subjectTruckFollowing actionSide-to-side parallel movementCraneEpic scale, dramaSweeping reveals, transitionsHandheldUrgency, realismDocumentary, action, chaosSteadicamSmooth floatingFollowing through space, dreamsZoomSudden focus, surpriseDramatic emphasis, comedyRack-focusRevealing connectionsShifting attention between subjects

### Shot Types

ShotFramingEmotional ImpactEstablishingWide locationSets scene, geography, timeWide/FullSubject + surroundingsContext, environment, scaleMediumWaist upDialogue, body languageClose-upHead/shouldersEmotion, reaction, intimacyExtreme close-upDetail only (eyes, hands)Intense emotion, symbolismOver-shoulderPast one subject to anotherConversation, perspectivePOVCharacter's viewImmersion, subjectivityInsertObject detailPlot info, symbolismTwo-shotTwo subjects togetherRelationship, tension

### Lighting Techniques

TechniqueMoodBest ForThree-pointProfessional, balancedDialogue, interviewsHigh-keyHappy, optimistic, brightComedy, commercialsLow-keyDramatic, mysteriousDrama, horror, noirGolden-hourRomantic, nostalgic, magicalRomance, emotional momentsBlue-hourMelancholic, mysteriousUrban, cityscapesChiaroscuroDramatic contrastArt films, period piecesRim/backlightSeparation, etherealSilhouettes, divine presencePracticalRealistic, naturalCandles, fires, lampsGod-raysDivine, revelationSpiritual moments, forestsNeonUrban, futuristicCyberpunk, nightlife

### Color Grading

StyleLookGenreTeal-orangeBlockbuster cinematicAction, sci-fiNoirHigh-contrast desaturatedCrime, mysteryVintage/sepiaWarm, nostalgicPeriod pieces, memoryPastelSoft, dreamyRomance, coming-of-ageBleach bypassDesaturated, grittyWar, thrillerCross-processSurreal colorsMusic videos, dreams

### Image Prompt Format

When generating image prompts for AI tools:

[Shot type] [camera angle] of [subject doing action], [visual style] style,
[lighting technique], [composition rule], [color grading],
[era-appropriate details], [mood keywords], highly detailed, cinematic

Example:

Low-angle close-up of Kutil the purple rakshasa with mischievous golden eyes,
Pixar 3D style, dramatic underlighting with rim light, rule-of-thirds composition,
warm golden color grading, ancient Lanka palace background with ornate pillars,
playful yet mysterious mood, highly detailed, cinematic, 8k

### Output Structure

When saving a project, the following files are generated:

Story Title/
├── 00_INDEX.md           # Navigation
├── 01_SCRIPT_README.md   # Human-readable script
├── 02_IMAGE_PROMPTS.md   # All AI generation prompts
├── 03_CHARACTER_REFS.md  # Character design guides
├── 04_VOICE_GUIDES.md    # Dialogue consistency guides
├── 05_YOUTUBE_META.md    # Title, description, tags
└── 99_CONTEXT_INFO.md    # Story context and background

### Important Rules

Always maintain character consistency - include character's full visual description in every image prompt
Never include anachronisms - validate props, clothing, objects against the era
Match cinematography to emotion - use low angles for power, high angles for vulnerability
Include both image and video prompts - image prompts are static, video prompts describe motion
Production-ready output - every script should include enough detail for a team to produce it
Respect the tone - comedy needs comedic timing; drama needs longer holds on reactions

### License

MIT

### Author

Praveen Kumar
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: praveenspeaks
- Version: 1.4.6
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-29T08:53:51.796Z
- Expires at: 2026-05-06T08:53:51.796Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/cinematic-script-writer)
- [Send to Agent page](https://openagent3.xyz/skills/cinematic-script-writer/agent)
- [JSON manifest](https://openagent3.xyz/skills/cinematic-script-writer/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/cinematic-script-writer/agent.md)
- [Download page](https://openagent3.xyz/downloads/cinematic-script-writer)