Agent skill

Novel Script

by suihe1 in suihe1/short-drama-production

将分集大纲写成结构化场次、动作节拍和逐句台词,核对人物与美术引用、估算时长并交付剧本评审报告。用于写剧本、对白和场次修订;不分镜、不直接执行配音或视频生成。

Apache-2.0Auto-check: notesMedia & Creative

Install Novel Script

skills CLI
$ npx skills add suihe1/short-drama-production --skill novel-script -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install suihe1/short-drama-production novel-script --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/suihe1/short-drama-production.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/novel-script .claude/skills/novel-script && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
novel-script
GitHub stars
177
Token cost
~658 tokens
SKILL.md length
59 words
Files
11 (incl. scripts, references, assets)
Skills in repo
7
Repo updated
First seen
Licence
Apache-2.0

At a glance

将分集大纲写成结构化场次、动作节拍和逐句台词,核对人物与美术引用、估算时长并交付剧本评审报告。用于写剧本、对白和场次修订;不分镜、不直接执行配音或视频生成。

  • Tasks that involve Creative writing and fiction
  • SKILL.md covers 输入与改动范围, 写作与计时, 按需使用结构化工具 and 校验的两种级别, plus 1 more section
  • Runs JavaScript scripts from its folder; calls node

What it does

Novel Script is an agent skill from suihe1/short-drama-production. 将分集大纲写成结构化场次、动作节拍和逐句台词,核对人物与美术引用、估算时长并交付剧本评审报告。用于写剧本、对白和场次修订;不分镜、不直接执行配音或视频生成。

Its SKILL.md is about 660 tokens, which your agent loads only when the skill is triggered. The skill folder holds 14 other files, including scripts, reference files and assets (for example `README.en.md`, `README.md` and `examples/渡口-script.json`).

It sits in Media & Creative, covering Creative writing and fiction. It works with MiniMax. The repository describes itself as: AI 短剧生产总控 / 短剧skill:专业导演与分镜、MiniMax H3、CompShare、声音资产、粗剪与 QC,默认 16:9。 The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Creative writing and fiction

Example prompts

  • “/novel-script”

Requirements

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

What it can do on your machine

Read from SKILL.md and the folder at commit dbd3310. 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 3 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 658 tokens when it runs, and up to ~2.7k if it reads all its reference files. Until then it costs about 23 tokens; SKILL.md has 59 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~23
When it runs · the whole SKILL.md, loaded when a task matches
~658
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.7k

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

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • 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 suihe1/short-drama-production at commit dbd3310, republished under its Apache-2.0 licence (© suihe1). 59 words, ~658 tokens.

