shuohao-skills

Input a novel, output a full set of production-ready AI short drama materials including outline, character settings, art settings, screenplay and storyboards for AI video generation.

A collection of Agent skills for AI short drama production, covering full workflow from novel adaptation to storyboard output, compatible with Claude Code and codex.

eternityspring

Creators / Professionals

WritingVideoVerifiedOpen-source license: Apache

GitHub Stars3.2K

Suggested prompts

Help me adapt this novel into a complete AI short drama, output the full set of outline, character settings, art settings, screenplay, and storyboard production materials

Adapt the provided novel into a short drama outline, complete episode summaries and highlight sorting, output a standardized report

Generate character bibles and scene/prop art setting files based on my existing short drama outline

Convert my completed short drama outline and character settings into a production-ready storyboard package compatible with AI generation

About this skill

shuohao-skills

A set of five Skills for AI short-drama production. It starts with adapting a novel into an outline, then produces character design, art direction, scripts, and storyboards as production-ready materials for a generation pipeline.

AI short-drama production workflow

Included Skills

Skill	Main deliverables
`novel-outline`	Adaptation notes, character table, payoff table, episode summaries, and asset inventory; supports both new outlines and audits of existing outlines
`novel-characters`	Character profiles, appearance prompts, voice prompts, and character sheets; can prefill the cast from `outline.json`
`novel-art`	Scene and narrative-prop design, consistency anchors, lighting and state variants, scale references, and clean-background prompts; can prefill the inventory from `outline.json`
`novel-script`	Episode scripts organized by scenes and beats, deterministic duration estimates, and character-grouped dialogue sheets with voice prompts
`novel-storyboard`	Generation-length segments and shots, storyboard images, cut points, model prompts, and an exportable production package

Reports from all five Skills support Chinese and English interfaces. Each Skill can run independently or as part of the full sequence.

Workflow

novel-outline defines the adaptation structure, characters, and asset inventory.
novel-characters and novel-art establish consistency references for characters, scenes, and props.
novel-script turns the structure into scenes, actions, dialogue, and beats.
novel-storyboard divides the script into generatable shots and implements decisions already made rather than introducing new narrative decisions.
A report assembler can combine available reports into one navigable page and shows only the sections that were actually generated.

What You Provide

Depending on the Skill, provide the novel text, an existing outline, or a JSON file generated by the previous stage. You can also specify options such as report language and image style. If you only need one stage, you can start directly from that Skill.

What You Get

Structured JSON data
Readable Markdown documents
Interactive HTML reports
Character, scene, prop, or storyboard sheets when the image-generation step is used
Storyboard production packages and their prompts

Output Examples

Adaptation outline

Adaptation outline report

Character design

Character design report

Art direction

Art direction report

Script and dialogue sheets

Script report

Storyboards and production prompts

Storyboard report

Requirements and Limitations

Requires Node.js 18 or later. The scripts use only the standard library and have no npm dependencies.
Uses the model quota of the current session and does not require an additional API key.
Only the image-generation step requires Codex CLI and its built-in $imagegen; without it, image generation can be skipped while other outputs remain available.
The repository has only been tested on macOS with Node.js 24. The code does not use platform-specific calls, but Linux and earlier Node.js versions have not been verified.
Storyboard reports load images through relative paths. Keep the report HTML, manifest.json, and segment image directories at the prescribed level or the report will show missing-image placeholders.