gitwtfhub

wtf is shuohao-skills?

eternityspring/shuohao-skills — explained in plain English

Analysis updated 2026-08-13

1,266JavaScriptAudience · writerComplexity · 2/5LicenseSetup · easy

TL;DR

A set of AI agent skills that turn a novel into short-drama production material: character designs, adaptation outlines, art direction, and screenplays.

Mindmap

mindmap
  root((shuohao-skills))
    What it does
      Novel to short drama pipeline
      Character design generation
      Screenplay writing
    Tech stack
      Node.js
      Claude Code
      Codex
    Use cases
      Character bibles
      Adaptation outlines
      Art direction sets
      Screenplays
    Audience
      Short drama writers
      AI agent users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Break a novel into a set of character design sheets with portraits and voice prompts.

REASON 2

Adapt a novel into a five-part short drama outline with quality checks.

REASON 3

Write a screenplay with scene-by-scene shots and dialogue formatted for text-to-speech.

What's in the stack?

JavaScriptNode.jsClaude CodeCodex

How it stacks up

eternityspring/shuohao-skillsritz078/embed-jsobra/youtube2webpage
Stars1,2661,2721,303
LanguageJavaScriptJavaScriptJavaScript
Last pushed2022-07-07
MaintenanceDormant
Setup difficultyeasyeasymoderate
Complexity2/52/52/5
Audiencewriterdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

No API key needed, uses the host agent's own session budget, Node.js 18+ required.

Use freely for any purpose, including commercial use, under the Apache 2.0 license, as long as you keep the copyright and license notices.

Wtf does this do

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.

Yoink these prompts

Prompt 1
Use the novel-characters skill to turn this novel into a character design set.
Prompt 2
Use the novel-outline skill to adapt this novel into a short drama outline with quality checks.
Prompt 3
Use the novel-script skill to write a screenplay from this outline, grouped by character for TTS.

Frequently asked questions

wtf is shuohao-skills?

A set of AI agent skills that turn a novel into short-drama production material: character designs, adaptation outlines, art direction, and screenplays.

What language is shuohao-skills written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js, Claude Code.

What license does shuohao-skills use?

Use freely for any purpose, including commercial use, under the Apache 2.0 license, as long as you keep the copyright and license notices.

How hard is shuohao-skills to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is shuohao-skills for?

Mainly writer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.