Skip to content
SkillScript-led2,916 tokens in use

Novel Outline

Adapts a novel into a five-part short-drama outline: adaptation notes, cast, payoff beats, episode synopses and an asset list, all checked by scripted gates.

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

Install command as written in the repository's README

Skill label

measured from its files

What installing Novel Outline costs

269tokens idle
2,916tokens 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-outline.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 →
Good
  • Frontmatter12/15
  • Structure22/25
  • Examples15/15
  • Output5/15
  • Size13/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 84
  • Writes files−4

    does this on the machine, as the frontmatter declares

    SKILL.md, line 96

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 Outline turns a novel and a few target parameters into the first stage of an AI short-drama production. You give it the episode count, episode length and genre, and it produces an adaptation note, a cast table, a payoff-beat table, per-episode synopses and an asset list.

Fourteen quality gates run as code, not as a checklist for the model: character tier limits, a main-scene cap that scales with episode count, payoff spacing of three episodes or less, a required hook per episode and more. A checkup mode runs only the gates on an outline you already have. The skill is written in Chinese and its report defaults to Chinese, with an English option.

What You Get

  • An outline.json file with adaptation notes, cast, beats, episodes and assets
  • A Markdown version of the outline
  • A single-page HTML report with KPI band, decisions, payoff timeline and quality gates
  • A checkup mode that diagnoses an existing outline without rewriting it

Common Use Cases

  • Adapting a web novel into a 60-episode short drama outline
  • Checking an existing outline against payoff spacing and hook rules
  • Preparing the upstream file that character, art and script stages read

What Makes It Unique

The pass or fail decisions are made by script, so a model cannot talk its way past a gate. Four of the five parts are written by the model and the fifth, the asset list, is computed from the episode data. A user approval step sits before the episodes are written, so a wrong direction costs one round of skeleton and not the whole script.

Under The Hood

The skill is an instruction file with Node.js scripts that use only the standard library. It runs shell commands to split a long book into volumes, validate the outline against the gates and render the report, and it starts sub-agents to summarise volumes and write batches of episodes. It reads the novel text file you point it at and writes JSON, Markdown and HTML files into an output folder. It does not fetch web pages or call outside APIs, and it 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