novel-script

Writes structured AI short-drama scripts with scenes, beat flows, and per-episode duration budgets.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Writing scripts for AI-generated short drama requires dialogue as structured data (not prose) and strict per-episode runtime control, since overruns discovered downstream force costly regeneration. This Skill turns per-episode synopses from an outline into scenes with alternating action beats and dialogue lines, deterministically estimating each episode's duration so a three-minute episode is actually three minutes.

Core Features & Use Cases

  • Beat-flow scripting: Every scene alternates action beats (one event each, narrative prose) with dialogue lines carrying speaker and delivery notes, feeding directly into per-line TTS generation.
  • Deterministic duration budgeting: Dialogue converts at reading speed (4.5 chars/sec default) and action at a fixed per-beat estimate, with every episode gated to land within ±15% of its target seconds.
  • Ten code-enforced quality gates: Line length limits, speaker legality, hook-in-first-3-beats cold opens, at least one action beat per scene, and cross-checks of characters, scenes, lighting states, and props against upstream outline and art-bible JSON files.
  • Review report: Renders a self-contained bilingual (Chinese/English) HTML report with a duration gauge, per-episode scripts, scene table, and a character-grouped line book with voice-prompt copy buttons for TTS.
  • Use Case: Given an outline.json for a 6-episode vertical drama, seed the script skeleton, write episodes in batches of up to 3, validate against the outline and art bible, then export script.json plus a review-ready HTML report.

Quick Start

Ask the agent to write the script for episodes 1-3 of your short drama using your outline.json, then validate and render the HTML report.

Frequently Asked Questions about novel-script

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

FAQPage Schema
How do I write a script for AI-generated short drama?

Seed a script.json skeleton from your outline.json with the seed command, write each episode's scenes as alternating action beats and dialogue lines, then run validate to check ten quality gates. Render produces a Markdown script and a self-contained HTML review report.

How is episode duration estimated for short drama scripts?

Dialogue seconds equal non-whitespace character count divided by reading speed (4.5 chars/sec by default), and each action beat counts as a fixed 2.5 seconds. Every episode must land within ±15% of its targetSeconds, with all parameters tunable via the params field.

Does novel-script work with Claude Code and Codex?

Yes, the skill runs on both Claude Code and Codex runtimes. Its helper script is zero-dependency Node.js (18+, standard library only), so it works in any directory without npm install or API keys.

Can the script report be rendered in English?

Yes, pass --lang en to the render command for a fully English report UI, or set a top-level lang field in script.json. Quality-gate labels are translated while thresholds and all authored data stay in the original language.

What are the limitations of this screenwriting skill?

It deliberately excludes storyboarding: no shot numbers, no frame prompts, and no image generation, which belong to the downstream storyboard skill. Duration is an estimate with ±15% tolerance, not a stopwatch, and batches should stay at three episodes or fewer.