Shuohao's Open-Source Tool Turns Novels Into Short-Drama Scripts Automatically

A viral open-source toolkit turns any novel into character bibles, outlines, art references, scripts, and storyboards using Claude Code or Codex.

AlphaSignalAlphaSignal
·
·
Shuohao's Open-Source Tool Turns Novels Into Short-Drama Scripts AutomaticallyPRO
AuthorBy AlphaSignal Newsroom
Read2 min
TypeRepo
TopicVideo · Development
SubtopicVideo Generation · Code Generation
  • Shuohao-skills is an open-source pack of agent skills for Claude Code and Codex CLI, ~3.5K stars.
  • Turns a novel into character bible, outline, art references, screenplays, and storyboards.
  • Install via symlink script; git pull updates skills instantly with no reinstall.
  • Node 18+ only, zero npm dependencies, uses your existing agent session quota.
  • Every skill ships a SKILL.md workflow plus a model-free selftest.mjs for CI.
  • CI workflow not yet enabled; tested only on macOS with Node 24 so far.

Chinese indie developer Shuohao has published shuohao-skills, an open-source collection of agent skills that converts novel manuscripts into short-drama production assets. The repository has drawn roughly 3,500 stars and 477 forks by packaging a complex creative workflow into reusable instructions and deterministic Node.js scripts for Claude Code and OpenAI’s Codex CLI.

A source novel moves through five stages to produce character bibles, episode outlines, visual references, scripts, and shot-by-shot storyboards. Each stage returns structured files that writers, artists, production teams, or downstream software can revise and reuse.

Pipeline showing a novel transformed into characters, outlines, art references, scripts, and storyboards
The repository divides adaptation into five connected production stages.

Skills with testable seams

Claude Code and Codex CLI can discover task-specific instructions stored in designated local directories. In this repository, each skill occupies skills/<skill-name>/ and contains the instructions, scripts, references, examples, and assets required to perform one part of the adaptation workflow.

  • SKILL.md tells the agent when and how to run the workflow.
  • README.md explains the skill to developers and operators.
  • scripts/ contains zero-dependency Node.js utilities and selftest.mjs.
  • references/ stores detailed instructions that the agent can load when needed.
  • examples/ provides sample outputs and reusable test fixtures.
  • assets/ holds images and other supporting files.

Two repository-wide requirements keep the skills portable and testable: every skill must include

Pro article

This story is for Pro members

You've reached the end of the free preview. Upgrade to AlphaSignal Pro to read the full article - and everything else behind the paywall.

Trending
  • No trending articles

Comments

avatar

Next Reads