Skip to content
SkillScript-led3,250 tokens in use

Novel Staging

Plans the opening positions of every scene in an AI short drama and writes the blocking sentences that storyboards copy into their first segment.

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

Install command as written in the repository's README

Skill label

measured from its files

What installing Novel Staging costs

328tokens idle
3,250tokens 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-staging.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
  • Frontmatter12/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 68
  • Writes files−4

    does this on the machine, as the frontmatter declares

    SKILL.md, line 68

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 Staging fixes who is where at the start of each scene. Each video segment of an AI short drama is generated on its own, so group scenes drift: guests appear at a table, and the wrong person ends up seated. This skill plans the opening arrangement once, before the storyboard.

It reads scene images to identify things people can stand beside or sit on, projects them onto a top-view plan, assigns each character a place, posture and facing, and adds extras only when the script calls for them. The default result is an HTML report where you drag people on the plan and export the edited JSON. Eight quality gates run as code. The skill is written in Chinese and reports default to Chinese, with an English option.

What You Get

  • A staging.json with items per location and opening positions per scene
  • An interactive HTML report with a draggable top view and live checks
  • One blocking sentence per scene, ready to paste into the first storyboard segment
  • An optional Markdown export when a text version is wanted

Common Use Cases

  • Seating six characters around a table so every generated segment agrees
  • Marking who is absent when a scene opens and who walks in later
  • Adjusting a position with one sentence such as moving a character to the bow of a boat

What Makes It Unique

Positions may only land on items that were identified in the scene image, so nobody sits on a platform that exists only in a prompt. Directions are given as compass sides of objects, not left and right of the screen, because a camera change would flip the latter. The blocking sentence is generated by code and copied word for word into the storyboard.

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, validate, render and print blocking sentences, and it starts sub-agents to read images and plan scenes in parallel when the environment allows. It reads the script, art and outline JSON files and the scene images in an images folder, and writes JSON and HTML files. The generated report runs a script in your browser for dragging and exporting, and it stores edits in the browser. 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