Repolode
eternityspring

eternityspring/shuohao-skills

A collection of agent-agnostic skills covering each stage of AI short-drama production, from novel adaptation to storyboards.

Stars
6,148
Forks
864
Open issues
0
Last commit
12 days ago

What is it?

shuohao-skills is a set of self-contained skills for producing AI short dramas from a source novel or original story. The pipeline runs in stages: a five-piece adaptation outline, a character bible, scene and prop art specifications, a screenplay with duration estimates and per-character line books, opening staging for each scene, and a storyboard that splits scenes into generation segments and keyframes.

Each skill is a folder with a SKILL.md workflow and zero-dependency Node.js scripts that validate outputs against quality gates and render HTML reports. The skills are not tied to one agent runtime; the installer symlinks them into Claude Code and Codex, and other agents can load SKILL.md directly. A separate character-refs skill generates reference images for characters, with an anchor front view and other views derived from it.

The repository also includes a script that merges the reports from the outline, character, art, screenplay and storyboard stages into a single page with a left-hand navigation.

Key features

  • 01Adaptation outline with script-checked quality gates and a checkup mode for existing outlines
  • 02Character bible with design and voice prompts, seeded from the outline
  • 03Art bible for scenes and props, including lighting variants and white-plate references
  • 04Screenplay with reading-speed duration estimates and a per-character line book for TTS
  • 05Scene staging with an editable top-view report and blocking sentences for storyboards
  • 06Storyboard with segment, cut and keyframe planning, plus H3 and Seedance production packs

Use cases

  • Turning a novel into a short-drama outline and episode synopses before production
  • Building consistent character and scene references for AI image and video generation
  • Drafting a screenplay with timed episodes and per-character dialogue for voice synthesis
  • Planning storyboards and keyframes for a short drama that uses AI video models

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/eternityspring/shuohao-skills.git
  2. 2

    Enter the project folder

    cd shuohao-skills
  3. 3

    Run the installer to link skills into Claude Code or Codex

    ./scripts/install.sh

Things to know

  • The skills are Chinese-first, and novel-characters produces Chinese profiles even for English source novels.
  • The character-refs skill needs an image model: your own ComfyUI, local codex image generation, an OpenAI API key, or a custom command.
  • The storyboard stage does not automatically import staging.json yet; opening blocking must be copied by hand.

In collections

Topics

FAQ

What is shuohao-skills?
A collection of agent-agnostic skills covering each stage of AI short-drama production, from novel adaptation to storyboards. shuohao-skills is a set of self-contained skills for producing AI short dramas from a source novel or original story. The pipeline runs in stages: a five-piece adaptation outline, a character bible, scene and prop art specifications, a screenplay with duration estimates and per-character line books, opening staging for each scene, and a storyboard that splits scenes into generation segments and keyframes.
Is shuohao-skills free to use? What license does it have?
shuohao-skills is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is shuohao-skills still maintained?
Actively maintained. The last commit to shuohao-skills was on Oct 26, 2026.
What can I use shuohao-skills for?
Turning a novel into a short-drama outline and episode synopses before production Building consistent character and scene references for AI image and video generation Drafting a screenplay with timed episodes and per-character dialogue for voice synthesis Planning storyboards and keyframes for a short drama that uses AI video models
How do I install shuohao-skills?
Clone the repository: git clone https://github.com/eternityspring/shuohao-skills.git Enter the project folder: cd shuohao-skills Run the installer to link skills into Claude Code or Codex: ./scripts/install.sh
Where can I get shuohao-skills?
The source code and installation instructions are on GitHub: https://github.com/eternityspring/shuohao-skills

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects