novel-storyboard

Generates storyboards with segments, cuts, keyframes, and MiniMax H3 prompts for AI short drama.

2.8k|363|Updated Aug 6, 2026
One-click install
npx skills add https://github.com/eternityspring/shuohao-skills --skill novel-storyboard
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: novel-storyboard
Source: https://github.com/eternityspring/shuohao-skills/tree/main/skills/novel-storyboard
Command: npx skills add https://github.com/eternityspring/shuohao-skills --skill novel-storyboard

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Turning a screenplay into a shot list that a video generation model can actually execute requires reconciling timing, dialogue, camera moves, and reference images by hand, which is error-prone and hard to audit. This Skill converts a script's beat flow into a deterministic, machine-validated storyboard worklist for AI short drama production.

Core Features & Use Cases

  • Three-level storyboard structure: Segments (one video generation call, up to 15 seconds) contain 2-5 second cuts, each claiming script beats, with one keyframe per cut pinned to its cut mark.
  • Derived H3 prompts: MiniMax H3 alignment instructions and [Shot k] cut times are computed from cut durations and audited verbatim, with dialogue placed word-for-word in <d> blocks.
  • 17 scripted quality gates: Beat coverage, cut duration, dialogue fit, style phrase consistency, reference reconciliation, and an optional shot-recipe gate are all checked by code, not by model self-assessment.
  • Use Case: Given a script.json from the novel-script skill, run seed to expand beats, cut each episode into segments, validate against all gates, optionally generate keyframes via codex $imagegen using character and scene sheets as references, then export a per-segment H3 production package.

Quick Start

Ask the agent to storyboard episode 1 of your short drama by running the novel-storyboard seed and validate commands against your script.json, then render the HTML review report.

Frequently Asked Questions about novel-storyboard

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a storyboard for AI video generation from a script?

Run the seed command with your script.json to deterministically expand each scene's beats into a cutting worksheet, then write segments and cuts per episode. The validate command checks the result against 17 quality gates before rendering the report.

What is the MiniMax H3 prompt format for multi-image video generation?

Each segment gets one H3 prompt with an alignment line pinning each reference picture to its cut time, an integrated_multimodal_description with one [Shot k] line per cut, plus soundscape and music fields. The alignment line and cut times are derived from cut durations and audited verbatim.

Does novel-storyboard require codex or an API key to generate frames?

No API key is required. Keyframe generation is optional and uses the codex $imagegen system skill with scene, character, and prop sheets as reference images; without codex the step is skipped and the report shows honest placeholders.

Can I use this storyboard skill without the other novel pipeline skills?

Yes, the skill is self-contained and only requires script.json as a hard prerequisite. Outline, cast, and art JSON files are optional inputs that enable name-ban checks and richer reports, and the shot-recipe card library is an optional mount.

Why does storyboard validation fail after changing cut durations?

The H3 alignment instruction and every [Shot k] cut time are derived from cut durations and audited character for character. Changing a duration without regenerating the prompt causes the h3-structure gate to block until the prompt is updated.

What are the limitations of AI-generated storyboard timing?

Cut seconds are generation orders for the video model, not estimates, and lip-sync is out of scope. Segment caps and cut rhythm ranges are tunable in params, and the skill does not write dialogue, design sheets, or perform video editing.