Agent skill

Novel Art

by suihe1 in suihe1/short-drama-production

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

Apache-2.0Auto-check: notesMedia & Creative

Install Novel Art

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

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

GitHub CLI
$ gh skill install suihe1/short-drama-production novel-art --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-art .claude/skills/novel-art && 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-art
GitHub stars
181
Token cost
~1.3k tokens
SKILL.md length
221 words
Files
12 (incl. scripts, references, assets)
Skills in repo
7
Repo updated
First seen
Licence
Apache-2.0

At a glance

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

  • Works in 6 steps: 定输入与画风 → seed 骨架(有 outline.json 才有这步) → 逐场景填设定 + 提取叙事道具 → …
  • Tasks that involve Creative writing and fiction
  • SKILL.md covers 输入与创作权限, novel-art, 三个 skill 的接力 and 边界, plus 3 more sections
  • Runs JavaScript scripts from its folder; calls node

What it does

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

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

It sits in Media & Creative, covering Creative writing and fiction and Image generation. 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
  • Tasks that involve Image generation

Example prompts

  • “/novel-art”

Requirements

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

Workflow steps

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

  1. 定输入与画风
  2. seed 骨架(有 outline.json 才有这步)
  3. 逐场景填设定 + 提取叙事道具
  4. 校验 ⛔ 不能跳
  5. 出图(可选)
  6. 输出与汇报

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 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 Art loads about 1.3k tokens when it runs, and up to ~5.9k if it reads all its reference files. Until then it costs about 25 tokens; SKILL.md has 221 words of instructions outside code blocks.

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

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). 221 words, ~1,284 tokens.

