Skip to content
SkillScript-led2,921 tokens in use

Novel Script

Writes AI short-drama screenplays as structured scenes, action beats and dialogue lines, with per-episode run time estimated by script.

6,884 stars on the repository Apache License 2.0eternityspring/shuohao-skills · skills/novel-script
./scripts/install.sh novel-script
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing Novel Script costs

399tokens idle
2,921tokens 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-script.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
  • Resources1/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 76
  • Writes files−4

    does this on the machine, as the frontmatter declares

    SKILL.md, line 76

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 Script turns the episode synopses of an outline into a screenplay for AI short drama. Each episode becomes scenes made of beats, where action beats alternate with dialogue lines, and every line carries a speaker and a delivery note so it can feed text-to-speech directly.

It deliberately stays above the storyboard: no shot numbers and no image prompts. Ten quality gates run as code, including run time within 15 percent of target, a line length cap, a concrete hook inside the first three beats, a payoff claim from the outline and a check of scenes, lighting and props against the art file. The skill is written in Chinese and reports default to Chinese, with an English option.

What You Get

  • A script.json with scenes, beats, dialogue lines and speaker tags
  • A Markdown version of the screenplay
  • An HTML report with duration gauge, scene table and a per-character line book
  • Voice prompt buttons in the line book when a cast file is given

Common Use Cases

  • Writing a six-episode short-drama script from an approved outline
  • Fixing episodes that run long or short against the duration target
  • Feeding dialogue lines to speech generation one line at a time

What Makes It Unique

Dialogue is stored as structured data with one entry per line, which is what lets scripts check length, speakers and hooks. Run time is estimated from reading speed and beat count, so an overlong episode is caught before generation. It keeps screenplay and storyboard as separate layers, so lines can be rewritten many times without redoing shots.

Under The Hood

The skill is an instruction file with Node.js scripts that use only the standard library. It runs shell commands to seed episodes, validate the ten gates and render the report, and it starts sub-agents to write episodes in parallel when the environment allows. It reads the outline, art and cast JSON files you give it and writes JSON, Markdown and HTML files. It does not fetch web pages or call outside APIs and needs no API key.

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