Novel Script logo

Novel Script

Community
suihe1
novel-script

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

Overview

Publishersuihe1
Repositoryshort-drama-production
Skill namenovel-script
Stars
184
Forks
24
Bundled files
9
LicenseApache-2.0
Links
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • 9 bundled files

    Scripts, templates, and references the model can read while it works. Files are read-only and never executed.

  • Open source

    Published by suihe1 on GitHub. Read the source before you install it.

Installation

Install the Novel Script AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
    https://github.com/suihe1/short-drama-production/tree/main/skills/novel-script
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/suihe1/short-drama-production.git /tmp/short-drama-production
mkdir -p .claude/skills
cp -r /tmp/short-drama-production/skills/novel-script .claude/skills/novel-script
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Novel Script in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Novel Script on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Novel Script is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

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

Bundled files

The model reads these on demand while the skill is loaded. They are exposed as readable files and are never executed.

Frequently asked questions

What does the Novel Script AI skill do?

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

Why use Novel Script on TypingMind?

Because you install it once and use it with any model. Novel Script is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Novel Script in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/suihe1/short-drama-production/tree/main/skills/novel-script. TypingMind reads its SKILL.md and bundles its files and installs it as a skill you can enable per chat.

Which AI models can use Novel Script?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Novel Script?

As many as you like. As long as a model supports skills, you can use Novel Script with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Novel Script AI skill free?

Yes. It is published on GitHub by suihe1 under the Apache-2.0 license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