Download SKILL.mdSave it as .claude/skills/novel-art/SKILL.md (or your agent's skills folder). This skill also uses 11 other files; get the full folder from GitHub.
name
novel-art
description
为 AI 短剧设计场景和叙事道具母本、光照与状态变体,产出 art.json、Markdown、评审报告和可选设定图。用于美术设定、场景与道具一致性;不代替导演调度或成片人流设计。
allowed-tools
Read, Write, Bash, Task, Glob
metadata.license
Apache-2.0
metadata.runtimes
claude-code, codex
metadata.version
1.1.0
metadata.triggers
novel-art, 美术设定, 场景设定, 场景道具, 出场景, 道具设定, 环境设定, scene bible, prop sheet

输入与创作权限

先读用户实际材料与目标,复用已确定的事实和规格;已有剧本、资产或分镜直接进入相关工作,不为流程完整重写上游。未授权的删线、合人、改变人物身份、主题、结局或重要表演意图,先展示原位置、具体方案与得失,再由用户选择;已授权的局部修正直接完成。

下面的类型经验、批次和创作预算是适配起点,不是用户接受过的创作要求。旧校验器可能仍将部分经验规则报为失败:区分实际数据/引用/模型接口错误与创作建议,说明不适用项,保留原稿;不伪造字段、不静默改戏或降低技术投产要求。总控可用时参考其 references/creative-agreement.md;独立任务按本段处理,不强制依赖总控。

novel-art

给 AI 短剧出美术设定集:场景 + 叙事道具。生成资产仍需做空间、功能与叙事研究。大纲阶段建立概念版,首批剧本拆解后再锁定所需场景、道具与状态;资产同时服务导演调度和跨镜一致性:

交付解决什么
一致性锚点(每景 3–5 个)观众靠它认场景,QC 靠它核对生成镜头有没有漂
光照时段变体AI 换时段是重新生成不是重新打灯,每个状态落成完整提示词
空景出图提示词无人环境母本便于复用;成片的人流、岗位与人物由导演和分镜另行调度
变体机制(variantOf)生成新景便宜,但变体复用母场景资产更一致
道具状态变体皮箱的开合、场景的损坏或陈设变化都可能承载剧情,按实际拍摄范围维护状态
道具尺度参照AI 经常把手持道具画成家具尺寸,提示词必须带尺度短语
道具白底无手道具图要被贴进各种镜头,必须可抠;拿着道具的手是最常见污染

{baseDir} = 本文件所在目录。脚本 {baseDir}/scripts/novel-art.mjs,零依赖,node 直接跑。

边界(不做的事):不做分镜、不写剧本、不管角色(novel-characters 的活)、不排大纲(novel-outline 的活)。道具只收叙事道具(有特写、跨集、承载剧情的,通常 3–8 件)——场景陈设归场景锚点,一次性手部道具镜头级提示词解决,都不单独建资产。


Step 0 — 定输入与画风

三种输入,优先级从高到低:

  1. outline.json(novel-outline 的产出)——最优,场景清单、出现集、承载爽点、复用方案都是现成的
  2. 小说原文——自己归纳场景清单(主舞台优先,参考 novel-outline 的主场景上限思路:别贪多)
  3. 用户手写的场景清单

画风:默认 realistic(半写实厚涂),动画质感用 ghibli。跟角色 skill 保持同一档——角色是吉卜力、场景是半写实,合成的时候没法看。跑 node {baseDir}/scripts/novel-art.mjs styles 看预设全文,整块取用不混搭。

有 cast.json(novel-characters 的产出)也带上——校验「提示词不含角色名」要用。

Step 1 — seed 骨架(有 outline.json 才有这步)
bash
node {baseDir}/scripts/novel-art.mjs seed <outline.json> > <workdir>/art.json

确定性搬运:场景 id/名称/主场景标记/出现集/承载爽点,带复用方案的场景会有 seedNote 提示做成变体。这些事实不要让模型重新想一遍。

没有 outline.json 就自己按 references/schema.md 建清单。

Step 2 — 逐场景填设定 + 提取叙事道具

每个场景一份,能并发就并发。每份任务拿到:

  • {baseDir}/references/scene-pass.md 和 {baseDir}/references/schema.md(读它们,照着做)
  • 该场景的骨架 + 原文/大纲里关于这个空间的全部信息
  • 同批其他场景的名字(空间气质要区分开,别都写成同一种破旧)
  • 画风预设全文(styles 命令的输出)

核心要求都在 scene-pass.md 里,最重的三条:锚点要可画可认可核对(「补丁船篷」是锚点,「陈旧的氛围」是形容词);光照状态从分集反推,不写用不上的全家桶;能做变体就别开新景。

叙事道具从原文/大纲提取(大纲没有现成道具表,这步是模型的活):只收有特写、跨集出现、承载剧情的,通常 3–8 件,跟主角数量一个量级。每件按 references/prop-pass.md 填:戏剧功能、锚点、状态变体、尺度、白底无手提示词。皮箱这种「跟人走的道具」就该在这——塞进场景锚点和角色画像都不对。

Step 3 — 校验 ⛔ 不能跳
bash
node {baseDir}/scripts/novel-art.mjs validate <art.json> --cast <cast.json>

11 道质量门全是代码。场景 + 共用 7 道:锚点 3–5、光照状态 ≥1、无人、提示词全英文、不含角色名(给了 --cast 才查)、变体引用完整、风格与反向词匹配。道具专属 4 道:状态 ≥1、尺度短语写进提示词、反向词禁手、设定图纯白背景。

有违规逐条修,改完重跑,直到通过。

Step 4 — 出图(可选)

场景和道具各一张 16:9 设定图,版面都是主视角大图 + 底部和右侧的 L 形细节边框。场景:标准取景 + 第一个光照状态,细节格是锚点特写。道具:白底三四分之一主视角(主状态),细节格是锚点特写 + 其他状态 + 侧面。读 {baseDir}/references/sheet.md 照调用契约做,要点:

  • 没有 codex 就整步跳过,只交提示词
  • 全图无人;道具图另加无手、纯白背景,出现人影或手就重生成
  • 变体场景拿母场景成图当参考图(-i + stdin)——变体机制的意义就在这
  • 一个场景一次调用绝不批量;单个失败跳过不阻断
Step 5 — 输出与汇报
bash
cd <输出目录>
node {baseDir}/scripts/novel-art.mjs render <剧名>-art.json --md   > <剧名>-art.md
node {baseDir}/scripts/novel-art.mjs render <剧名>-art.json --html > art-report.html

报告界面默认中文;用户要英文界面就加 --lang en(或在 art.json 顶层写 "lang": "en",--lang 优先)。render 自动去 images/<slug>-sheet.png 找图(场景和道具都找),先出图再 render。报告含:KPI 带、场景清单、场景设定卡、道具清单、道具设定卡(锚点核对表 / 状态变体 / 提示词包全带复制按钮)、质量门面板、导出 JSON(下载的就是 art.json 原样)。

汇报一句话说清:几个场景(主场景/变体各几)、几件道具、锚点总数、出图数、报告路径;没过的门和没出的图明说。

最终落地:

<输出目录>/
├── <剧名>-art.json
├── <剧名>-art.md
├── art-report.html                ← 双击就能开
└── images/
    └── <slug>-sheet.png           ← 有 codex 才有

三个 skill 的接力

novel-characters → cast.json    (谁:角色资产)
novel-outline    → outline.json (什么:结构与分集)
novel-art        → art.json     (哪里 + 手里拿的:美术资产)

seed 吃 outline.json(场景部分;道具表大纲里没有,模型从原文提取),--cast 吃 cast.json。三份 JSON 各自的报告都带导出按钮,改完都能喂回各自的 render/validate。

边界

  • 报告界面内置中英(--lang,默认中文、或跟 art.json 的 lang 字段);出图提示词永远英文
  • 画风要跟角色 skill 同档,别一半写实一半动画
  • 出图只走 codex built-in $imagegen,不碰要 API key 的 CLI fallback
  • 场景数量不设硬上限——上限在 novel-outline 的主场景门那里管;这里管的是每个资产的质量
  • 道具只收叙事道具,3–8 件为宜——每多一件就多一份跨集一致性维护

自测

bash
node {baseDir}/scripts/selftest.mjs

144 项断言,不调模型、不花额度。11 道质量门每一道都有击穿用例。改完脚本先跑这个。

自带样例

{baseDir}/examples/渡口-art.json:《渡口》三场景 + 两件叙事道具(旧皮箱、县衙旧砚)的完整设定,全部质量门通过(含对着 novel-characters 样例 cast 的角色名检查)。当质量基准,也是自测夹具。

制作交接

独立使用时,自检后主动打开当前报告并给绝对路径链接,说明本轮范围、检查重点和下一步;需要锁定内容时在对话中收取通过或修改结论。已有确认覆盖当前版本就不重复询问,打开页面或下载 JSON 不算批准。总控已接管时,由总控统一收取这次结论,不另开重复审批。当前内容、依赖或源图改变后,不因旧文件仍存在就跳过复核;输出新版本并保留原审阅笔记。

本项目的阶段职责、变更记录和交付顺序由 short-drama-production 的 references/company-workflow.md 统一维护;未安装总控时按本 skill 的输入和交付范围独立完成,不将总控变成硬依赖。

功能空间先说明必需设备、出入口、可行动区域和运营人流;无人母本保留这些结构与生活痕迹。现有无人质量门检查的是母本素材,不适用于最终画面的人数。场景剧情状态在现有说明/变体字段记录,复杂状态写附属美术说明,不冒充已有结构化状态追踪功能。

涉及尚未授权的创作取舍时,给用户 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 11 other files (scripts, references, assets) in skills/novel-art of suihe1/short-drama-production.

  • SKILL.md
  • README.en.md
  • README.md
  • assets/report.webp
  • examples/渡口-art.json
  • references/prop-pass.md
  • references/report-style.md
  • references/scene-pass.md
  • references/schema.md
  • references/sheet.md
  • scripts/novel-art.mjs
  • scripts/selftest.mjs

Open the folder on GitHubat commit dbd3310

Compare with similar skills

Novel Art 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 Art compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Novel Art this skillsuihe1/short-drama-production181—~1.3kAutomated safety check: NotesApache-2.0
Zy Cinematic Realismpopopo-99/zy-cinematic-realism570—~4.6kAutomated safety check: PassCC-BY-NC-4.0
Web Novel Cover Generatorzenstory-ai/oh-story-claudecode7.4k—~2.9kAutomated safety check: PassMIT
AI Image Generation and Editingzhayujie/CowAgent47k—~1.3kAutomated safety check: PassMIT
Xhs Visual Directorziguishian/xhs-visual-director-skill1.4k—~2.2kAutomated safety check: PassMIT
Character Refseternityspring/shuohao-skills4.3k—~1.7kAutomated safety check: WarnApache-2.0

Similar skills

  • Zy Cinematic Realism

    popopo-99/zy-cinematic-realism

    Develop supplied scripts, short stories, or synopses into scene understanding, director-facing art concepts, and motivated narrative keyframes; compile scene ideas, visual references, or existing…

    570 GitHub stars~4.6k tokensUpdated 7 days ago
    Media & CreativeAuto-check passed
  • Web Novel Cover Generator

    zenstory-ai/oh-story-claudecode

    Generates a finished web novel cover with title and author name from a book title, inferring genre style and sizing the image for the target platform.

    7.4k GitHub stars~2.9k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Generates or edits images from text prompts through a Python script that picks an image backend based on which API keys are configured.

    47k GitHub stars~1.3k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Xhs Visual Director

    ziguishian/xhs-visual-director-skill

    A skill your agent uses when planning, redesigning, or reviewing Xiaohongshu carousel visuals, covers, 3:4 image posts, page-by-page visual direction, image-generation prompts, style selection…

    1.4k GitHub stars~2.2k tokensUpdated 3 mo ago
    Media & CreativeAuto-check passed
  • Character Refs

    eternityspring/shuohao-skills

    给任何故事里的角色真出参考图(小说改编、自己原创的故事、单独设计一个角色都行,不需要小说原文): 一段话描述角色,拆成分层字段、补全后确认, 先出一张正面全身锚点,其余视图(大头照、90° 侧面、背面、细节、45° 大头照)都只参考这张锚点, 按需分档出图。每张图带标识、可单独重出,重出后自动标出哪些图过期。

    4.3k GitHub stars~1.7k tokensUpdated 3 days ago
    Media & CreativeAuto-check: warnings
  • Novel Storyboard

    eternityspring/shuohao-skills

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

    4.3k GitHub stars~1.8k tokensUpdated 3 days ago
    Media & CreativeAuto-check: notes

More from suihe1/short-drama-production

  • Novel Characters

    suihe1/short-drama-production

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

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

    suihe1/short-drama-production

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

    181 GitHub stars~1.3k tokensUpdated 25 days ago
    Auto-check: notes
  • Novel Script

    suihe1/short-drama-production

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

    181 GitHub stars~658 tokensUpdated 25 days ago
    Auto-check: notes
  • Novel Storyboard

    suihe1/short-drama-production

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

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

    suihe1/short-drama-production

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

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

    suihe1/short-drama-production

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

    181 GitHub stars~1.2k tokensUpdated 25 days ago
    Auto-check passed

Works with

Questions about Novel Art

What does Novel Art do?

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

When should I use Novel Art?

Novel Art fits situations like: tasks that involve Creative writing and fiction; tasks that involve Image generation.

How do I install Novel Art in Claude Code?

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

How do I install Novel Art in Codex?

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

Can I use Novel Art 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-art -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-art, .gemini/skills/novel-art, .github/skills/novel-art and .opencode/skills/novel-art in your project.

What does Novel Art need to run?

Going by SKILL.md and its folder, Novel Art 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 Art 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 Art 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 Art use?

Novel Art 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 Art use?

About 1.3k tokens (SKILL.md is roughly 5.1k 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 4.6k tokens, read only when the agent opens those files.

What are the alternatives to Novel Art?

Skills that share tags, products or a category with Novel Art: Zy Cinematic Realism (popopo-99/zy-cinematic-realism, 570 stars), Web Novel Cover Generator (zenstory-ai/oh-story-claudecode, 7.4k stars), AI Image Generation and Editing (zhayujie/CowAgent, 47k stars) and Xhs Visual Director (ziguishian/xhs-visual-director-skill, 1.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Novel Art?

suihe1 (a GitHub user) maintains it in suihe1/short-drama-production, which has 181 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.