shuohao-skills - An open-source collection of AI short drama production skills, including a complete workflow. - AiBoss

What is shuohao-skills?

shuohao-skills is an open-source collection of AI short drama production skills, designed specifically for agents such as Claude Code/Codex. The tool provides a complete workflow from novel adaptation outlines, character design, art direction, scriptwriting to storyboarding, with scripted quality checks at each stage to ensure unique characters, accurate duration, and consistent style. Outputs can be directly integrated into TTS and video generation pipelines, enabling one-stop AI short drama pre-production from text to production package.

The main functions of shuohao-skills

Adaptation outlineThe novel is broken down into short drama adaptation instructions, character lists, exciting pacing, episode summaries, and asset lists to streamline the story structure.
Character settingsExtract character information and generate a setting set containing three-view diagrams and visual/voice prompts, automatically verifying the similarity between characters to prevent duplication.
Art DesignEstablish style anchors, lighting variations, and white-background cue words for primary/secondary/one-off scenes and narrative props to ensure visual consistency.
ScreenwritingThe script is organized by scene and beat, the lines are grouped by character and accompanied by voice prompts, and the duration is fixed by formula to connect with TTS.
Storyboard segmentationIt splits shots by second and generates footage based on the initial design, outputting a production package containing MiniMax H3 prompts that directly connect to the downstream video pipeline.

How to use shuohao-skills

Environmental preparationEnsure that Claude Code or OpenAI Codex is installed on your machine.
One-click installationRun after cloning the repository ./scripts/install.shThe script automatically detects Agent tools and creates symbolic links.
Start the adaptationEnter commands in the Agent dialog (e.g.) 用 shuohao-skills 跑 novel-outline(And transmit the original text of the novel.)
Execute in sequenceCall in sequence novel-outline → novel-characters → novel-art → novel-script → novel-storyboard Five skills.
Script quality inspectionEach step is automatically executed by an independent script, performing 4 to 17 quality checks and generating an HTML report for one-click viewing.
Export to productionFinally, the production package containing MiniMax H3 prompts and reference images is exported from the storyboard skill and directly connected to the downstream video generation pipeline.

The core advantages of shuohao-skills

Scripted quality controlMore than 50 independent validation scripts do not consume model quotas and automatically intercept issues such as duplicate roles, excessive duration, and asynchronous prompts.
Consistency of styleEarly character and scene design sketches were used directly as storyboard references to ensure that the visual style and character appearance remained consistent throughout the storyboard.
pipeline straight-throughThe script comes with TTS voice prompts, and the storyboard can be exported with one click to a production package containing MiniMax H3 prompts, which can be used directly downstream.
Zero-dependency self-containmentIt is implemented using the pure Node.js standard library, with no npm dependencies, and each skill can be copied and used independently.
Full-process closed loopFrom the novel adaptation outline to the storyboard segmentation, the five segments are produced in a coherent and connected manner, without the need for repeated manual editing and connection.
Formula dead timeThe dialogue is automatically converted into seconds based on speaking speed and the actions are converted into beats. Any over- or under-written lines are marked in red in the report.

Project address for shuohao-skills

GitHub repository：https://github.com/eternityspring/shuohao-skills

Comparison of similar competing products with shuohao-skills

Comparison Dimensions	shuohao-skills	Open-AI-Micro-Drama-Generator
Product Positioning	Claude / Codex Agent Skill Collection, focusing on short dramasPre-construction pipelines	Multi-Agent Fully Automated Short Drama Generation PlatformEnd-to-end production of finished products
Product Form	No user interface, pure Skill + validation script, embedded in Agent dialogue.	FastAPI backend + Next.js frontend, standalone web application
Workflow Coverage	Adaptation outline → Characters → Art direction → Script → Storyboard (stops at production package)	Story Development → Character Extraction → Script → Storyboard → Frame Generation → Video → Final Cut
Interaction methods	Driven by natural language commands, the agent executes each step and generates an HTML report.	Web form submission of subject/script, background pipeline runs automatically and SSE pushes stream in real time.
Quality control	50+ independent Node.js script validations, zero model quota consumption, error interception immediately.	It relies on the inference quality within each Agent and lacks an external, independent quality control layer.
Consistency Guarantee	The initial concept art is passed as storyboard reference images, and the script automatically intercepts style drift.	Character portraits are reused shot-by-shot as I2I reference images, relying on the stability of the generative model.
Deployment dependencies	Requires only Node.js version 18 or higher, zero npm dependencies, and can be run completely offline.	Requires a Python + Node.js environment and depends on the external MuAPI key and model service.
Final output	Storyboard production package (MiniMax H3 prompts + reference images + JSON structured data)	Complete MP4 video files that can be published directly
Core advantages	Engineering-based quality control, consistent style, and reproducible iteration.	One-click fully automatic, real-time progress monitoring, and zero learning curve.

Application scenarios of shuohao-skills

Short drama adaptation of online novel IPThe system automatically breaks down popular online novels into complete pre-production material packages, including exciting moments, character settings, and storyboards, for short drama teams to use directly in filming.
Short drama studio industrialized productionEstablish a standardized pre-production pipeline to achieve batch, reproducible output from script to storyboard, reducing the production costs and style drift risk of multi-episode series.
Independent creators' personal productionA single person can complete the entire process from novel to storyboard using Claude/Codex, producing industrial-quality pre-production materials without the need for a professional screenwriter or storyboard artist.
Storyboard preview for advertising and brand storiesQuickly transform brand storyboards into visual storyboards with reference images and shot descriptions for use in internal proposals, client communications, or pre-shoot visual confirmation.
Film and television teaching and script analysisAs a teaching tool, it demonstrates the complete deconstruction process from literary text to audiovisual language, helping students understand the design logic of character creation, rhythm control, and camera language.