What is shuohao-skills
shuohao-skills is an open-source AI short drama production Skill collection, designed specifically for Claude Code / Codex and other Agents. The tool provides a complete workflow from novel adaptation outlines, character settings, art settings, script writing to storyboard segmentation, with each stage equipped with scripted quality checks to ensure characters are not similar, duration is precise, and style is consistent. The output can directly connect to TTS and video generation pipelines, realizing one-stop AI short drama pre-production from text to production package.
Main features of shuohao-skills
-
Adaptation outline: Break down the novel into short drama adaptation notes, character list, excitement rhythm, episode summaries and asset list, converging the story structure.
-
Character settings: Extract character information and generate a setting collection including three-view drawings, appearance/voice prompt words, automatically verifying similarity between characters to prevent resemblance.
-
Art settings: Formulate style anchors, lighting variants and white-background prompt words for main/secondary/one-time scenes and narrative props, ensuring visual consistency.
-
Script writing: Organize the script by scene and beat flow, aggregate dialogue by character with voice prompt words attached, and lock down duration with formulas to connect to TTS.
-
Storyboard segmentation: Segment shots by second and generate visuals using pre-production setting images as reference, outputting a production package containing MiniMax H3 prompt words, directly connecting to the downstream video pipeline.
Follow WeChat and reply "open source" to join theAI open-source project exchange group
How to use shuohao-skills
-
Environment preparation: Ensure Claude Code or OpenAI Codex is installed on your machine.
-
One-click installation: After cloning the repository, run
./scripts/install.sh, the script automatically detects the Agent tool and creates symbolic links. -
Start adaptation: Enter a command in the Agent conversation (such as
用 shuohao-skills 跑 novel-outline) and pass in the original novel text. -
Execute in order: Sequentially call the
novel-outline→novel-characters→novel-art→novel-script→novel-storyboardfive skills. -
Script quality check: Each stage automatically executes 4~17 quality checks via an independent script, producing an HTML report for one-click viewing.
-
Export production: Finally export from the storyboard skill a production package containing MiniMax H3 prompt words and reference images, directly connecting to the downstream video generation pipeline.
Core advantages of shuohao-skills
-
Scripted quality control: More than 50 independent verification scripts do not consume model credits, automatically intercepting issues such as similar characters, excessive duration, and prompt word desynchronization.
-
Style consistency: Pre-production character and scene setting images are directly used as storyboard reference images, ensuring the visual style and character appearance do not drift.
-
Direct pipeline connection: The dialogue script comes with TTS voice prompt words, and storyboards can be exported with one click as a production package containing MiniMax H3 prompt words, directly usable downstream.
-
Zero-dependency self-contained: Implemented purely with the Node.js standard library, with no npm dependencies, each skill can be copied out separately and used plug-and-play.
-
Full-process closed loop: From novel adaptation outline to storyboard segmentation, the five stages are connected coherently, with no need for manual repeated organization of the connections.
-
Formula jam duration: Dialogue is automatically converted to seconds based on speech rate, and actions based on beats; over- and under-writing are marked in red in the report.
Project address of shuohao-skills
- GitHub repository：https://github.com/eternityspring/shuohao-skills
Comparison of shuohao-skills with similar competitors
| Comparison dimension | shuohao-skills | Open-AI-Micro-Drama-Generator |
|---|---|---|
| Product positioning | Claude / Codex Agent Skill collection, focused on short dramasPre-production pipeline | Multi-Agent fully automatic short drama generation platform,end-to-end finished video output |
| Product form | No interface, pure Skill + validation scripts, embedded in Agent conversations | FastAPI backend + Next.js frontend, standalone Web application |
| Workflow coverage | Adaptation outline → characters → art → script → storyboard (stops at production package) | Story development → character extraction → script → storyboard → frame generation → video → finished video |
| Interaction method | Driven by natural language instructions; the Agent executes each stage and generates HTML reports | Submit theme/script via Web form; backend pipeline runs automatically and streams in real time via SSE |
| Quality control | 50+ independent Node.js script validations, zero model quota consumption, errors are immediately blocked | Relies on the internal reasoning quality of each Agent; no external independent quality inspection layer |
| Consistency assurance | Pre-production setting images are passed as storyboard reference images; scripts automatically block style drift | Character portraits are reused shot by shot as I2I reference images, relying on the stability of the generation model |
| Deployment dependencies | Only requires Node.js ≥ 18, zero npm dependencies, can be fully offline | Requires Python + Node.js environment, depends on external MuAPI keys and model services |
| Final output | Storyboard production package (MiniMax H3 prompts + reference images + JSON structured data) | Complete MP4 video file ready for direct publishing |
| Core advantages | Engineering-grade quality inspection, style consistency, reproducible iteration | One-click full automation, real-time visible progress, zero-threshold onboarding |
Application scenarios of shuohao-skills
-
Short drama adaptation of web novel IP: Automatically break down popular online novels into a complete pre-production material package including exciting-beat rhythm, character settings, and storyboard scripts, for short drama teams to put directly into filming.
-
Industrialized production by short drama studios: Establish a standardized pre-production pipeline to achieve batch, reproducible output from script to storyboard, reducing production costs and style drift risks for multi-episode series.
-
Individual production by independent creators: A single person can use Claude / Codex to complete the entire process from novel to storyboard, producing industrial-grade pre-production materials without a professional screenwriter or storyboard artist.
-
Storyboard preview for advertising and brand stories: Quickly transform brand story scripts into visual storyboards with reference images and shot descriptions, for internal proposals, client communication, or visual confirmation before shooting.
-
Film and television teaching and script analysis: As a teaching tool, demonstrate the complete breakdown process from literary text to audiovisual language, helping students understand character development, rhythm control, and the design logic of shot language.