Novel Script

What it does

When your agent uses it

• Asked to 写剧本、出剧本、台词、场次、写戏、screenwriting for AI short drama
• Tasks that involve Creative writing and fiction

Example prompts

• “/novel-script”

Requirements

• Node.js
• Pre-approved tools (allowed-tools): Read, Write, Bash, Task, Glob

Workflow steps

5 steps, taken from the step headings in SKILL.md.

1. 1定输入与范围
2. 2seed 骨架
3. 3逐集写戏
4. 4校验 ⛔ 不能跳
5. 5输出与汇报

What it can do on your machine

Read from SKILL.md and the folder at commit ef4ac0c. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • Read
  • Write
  • Bash
  • Task
  • Glob

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 2 files in scripts/ (JavaScript), which the agent can run.

  Shell commands in SKILL.md call:

  • node

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Novel Script loads about 1.2k tokens when it runs, and up to ~22k if it reads all its reference files. Until then it costs about 122 tokens; SKILL.md has 196 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~122

When it runs · the whole SKILL.md, loaded when a task matches

~1.2k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~22k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

• NotePre-approves every shell command (allowed-tools: Bash)SKILL.md

  allowed-tools: Read, Write, Bash, Task, Glob

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from eternityspring/shuohao-skills at commit ef4ac0c, republished under its Apache-2.0 licence (© eternityspring). 196 words, ~1,194 tokens.

name

novel-script

description

给 AI 短剧写剧本：把 novel-outline 的分集梗概落成结构化的场次 + 节拍流（动作节拍与台词行交替）， 台词逐句带说话人与语气，时长逐集按语速确定性折算。产出 script.json + Markdown + 单页评审报告 （时长仪表 / 分集剧本 / 场次总表 / 按角色聚合的台词本，含导出 JSON）。 剧本管戏，分镜管拍——本 skill 不分镜头、无镜号、不写生成提示词，那些是下一层分镜 skill 的活。 10 道质量门全部由脚本确定性检查（每集时长 ±15%、单句 ≤35 字、说话人合法、钩子悬念落纸、 钩子具象前 3 拍内兑现（hookBeat 认领冷开场）、每场至少一个动作节拍、爽点认领、 角色/场景/光照/道具对账上游……）。 有 outline.json 就用 seed 预填每集骨架；给 --art 连光照状态一起对账。 零依赖、零 API key，用当前会话额度。 Use when asked to 写剧本、出剧本、台词、场次、写戏、screenwriting for AI short drama。

allowed-tools

Read, Write, Bash, Task, Glob

version

2.0.0

triggers

novel-script, 剧本, 写剧本, 出剧本, 写台词, 场次, 写戏, screenplay, script

metadata.license

Apache-2.0

metadata.runtimes

claude-code, codex

node {baseDir}/scripts/novel-script.mjs seed <outline.json> --eps 1-3 > <workdir>/script.json

node {baseDir}/scripts/novel-script.mjs validate <script.json> \
  --outline <outline.json> --art <art.json>

cd <输出目录>
node {baseDir}/scripts/novel-script.mjs render <剧名>-script.json --md \
  --outline <outline.json> --art <art.json> > <剧名>-script.md
node {baseDir}/scripts/novel-script.mjs render <剧名>-script.json --html \
  --outline <outline.json> --art <art.json> --cast <cast.json> > script-report.html
# 英文界面：加 --lang en（默认中文，也可跟 script.json 顶层的 lang 字段）

<输出目录>/
├── <剧名>-script.json
├── <剧名>-script.md
└── script-report.html             ← 双击就能开

novel-outline    → outline.json （什么：结构与分集）
novel-characters → cast.json    （谁：角色资产）
novel-art        → art.json     （哪里 + 手里拿的：美术资产）
novel-script     → script.json  （戏：场次、节拍、台词）

node {baseDir}/scripts/selftest.mjs

© eternityspring, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 13 other files (scripts, references, assets) in skills/novel-script of eternityspring/shuohao-skills.

• SKILL.md
• README.en.md
• README.md
• assets/report.webp
• examples/渡口-script.json
• references/report-style.md
• references/schema.md
• references/script-pass.md
• references/test-fixtures/upstream/README.md
• references/test-fixtures/upstream/渡口-art.json
• references/test-fixtures/upstream/渡口-cast.json
• references/test-fixtures/upstream/渡口-outline.json
• scripts/novel-script.mjs
• scripts/selftest.mjs

Open the folder on GitHubat commit ef4ac0c