gitwtfhub

wtf is script-to-shootable-storyboard?

zyz254009-crypto/script-to-shootable-storyboard — explained in plain English

Analysis updated 2026-05-18

106JavaScriptAudience · writerComplexity · 2/5LicenseSetup · moderate

TL;DR

A Codex skill that turns a screenplay or story outline into shootable, atomic shots with continuity tracking, ready for live action filming or AI video generation like Seedance.

Mindmap

Mindmap is still cooking. Refresh in a few.

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Convert a finished screenplay into a detailed shot-by-shot storyboard ready for filming.

REASON 2

Fix an existing storyboard by making each shot atomic, continuity-consistent, and truly shootable.

REASON 3

Turn a character's internal thoughts or a vague mood description into concrete visual and audio cues a camera can capture.

REASON 4

Break shots into individual Seedance generation tasks with acceptance criteria and a fallback plan if a generation attempt fails.

What's in the stack?

JavaScriptNode.jsCodexJSON Schema

How it stacks up

zyz254009-crypto/script-to-shootable-storyboardfinderchangchang/codex-autoskindb-toolkit/db-toolkit
Stars106107104
LanguageJavaScriptJavaScriptJavaScript
Setup difficultymoderateeasyeasy
Complexity2/52/52/5
Audiencewritervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Runs best inside Codex, requires Git and Node.js 18+ but no npm dependencies to install.

You can use, modify, and share this freely, including commercially, as long as you keep the original copyright notice.

Wtf does this do

This project is a Codex skill that converts a screenplay, story outline, dialogue draft, or existing storyboard into a set of shootable, editable shots suitable for live action filming, the Seedance AI video generator, or a mix of both. It covers a full film pre production workflow, going from locking the source material, analyzing the plot and characters, and turning internal thoughts or abstract mood into things a camera can actually show, through shot breakdown, staging, continuity tracking, sound timing, generation task compilation, risk scoring, and a final delivery check. Each shot is treated as an atomic unit with a fixed time and place, a defined framing, a main action, and a specific camera movement, and the tool checks that action, dialogue, reactions, camera movement, sound, and shot length all hold together before calling it finished. It tracks continuity details like where characters are standing, eyelines, costumes, props, and the environment across shots. For Seedance specifically, it compiles each shot into a generation task with acceptance criteria and a fallback plan if the generation fails, and it supports choosing live action, AI generated, or mixed production on a shot by shot basis, including handoff requirements between the two. The skill also includes rights and safety checks around source material, likeness, voice, privacy, and consent that are flagged for human review rather than decided automatically, plus more than 40 JSON Schemas, several validator scripts, a cost estimator, and a repair plan generator that suggests the smallest fix needed rather than silently rewriting the story. It is built as a Codex skill and works best inside Codex, installed by cloning the repository into your Codex skills folder. It only needs Git and Node.js 18 or later, with no npm dependencies to install, and includes templates for markdown and CSV storyboards, generation tasks, and quality reports. The project passed 102 regression tests and is released under the MIT License.

Yoink these prompts

Prompt 1
Use $script-to-shootable-storyboard to convert this screenplay into faithful, shootable, editable atomic shots and Seedance generation tasks.
Prompt 2
Help me fix continuity issues in my existing storyboard using this Codex skill's atomic shot rules.
Prompt 3
Walk me through running the validate-all.mjs script to check my project data against the skill's schemas.
Prompt 4
Show me how to estimate production cost and generation failure cost for my storyboard using this skill's tools.

Frequently asked questions

wtf is script-to-shootable-storyboard?

A Codex skill that turns a screenplay or story outline into shootable, atomic shots with continuity tracking, ready for live action filming or AI video generation like Seedance.

What language is script-to-shootable-storyboard written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js, Codex.

What license does script-to-shootable-storyboard use?

You can use, modify, and share this freely, including commercially, as long as you keep the original copyright notice.

How hard is script-to-shootable-storyboard to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is script-to-shootable-storyboard for?

Mainly writer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.