eternityspring/shuohao-skills

What it solves

This project provides a structured set of "skills" designed for AI coding agents (such as Claude Code and codex) to automate the complex pipeline of turning a novel into a short-form AI video series. It solves the problem of maintaining consistency and quality across the various stages of pre-production, from plot outlining to final storyboarding.

How it works

The system operates as a sequential pipeline where each stage feeds into the next to ensure structural convergence and consistency. It consists of five primary skills:

1. Novel Outline: Converts a novel into a short-drama outline, including character lists, "hook" points, episode summaries, and an asset list.
2. Novel Characters: Generates detailed character profiles, image prompts, and voice prompts based on the outline.
3. Novel Art: Creates an art setting collection for scenes and narrative props, establishing consistency anchors and lighting variants.
4. Novel Script: Writes the script with a focus on pacing, dialogue, and timing, formatted for direct integration with Text-to-Speech (TTS) tools.
5. Novel Storyboard: Produces a detailed storyboard with precise timing (2-5 second segments) and prompts aligned with tools like MiniMax H3.

These skills are implemented as self-contained directories containing workflow instructions (SKILL.md), deterministic scripts for rendering reports, and self-tests.

Who it’s for

It is intended for AI video creators and developers using AI coding agents who want a professional, automated workflow for adapting literary works into short-form video content.

Highlights

• Agent-Ready: Specifically built to be linked into Claude Code and codex environments.
• Quality Gates: Includes multiple "quality gates" (script-based checks) for each skill to ensure output rigor.
• Novel-to-Video Pipeline: A complete end-to-end flow from raw text to production-ready storyboard packages.
• Zero Dependency: The scripts use only standard Node.js libraries, requiring no npm installs.