shuohao-skills is a collection of agent skills for turning a novel into production materials for an AI short-drama pipeline, including character profiles, outlines, art references, scripts, and storyboards. It is for creators using Claude Code or Codex to plan and prepare AI-generated short videos. The catalogue add-ons implement the separate stages of this workflow and can also assemble their reports.
Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add eternityspring/shuohao-skills --skill novel-charactersgit clone --depth 1 https://github.com/eternityspring/shuohao-skillsWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/eternityspring/shuohao-skills/novel-characters)<a href="https://agentmods.dev/skills/eternityspring/shuohao-skills/novel-characters"><img src="https://agentmods.dev/badge/skills/eternityspring/shuohao-skills/novel-characters/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/eternityspring/shuohao-skills/novel-characters"><img src="https://agentmods.dev/badge/skills/eternityspring/shuohao-skills/novel-characters.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector pass
What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00161 | $0.04011 |
| Opus 5 | $0.00081 | $0.02005 |
| Sonnet 5 | $0.00032 | $0.00802 |
| Haiku 4.5 | $0.00016 | $0.00401 |
Grade A, and why
novel-characters scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 11d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 275 lines — stays where its author put it; the contents beside it link to each section on GitHub.
novel-characters
输入一篇小说/短故事，输出每个角色的：人物画像、形象提示词、音色提示词、角色设定图。
{baseDir} = 本文件所在目录。脚本 {baseDir}/scripts/novel-characters.mjs，零依赖，node 直接跑。
运行环境：Claude Code 和 codex 都能跑。差别只在第 8 步出图——见 references/sheet.md。
Step 0 — 确定报告语言
用户可以指定语言，比如「用英文」「--lang en」「日本語で」。没说就是中文（zh）。
这个 lang 会一路传下去：第二趟生成角色卡时决定人类可读字段用什么语言，validate 和 render 也都要带上。
界面文案分两种情况：
-
zh/en/ja—— 内置，不用管 -
其他任何语言 —— 你要现场翻一份。跑
node {baseDir}/scripts/novel-characters.mjs ui-template <lang>它打印一份英文骨架，把每个值翻译成目标语言，整块放进
cast.json顶层的ui字段。渲染时会合并进内置表。不给
ui的话validate会直接报错——否则报告会是「角色内容是法语、界面标签是英文」的半吊子状态。
支持的语言不受内置表限制，法语韩语西班牙语都能出完整报告。
Step 0.5 — 确定画风
用户可以指定出图风格：默认 realistic（半写实厚涂），想要动画质感就用 ghibli（吉卜力式手绘赛璐璐）。
node {baseDir}/scripts/novel-characters.mjs styles # 打印预设的完整内容
读 {baseDir}/references/style-presets.md。换风格是整套换——每个预设自带 render / surface / lighting / negative / tags 五块，整块取用，不要混搭。
最容易搞反的是反向提示词：realistic 绝不能禁 photorealistic，ghibli 必须禁。validate 会拦这个。
版面规则（16:9 三区、比例、细节让位）不随风格变，变的只有渲染质感。
Step 1 — 定位输入
用户给文件路径就直接用。直接粘正文的，先落到一个临时 .txt——后面校验「引文是否逐字」要拿原文比对，没有原文文件这步就没法做。
确定输出目录：用户指定就用；没指定就用原书同级目录。
有 outline.json（novel-outline 的产出）就一起要过来，走 seed——大纲是角色设定的上游，它的 characters 块已经定死了角色清单：
node {baseDir}/scripts/novel-characters.mjs seed <outline.json> > <workdir>/seed.json
搬过来的是大纲已经拍板的事实，留空的是这一层才该做的设计：
| outline 的字段 | seed 之后 |
|---|---|
id |
原样保留成角色码——下游 script / storyboard 用它引用角色 |
name |
角色表就照这份，不再自己判断谁该进 |
tier |
映射成 importance：lead → protagonist、support → supporting、functional → minor |
arc |
直接落进 persona.arc |
role / from |
进 seedNote——定位（女主 / 反派）与「由原著的谁合并而来」，扫原文时知道该收哪几条线的戏 |
留空待填：aliases（要读原文才知道）、oneLiner、persona 其余各项、image、voice。seed 出来的是骨架不是成品，直接跑 validate 会报一堆字段缺失，那是预期的——后面 Step 2–6 就是来填它的。
两处口径要守住：
- 大纲定的分档不要推翻。谁重要是改编阶段拍板的事，这一层只负责把定下来的人做深。真觉得分档不对，回去改大纲，别在这里悄悄改一个不一样的
- 主角组内部可以细分。outline 的
lead是「男女主 + 主反派」一整组，对应protagonist与major两档，seed 一律给protagonist；照seedNote里的定位把主角之外的改成major，这不算推翻分档
What ships with it
15 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
- assets/report.webp 126 KB
- assets/sheet.jpg 165 KB
- examples/渡口-cast.json 43 KB
- examples/渡口-cast.md 43 KB
- examples/渡口.txt 2.3 KB
- README.en.md 12 KB
- README.md 11 KB
- references/profile-pass.md 12 KB
- references/report-style.md 8.6 KB
- references/roster-pass.md 1.5 KB
- references/schema.md 5.6 KB
- references/sheet.md 8.6 KB
- references/style-presets.md 2.0 KB
- scripts/novel-characters.mjs 90 KB runs code
- scripts/selftest.mjs 43 KB runs code
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 11d ago First seen · 275 lines · 161 tokens per session scan A 4ea2fbbdfa31
novel-characters is a skill published in the GitHub repository eternityspring/shuohao-skills (3,181 stars, last pushed 15d ago), licensed Apache-2.0. It adds 161 tokens to every session and 4,011 once invoked, about $0.0008 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
webgl-holographic-foil
A self-contained WebGL2 hero: thin-film interference over a crushed-foil surface whose palette shifts with the viewing angle; move the cursor to tilt the film.
general-video
Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated…
html-ppt-hermes-cyber-terminal
OpenDesign + BYOK: choosing and wiring your own model, hands-on — cost, quality, and the routing decision. Built as a decision-grade AI literacy deck for engineers, IT, applied-AI teams.
html-ppt-taste-brutalist
16:9 HTML deck in tactical-telemetry / CRT-terminal taste. Deactivated-CRT charcoal slides, white-phosphor monospace, hazard-red accent, scanline overlay, ASCII syntax, density over decoration. Distilled from Leonxlnx/taste-skill brutalist-skill (Tactical Telemetry mode).
chengfeng-check-updates
An environment manager for a video-editing system. It checks whether its skills and runtime—the software needed to run them—are installed and compatible.
diagnostic-stem-delivery
Audio production with diagnostic analysis, timecode parsing from documents, and verified export workflow.