Shot List Generator Skill

Convert screenplay scenes into structured JSON shot specifications.

30|4|Updated Jan 26, 2026
One-click install
npx skills add https://github.com/kaigani/codeywood --skill shot-list-generator-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Shot List Generator Skill
Source: https://github.com/kaigani/codeywood/tree/main/skills/production/shot-list-generator
Command: npx skills add https://github.com/kaigani/codeywood --skill shot-list-generator-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the creation of detailed, machine-readable shot specifications from screenplay scenes, streamlining the process of preparing for automated image and video generation.

Core Features & Use Cases

  • Scene-to-Shot Conversion: Parses screenplay text to identify scenes, characters, actions, and dialogue.
  • Automated Coverage: Applies standard coverage patterns (establishing, medium, close-up, etc.) to ensure scenes are fully captured.
  • Reference Mapping: Links specific character and location references to each shot for visual consistency.
  • Shot Specification Generation: Outputs a structured JSON file detailing each shot's content, visual elements, camera work, and composition.
  • Use Case: After writing a screenplay, use this Skill to automatically generate a comprehensive shot list that can be directly fed into an image generation tool to create visual assets for each shot.

Quick Start

Use the shot list generator skill to convert the screenplay in SCRIPT_EP01.md into a shot list JSON file.

Frequently Asked Questions about Shot List Generator Skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert a screenplay into a structured shot list for video production?

You can convert a screenplay into a structured shot list by parsing scene text to identify characters and actions, applying automated coverage patterns, and outputting machine-readable JSON specifications for each shot.

Can I automate coverage patterns like establishing shots and close-ups from a script?

Yes, standard coverage patterns like establishing shots, close-ups, and medium shots can be automatically applied to parsed screenplay scenes to ensure the entire scene is fully captured.

How does reference mapping work for consistent visual asset generation?

Reference mapping ensures consistent visual asset generation by linking specific character and location references directly to each shot specification within the generated JSON output.

What is the best way to generate a JSON file of shot specifications from a screenplay?

The best way to generate a JSON file of shot specifications is to use an automated pre-production workflow that parses screenplay text and maps visual references to create detailed shot breakdowns.

Do I need a specific screenplay file format to generate a shot list?

You need a screenplay file like a markdown document to parse scenes, actions, and dialogue, which is then converted into a structured JSON shot list for visual asset generation.

Can I feed the generated shot list directly into an image generation tool?

Yes, the structured JSON shot list detailing content, visual elements, camera work, and composition can be directly fed into an image generation tool to create visual assets.