eternityspring/shuohao-skills — explained in plain English
Analysis updated 2026-08-13
Break a novel into a set of character design sheets with portraits and voice prompts.
Adapt a novel into a five-part short drama outline with quality checks.
Write a screenplay with scene-by-scene shots and dialogue formatted for text-to-speech.
| eternityspring/shuohao-skills | ritz078/embed-js | obra/youtube2webpage | |
|---|---|---|---|
| Stars | 1,266 | 1,272 | 1,303 |
| Language | JavaScript | JavaScript | JavaScript |
| Last pushed | — | 2022-07-07 | — |
| Maintenance | — | Dormant | — |
| Setup difficulty | easy | easy | moderate |
| Complexity | 2/5 | 2/5 | 2/5 |
| Audience | writer | developer | general |
Figures from each repo's GitHub metadata at analysis time.
No API key needed, uses the host agent's own session budget, Node.js 18+ required.
shuohao-skills is a collection of skills built for AI coding agents like Claude Code and Codex, aimed at helping people turn a novel into material ready for filming a short drama. It covers four stages: breaking a story into character profiles, turning a novel into a short drama outline, designing the art direction for scenes and props, and writing the actual screenplay. The collection includes four skills. The novel-characters skill splits a novel into a set of character designs, including portraits, appearance prompts, voice prompts, and character design sheets, in a choice of report languages and art styles. The novel-outline skill adapts a novel into a five part short drama outline, covering the adaptation notes, a character table, a table of dramatic highlights, an episode breakdown, and an asset checklist, with thirteen automated quality checks run across the whole script. The novel-art skill produces an art direction set covering scenes and props, including consistency anchor points, lighting and state variations, scale references, and prompts for empty, prop only backgrounds, pulling from a prefilled checklist and running eleven quality checks. The novel-script skill writes the actual screenplay, alternating shots between action and dialogue, estimating scene length from speaking pace, and grouping dialogue lines by character so they can be sent straight to text to speech tools, with nine quality checks of its own. To install it, a person clones the repository and runs an install script, which detects whether Claude Code or Codex is installed locally and symlinks the skills in, so a later git pull updates them automatically without reinstalling. Individual skills can be installed on their own, and skills can be installed to just one of the two tools if wanted. Using it requires Node.js version 18 or newer, since the skill scripts rely only on the standard library with no external dependencies to install, and it uses the token budget from the user's own AI session rather than a separate API key. The Codex CLI is optional and only needed for image generation. The project is released under the Apache 2.0 license and has only been tested on macOS with Node 24, though the code has no platform specific calls.
A set of AI agent skills that turn a novel into short-drama production material: character designs, adaptation outlines, art direction, and screenplays.
Mainly JavaScript. The stack also includes JavaScript, Node.js, Claude Code.
Use freely for any purpose, including commercial use, under the Apache 2.0 license, as long as you keep the copyright and license notices.
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly writer.
This repo across BitVibe Labs
Don't trust strangers blindly. Verify against the repo.