Download SKILL.mdSave it as .claude/skills/novel-script/SKILL.md (or your agent's skills folder). This skill also uses 10 other files; get the full folder from GitHub.
name
novel-script
description
将分集大纲写成结构化场次、动作节拍和逐句台词,核对人物与美术引用、估算时长并交付剧本评审报告。用于写剧本、对白和场次修订;不分镜、不直接执行配音或视频生成。
allowed-tools
Read, Write, Bash, Task, Glob
metadata.license
Apache-2.0
metadata.runtimes
claude-code, codex
metadata.version
1.2.0
metadata.triggers
novel-script, 剧本, 写剧本, 出剧本, 写台词, 场次, 写戏, screenplay, script

novel-script

根据用户的创作目标写作、评审、润色或结构化剧本。先读输入;已有完整剧本默认保留主要事件、人物关系、主题和结局,只有用户授权重构时才改变这些内容。独立短片、连续短剧、长片片段可以有不同节奏与结尾形式。

输入与改动范围

  • 已有剧本:按请求直接诊断、局部修改或整理;不要求先补一份大纲,不把附带的镜头、表演、声音意图丢掉。结构化时保留原文和定位,拍法可单独交接导演。
  • 已有大纲:继承已接受的故事事实,补写场内行动与对白,不重复决定人物去留。
  • 小说或想法:先确定本轮是改编方案、样场还是完整剧本;长篇改编需要方向选择时再使用 novel-outline,独立任务不强制安装它。

保留点和改动权限先从用户话语与既有约定确定。涉及未授权的删线、合人、变更结局或核心经历,先给具体位置、问题、改法或短样段及取舍,再请求决定。用户已授权的润色、结构化和自检直接完成;不要逐句请示。总控可用时遵循其 references/creative-agreement.md,独立使用也遵循本段。

写作与计时

模型负责人物、因果、潜台词和节奏,参考 references/script-pass.md。先完成适合用户审阅的剧本,再按需要结构化,避免边写边为字段凑戏。已有事实不重新编造,新增内容明确标为建议。

时长先作为预算;优先围读或临时音轨核实。对白、伴随动作、独立停顿和蒙太奇可能重叠,脚本的逐项相加不是剪辑时长。目标时长与内容冲突时,给保留内容延长、聚焦主线压缩等具体方案,不提高语速参数假装问题消失。

按需使用结构化工具

只做评审或文学修改时可交付 Markdown。进入制作、引用对账或用户需要报告时再交付 script.json;读 references/schema.md。{baseDir} 为本文件目录,Node 脚本零依赖。

bash
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>
node {baseDir}/scripts/novel-script.mjs render <script.json> --md > <workdir>/script.md
node {baseDir}/scripts/novel-script.mjs render <script.json> --html > <workdir>/script-report.html

seed 仅适用于已有大纲;outline/art/cast 参数均按已有输入提供。未提供的引用对账属于跳过,不能称验证通过。角色 ID、场景 ID 和台词归属服务下游关联,不决定剧情。旁白需保留声音归属;当前 VO 模式将人物身份写入 delivery。

校验的两种级别

默认 reviewPolicy: advisory(省略时同样生效):不运行台词长度、钩子/悬念、开场位置、动作表述和爽点等创作门;不是把旧要求换成警告继续催改。模型结合具体作品判断,不依赖固定清单。结构、说话人和已提供资产的引用错误仍会失败。

仅当项目已明确采用这些硬条件时使用 reviewPolicy: strict,它保留原版全部质量门。既有项目若依赖旧版拦截行为,迁移时显式设置 strict 并记录已有约定;不得为追求严格而替用户设置。批次大小按作品体量和审阅需要决定,1–3 集只是长剧的常用起点。

默认 timingMode: off,不使用每秒字数和每动作固定秒数,报告显示“时长待试读/剪辑核实”。没有音轨时可以给模型的暂定预算,但必须说明未验证,不能以此判定必须删词或延长。仅用户明确需要旧公式对照时设 timingMode: legacy-estimate。独立片可以省略 cliff,不虚构下一集悬念。技术通过不代表内容获批或实测时长通过。

交付与反馈

给当前版本、原文定位、关键差异、推荐理由和未解决问题;创作取舍保留用户决定。已有报告可主动打开并给绝对路径,说明看哪里、如何反馈;短稿直接在对话中展示即可。批准针对具体版本与范围,部分接受不等于全稿通过,下载 HTML/JSON 不算批准。只重新审阅实际改变的内容及受影响的依赖。

剧情确认后交导演与分镜适配生成限制,不在编剧层以模型单段时长删除叙事。单独要求剧本时,不自动出图、配音或调用付费生成。

修改工具后运行 node {baseDir}/scripts/selftest.mjs 与 node {baseDir}/scripts/creative-policy-test.mjs。自测验证程序行为,不验证文学质量。

涉及尚未授权的创作取舍时,给用户 2–3 个有具体差异的选项,说明收益、损失与推荐,允许保留原稿或自定义。模型先完成阅读、诊断和短样段,不把准备工作推给用户;已经明确授权的范围直接执行。未经用户选择,不把暂定片长预算升级成删词、删情绪段落的理由。

© suihe1, 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 10 other files (scripts, references, assets) in skills/novel-script of suihe1/short-drama-production.

  • SKILL.md
  • README.en.md
  • README.md
  • assets/report.webp
  • examples/渡口-script.json
  • references/report-style.md
  • references/schema.md
  • references/script-pass.md
  • scripts/creative-policy-test.mjs
  • scripts/novel-script.mjs
  • scripts/selftest.mjs

Open the folder on GitHubat commit dbd3310

Compare with similar skills

Novel Script next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Novel Script compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Novel Script this skillsuihe1/short-drama-production177—~658Automated safety check: NotesApache-2.0
Novel Storyboardeternityspring/shuohao-skills4.2k—~1.8kAutomated safety check: NotesApache-2.0
Short Drama Novel Analyzezenstory-ai/drama-skills2.6k—~1.9kAutomated safety check: PassMIT
Storyboard Managerailabs-393/ai-labs-claude-skills4541 repos~4.6kAutomated safety check: PassMIT
Story To Video WorkflowUtopai-Research/pai-code354—~2kAutomated safety check: PassCustom licence
Pneuma Plotwisepandazki/pneuma-skills162—~8.9kAutomated safety check: PassMIT

Similar skills

  • Novel Storyboard

    eternityspring/shuohao-skills

    给 AI 短剧出分镜:三层结构——段(一次视频生成,≤15 秒)→ 分镜(段内 2–5 秒的剪切,认领剧本节拍) → 分镜图(每切一张关键帧:主分镜图钉 0.00 秒,子分镜图钉各自切点)。

    4.2k GitHub stars~1.8k tokensUpdated 11 days ago
    Media & CreativeAuto-check: notes
  • Short Drama Novel Analyze

    zenstory-ai/drama-skills

    把长篇小说、连载网文或多集散稿拆成可追溯的原著分析:章节索引、改编价值快评、逐章功能提取、剧情单元与节奏聚合、人物与设定归并,最后给出改编价值判定与分集候选,交给 $short-drama-develop 立契约。用户说“导入这本小说”“拆这本书”“分析原著”“这本书能不能改短剧”“先看看值不值得拆”“把长篇拆成分集候选”,或直接给出小说文件路径时使用。只做只读的结构化分析,不写剧本、不建资产、…

    2.6k GitHub stars~1.9k tokensUpdated 5 days ago
    Media & CreativeAuto-check passed
  • Storyboard Manager

    ailabs-393/ai-labs-claude-skills

    Assist writers with story planning, character development, plot structuring, chapter writing, timeline tracking, and consistency checking.

    454 GitHub starsUsed in 1 repo~4.6k tokens
    Media & CreativeAuto-check passed
  • Story To Video Workflow

    Utopai-Research/pai-code

    Orchestrates story, script, screenplay, concept, product promo, and multi-shot idea work into finished video.

    354 GitHub stars~2k tokensUpdated 8 days ago
    Media & CreativeAuto-check passed
  • Pneuma Plotwise

    pandazki/pneuma-skills

    Pneuma Plotwise workspace guidelines. An agent skill from pandazki/pneuma-skills.

    162 GitHub stars~8.9k tokensUpdated 10 days ago
    Writing & ContentAuto-check passed
  • Emotion Performance Director

    kangarooking/director-skills

    A skill your agent uses when the user wants to design, rewrite, refine, or vary emotional acting prompts for live-action AI video characters.

    171 GitHub stars~2.4k tokensUpdated yesterday
    Media & CreativeAuto-check passed

More from suihe1/short-drama-production

  • Novel Art

    suihe1/short-drama-production

    为 AI 短剧设计场景和叙事道具母本、光照与状态变体,产出 art.json、Markdown、评审报告和可选设定图。用于美术设定、场景与道具一致性;不代替导演调度或成片人流设计。

    177 GitHub stars~1.3k tokensUpdated 22 days ago
    Auto-check: notes
  • Novel Characters

    suihe1/short-drama-production

    从故事中整理人物身份、关系、外观和声线设计,产出角色卡、图像提示词与评审报告,可按需生成设定图。用于角色分析、人物画像和角色母本;短剧制作中按已批准大纲与当前批次选角。

    177 GitHub stars~1.8k tokensUpdated 22 days ago
    Auto-check: notes
  • Novel Outline

    suihe1/short-drama-production

    把小说或故事改编为短剧大纲,确定人物去留、分集因果、剧情重点与资产预算,产出可校验 JSON、Markdown 和评审报告。用于短剧大纲、改编方案和现有大纲诊断;不写完整剧本或镜头方案。

    177 GitHub stars~1.3k tokensUpdated 22 days ago
    Auto-check: notes
  • Novel Storyboard

    suihe1/short-drama-production

    将剧本与导演意图转成生成段、逐镜时间、参考素材计划和可校验分镜报告;使用官方 h3-prompt-writing 编写 H3 提示词,可导出投产包。用于技术分镜、镜头表和分镜修订;生成视频须另有明确任务与成本授权,不负责最终选片或剪辑。

    177 GitHub stars~2.1k tokensUpdated 22 days ago
    Auto-check: notes
  • Short Drama Production

    suihe1/short-drama-production

    统筹 AI 短剧的阶段、依赖、审批、H3 任务、声音资产、粗剪和 QC,并用 production.json 追踪返工;默认支持 16:9。用于整部短剧生产、继续项目、状态检查或上游变更影响分析;单独创作大纲、角色、美术、剧本或分镜时使用对应专业 skill。

    177 GitHub stars~1.1k tokensUpdated 22 days ago
    Auto-check passed
  • Short Drama Director

    suihe1/short-drama-production

    把剧本转成表演、场面调度、镜头覆盖、景别、机位、运镜与剪辑意图,产出可校验导演镜头包。用于导演方案、拍法、镜头诊断和分镜重构;只要求大纲、剧本或资产设定时不触发。

    177 GitHub stars~1.2k tokensUpdated 22 days ago
    Auto-check passed

Works with

Questions about Novel Script

What does Novel Script do?

将分集大纲写成结构化场次、动作节拍和逐句台词,核对人物与美术引用、估算时长并交付剧本评审报告。用于写剧本、对白和场次修订;不分镜、不直接执行配音或视频生成。. Novel Script is an agent skill from suihe1/short-drama-production.

When should I use Novel Script?

Novel Script fits situations like: tasks that involve Creative writing and fiction.

How do I install Novel Script in Claude Code?

Run `npx skills add suihe1/short-drama-production --skill novel-script -a claude-code`. Or copy the skill folder (skills/novel-script in suihe1/short-drama-production) into .claude/skills/novel-script in your project. Claude Code loads it when a task matches its description.

How do I install Novel Script in Codex?

Run `npx skills add suihe1/short-drama-production --skill novel-script -a codex`. Or copy the skill folder (skills/novel-script in suihe1/short-drama-production) into .agents/skills/novel-script in your project. Codex loads it when a task matches its description.

Can I use Novel Script in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add suihe1/short-drama-production --skill novel-script -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/novel-script, .gemini/skills/novel-script, .github/skills/novel-script and .opencode/skills/novel-script in your project.

What does Novel Script need to run?

Going by SKILL.md and its folder, Novel Script needs JavaScript for the scripts in its folder and the command-line tools its instructions call (node). Our summary lists: Node.js. Its frontmatter pre-approves these tools: Read, Write, Bash, Task, Glob.

Does Novel Script access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Novel Script safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Novel Script use?

Novel Script is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Novel Script use?

About 658 tokens (SKILL.md is roughly 2.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2k tokens, read only when the agent opens those files.

What are the alternatives to Novel Script?

Skills that share tags, products or a category with Novel Script: Novel Storyboard (eternityspring/shuohao-skills, 4.2k stars), Short Drama Novel Analyze (zenstory-ai/drama-skills, 2.6k stars), Storyboard Manager (ailabs-393/ai-labs-claude-skills, 454 stars) and Story To Video Workflow (Utopai-Research/pai-code, 354 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Novel Script?

suihe1 (a GitHub user) maintains it in suihe1/short-drama-production, which has 177 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on September 16, 2026.

Source: suihe1/short-drama-production on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.