eternityspring/shuohao-skills

What it solves

This project provides a structured set of "skills" (workflows) designed for AI coding agents (like Claude Code or codex) to automate the production pipeline of AI-generated short dramas. It transforms a raw novel into production-ready assets, ensuring consistency across characters, settings, and scripts while removing thes need for manual coordination between different AI generation steps.

How it works

The system operates as a multi-stage pipeline where each "skill" handles a specific part of the creative process. These skills are integrated into AI agents via symlinks and use a combination of markdown instructions (SKILL.md) and Node.js scripts for deterministic logic and quality checks.

The pipeline follows this sequence:

1. Novel Outline: Converts a novel into a drama outline, including character lists and plot points.
2. Novel Characters: Creates detailed character profiles, image prompts, and voice settings.
3. Character Refs: Generates consistent visual reference images (anchors) for characters.
4. Novel Art: Establishes art settings for scenes and narrative props.
5. Novel Script: Writes the script with timing calculations and TTS-ready dialogue.
6. Novel Storyboard: Produces a storyboard with timing, prompts for video models (like MiniMax H3), and production packages.

Who it’s for

It is built for creators and developers using AI agents to produce AI short dramas, specifically those utilizing tools like Claude Code or codex to manage the complex workflow from novel to video.

Highlights

• Agent-Native Design: Specifically built to be plugged into AI coding agents as skills.
• Strict Quality Control: Includes "quality gates" (scripted checks) for outlines, art, scripts, and storyboards to ensure output consistency.
• Visual Consistency: Uses "anchor images" to maintain character and scene appearance across different shots.
• Production-Ready Output: Generates export packages compatible with video generation tools like MiniMax H3 and Seedance.
• Zero-Dependency Scripts: Uses standard Node.js libraries without requiring npm installs for the core skill logic.