Having AI write scripts for AI short dramas — anyone can do that. But writing scripts that actually produce good short dramas? That’s hard! Today this gap is filled: shuohao-skills/novel-script is now open source.

• Generate structured scripts from episode synopses, with each episode designed with an opening hook and a cliffhanger ending
• Per-episode runtime constraints: dialogue calculated at 4.5 characters/sec, actions at 2.5 sec/beat, ±15%
• Dialogue scripts aggregated by character — can be fed directly to TTS for batched voice-over

With this, the AI short drama four-piece set — character breakdown, outline planning, art direction, scriptwriting — is complete. From a single novel to a production-ready script set, the entire pipeline is open source.

http://github.com/eternityspring/shuohao-skills…

1.2k stars in one week. One person + AI, and the barrier to industrializing short dramas is down to just the storyboard step. I’ll open source the storyboard skill once I’ve polished it further — stay tuned!

eternityspring/shuohao-skills

Source: https://github.com/eternityspring/shuohao-skills

English · 中文

👋 Job hunting / Collaboration — The author is currently between engagements; this repo is just a small side exploration. Feel free to reach out if you’re a kindred spirit. Beyond remote work, I’m also open to semi-partnership — a few thousand yuan monthly for living expenses + profit sharing. If necessary, for FED roles, on-site travel is also possible. I hope to find like-minded friends to build something with in the AI wave. Personal resume: resume.79px.com (https://resume.79px.com)

I’ve set up an AI short drama discussion group (paid) covering AI short drama workflows, tools, and hands-on practice. Interested? Add me on WeChat: hao_dev, with the note github when adding.

shuohao-skills

A collection of skills for AI short drama production: from a single novel to production-ready materials — character breakdown, outline planning, scene & prop design, and scriptwriting. Built for AI coding agents — works with both Claude Code and codex.

Drop a novel in, get these four sets out:

novel-characters · Character setting pack

Character setting pack report

novel-outline · Short drama adaptation outline

Short drama adaptation outline report

novel-art · Art setting pack (scenes + props; design images are actually generated by the skill)

Art setting pack report

novel-script · Script (runtime dashboard + per-episode script + dialogue sides)

Script report

Installation

git clone https://github.com/eternityspring/shuohao-skills.git
cd shuohao-skills
./scripts/install.sh

Automatically detects whether Claude Code or codex is installed locally and soft-links all skills there — takes effect immediately after git pull, no reinstall needed.

./scripts/install.sh novel-characters  # install only one
./scripts/install.sh --codex           # install only to codex
./scripts/install.sh --uninstall       # remove soft links

Don’t want to use the script? Link them yourself:

ln -s "$PWD/skills/novel-characters" ~/.claude/skills/novel-characters
ln -s "$PWD/skills/novel-characters" ~/.codex/skills/novel-characters

Prerequisites

Repository conventions

One directory per skill, self-contained and copyable on its own:

skills/<skill-name>/
├── SKILL.md                Workflow for the agent to read (required)
├── README.md               Documentation for humans
├── scripts/
│   ├── *.mjs               Deterministic tools, zero dependencies
│   └── selftest.mjs        Self-test, no model calls (required)
├── references/             Detailed instructions loaded on demand
├── examples/               Built-in samples, also used as test fixtures
└── assets/                 Screenshots

Two hard requirements:

• Every skill must have a SKILL.md
• Every skill must have a scripts/selftest.mjs — no model calls, no quota consumed — covering all deterministic logic

Before adding a new skill, run all self-tests first:

for f in skills/*/scripts/selftest.mjs; do node "$f"; done

No CI configured — self-tests are fast enough (1 second), and running once locally beats waiting on CI. Only verified on macOS + Node 24; the code has no platform-specific calls, so Linux and older Node versions should theoretically work, but haven’t been verified.

License

Apache 2.0

Shuohao (@eternityspring): In AI short dramas, the real killer isn’t ugly visuals — it’s “looking inconsistent.”

The same boathouse has a patched canopy in one shot and none in the next; a suitcase is leather in one episode and plastic in the next. Traditional film crews have real sets and props that are naturally consistent, but AI regenerates every shot — scenes and props often pull a “72 transformations.”

The “scene skill” teased last time is done — novel-art, purpose-built for AI