Skip to content
SkillScript-led4,734 tokens in use

novel-storyboard

Cuts an AI short-drama screenplay into segments, shots and keyframe prompts, with audited MiniMax H3 and Seedance video prompts and a review report.

6,884 stars on the repository Apache License 2.0eternityspring/shuohao-skills · skills/novel-storyboard
git clone https://github.com/eternityspring/shuohao-skills.git cd shuohao-skills ./scripts/install.sh
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing novel-storyboard costs

447tokens idle
4,734tokens in use

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Counts are approximate, made offline with cl100k_base.

Model dependence Script-led

Script-ledMixedModel-led

Most of this skill is scripts, so it behaves much the same whichever model runs it.

This describes the skill's structure, how much of it is scripts. It does not say how well it works. Scripts: scripts/novel-storyboard.mjs, scripts/selftest.mjs.

Touches

shelldeclared and detectednetworkdetectedwrites filesdeclared and detected

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Fair
  • Frontmatter8/15
  • Structure14/25
  • Examples15/15
  • Output5/15
  • Size11/15
  • Resources0/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Excellent
  • Runs shell commands−2

    does this on the machine, as the frontmatter declares

    SKILL.md, line 79
  • Writes files−4

    does this on the machine, as the frontmatter declares

    SKILL.md, line 79

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Good
  • Development activity92
  • Maintenance52
  • Community60
  • Maturity20
  • Momentum40

novel-storyboard builds the storyboard layer for AI short drama. Each video-generation segment of up to fifteen seconds is cut into two to five second shots that claim consecutive beats of the screenplay, and each shot gets a keyframe image prompt, a shot description and composition fields.

Every segment carries a MiniMax H3 video prompt whose alignment line and cut times are derived from the structure and checked character by character, with dialogue copied word for word. Seedance prompts are assembled by script. Eighteen scripted quality gates must pass before output.

What You Get

  • A storyboard JSON file with segments, shots, keyframe prompts and H3 video prompts
  • A Markdown version and an HTML report with a rhythm strip, episode shot tables, generation batches and a voice alignment sheet
  • Seedance prompts assembled from the structured fields
  • A production pack per segment with the prompt and the keyframe image list
  • A running log of which quality gates fail most often

Common Use Cases

  • Turning a finished short-drama screenplay into shots for AI video generation
  • Auditing existing H3 prompts for cut-time drift and missing dialogue
  • Grouping shots by scene and lighting so they share one environment reference image

What Makes It Unique

Shots claim screenplay beats, so coverage can be checked mechanically and a screenplay change flags the affected shots. Durations are computed values and the H3 alignment and cut times are derived and compared verbatim. Dialogue must appear word for word. All eighteen gates are code, with an optional recipe-card gate when you attach a card library.

Under The Hood

The skill runs one bundled Node script with no dependencies for seeding, validating, rendering, exporting and gate statistics, and may start sub-agents to cut episodes in parallel. It reads your screenplay and optional outline, cast and art files, and writes JSON, Markdown, HTML and export folders. Validation appends results to a gate log in the current folder, which can be turned off. It does not generate images or video; its output is prompts, lists and a local report file.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers