shuohao-skills README

The project's README from github.com/eternityspring/shuohao-skills. As one markdown file: README.md.

中文 English 关注作者 X

🎬 AI视频工作台

ReelBench AI短剧工作台首屏

shuohao-skills

AI 短剧制作的 skill 集合:从一本小说到直接喂生成管线的制作素材——拆角色、排大纲、出场景与道具设定、写剧本、切分镜。给 AI 编码 agent 用,Claude Code 和 codex 都能跑。

整条管线长这样——改编大纲收敛结构,剧本、场景、角色三者同步迭代,分镜只做输出不做新决定:

AI 短剧制作流程图
Skill 做什么
novel-outline 把一本小说改编成短剧大纲五件套:改编说明、人物表、爽点表、分集梗概、资产清单(含叙事道具表)。14 道质量门全部脚本检查,支持已有大纲的体检模式
novel-characters 把大纲定下的角色做成角色设定集:人物画像、形象提示词、音色提示词、角色设定图。吃 outline.json 预填角色表,报告语言可选
character-refs 给任何故事里的角色真出参考图(不限小说,自己原创的故事也行):一段话描述角色,拆字段、补全、确认后先出正面全身锚点,大头照、90° 侧面、背面、细节图都只参考这张锚点,按需分档。每张图带标识、可单独重出,过期自动标出。支持 Qwen Image(ComfyUI)、codex 出图、GPT Image 2 API、自定义命令
novel-art 给 AI 短剧出美术设定集(场景 + 叙事道具):一致性锚点、光照与状态变体、尺度参照、无人无手白底提示词。吃 outline.json 预填清单,10 道质量门全部脚本检查
novel-script 给 AI 短剧写剧本:场次 + 节拍流(动作与台词交替),逐集时长按语速确定性折算,钩子前 3 拍冷开场兑现是门,台词本按角色聚合带音色提示词直接对接 TTS。10 道质量门全部脚本检查
novel-storyboard 给 AI 短剧出分镜:段(一次生成 ≤15 秒)→ 分镜(2–5 秒硬门)→ 分镜图(主图钉 0.00 秒、子图钉各自切点),MiniMax H3 提示词的对齐指令与切点时刻逐字对账;分镜图拿设定图当参考图真出图,export 一键出 H3 / Seedance 投产包。18 道质量门全部脚本检查

五段管线 skill 的报告都支持中英双语界面:默认中文,render --lang en 出全英文报告(数据内容保持原文)。character-refs 的报告同样内置中英日界面,其他语言现场翻译。

AI 短剧交流社群

我建了一个付费AI视频交流群,讨论 AI 视频的工作流、工具和实操。交流群 ReelBench AI 视频工作台是两项独立服务。

有兴趣的加我:微信 hao_dev,添加时备注 github。

烁皓微信二维码

合成一张单页

五段的报告可以合成一张单页,左侧导航切换——有哪几段就出哪几个面板:

node scripts/report.mjs --from <demo目录> --out report.html

--from 按下面的工作目录约定自动发现五份 json;也可以逐个指定(--outline --cast --art --script --storyboard)。只跑了角色那一段就只有一个面板,不报错。

它是组装器,不是独立 skill:不 import 任何 skill 的代码,而是调各自的 render --html 拿产物再拼装。所以五个 skill 一行不改、各自仍然独立可跑、可以单独拷走;某个 skill 改了渲染,这边自动跟上。

合并时处理三件事——这三件都在组装器里做,不侵入 skill:

默认一次显示一个面板(五份加起来将近六十万字符)。左下角「平铺全部」把所有面板同时展开,Cmd+F 恢复全局搜索。数字键 1–5 切面板,#pane-script 这样的深链可以直接分享到某一屏。

node scripts/report-selftest.mjs   # 92 项断言,不起浏览器

丢一本小说进去,出这五套:

novel-outline · 短剧改编大纲

短剧改编大纲报告

novel-characters · 角色设定集

角色设定集报告

novel-art · 美术设定集(场景 + 道具,设定图为 skill 实际生成)

美术设定集报告

novel-script · 剧本(时长仪表 + 分集剧本 + 台词本)

剧本报告

novel-storyboard · 分镜(分镜节奏带 + 主/子分镜图为 skill 实际生成 + H3 提示词)

分镜报告

不从小说出发也行,给任何一个角色真出参考图:

character-refs · 角色参考图(锚点 GPT 出、其余 Qwen 出,全部为 skill 实际生成)

角色参考图报告

安装

git clone https://github.com/eternityspring/shuohao-skills.git
cd shuohao-skills
./scripts/install.sh

自动检测本机装了 Claude Code 还是 codex,把所有 skill 软链过去——git pull 之后立刻生效,不用重装。

./scripts/install.sh novel-characters   # 只装某一个
./scripts/install.sh --codex            # 只装到 codex
./scripts/install.sh --uninstall        # 取消软链

不想用脚本就自己链:

ln -s "$PWD/skills/novel-characters" ~/.claude/skills/novel-characters
ln -s "$PWD/skills/novel-characters" ~/.codex/skills/novel-characters

前置条件

必需? 说明
Node 必需 ≥ 18。skill 的脚本只用标准库,没有 npm 依赖,不需要 install
模型额度 必需 用你当前会话的额度,不需要任何 API key
codex CLI 可选 只是一个能跑这些 skill 的运行环境,跟 Claude Code 等价。五段管线 skill 不出图,不需要它的任何本机能力
出图模型 只有 character-refs 需要 四选一:自己的 ComfyUI(Qwen Image)、本机 codex 内置出图(吃 ChatGPT 订阅额度)、OpenAI API key(GPT Image 2)、自定义命令。第一次使用时选

仓库约定

每个 skill 一个目录,自包含、可以单独拷走:

skills/<skill-name>/
├── SKILL.md          给 agent 读的工作流(必需)
├── README.md         给人读的说明
├── scripts/
│   ├── <name>.mjs    确定性工具,零依赖
│   └── selftest.mjs  自测,不调模型(必需)
├── references/       按需加载的详细指令
├── examples/         自带样例,同时当测试夹具
└── assets/           截图

两条硬要求:

加新 skill 之前,先把全部自测跑一遍:

for f in skills/*/scripts/selftest.mjs; do node "$f"; done

没有配 CI——自测足够快(1 秒),本地跑一次比等 CI 更省事。只在 macOS + Node 24 上验过;代码没有平台相关调用,Linux 和更低版本 Node 理论上没问题,但没验。

端到端 demo 工作目录约定

把一本小说从头跑完五段(角色 → 大纲 → 美术 → 剧本 → 分镜),会产出大量 *.json / *.md / *-report.html。不要平铺在根目录,按五个 skill 各建一个目录归档,一眼对应流水线五段:

<demo>/
├── outline/       ← novel-outline 产出:<剧>-outline.json / .md / -report.html
├── characters/    ← novel-characters 产出:<剧>-cast.json / .md / -report.html
├── art/           ← novel-art 产出:<剧>-art.json / .md / -report.html
├── script/        ← novel-script 产出:<剧>-script.json / .md / -report.html
├── storyboard/    ← novel-storyboard 产出:<剧>-storyboard.json / .md / -report.html
│   ├── manifest.json  ← export 产出
│   ├── E01-01/        ← export 的分镜投产包,每段一个文件夹(prompt.md + f1..fN.png)
│   ├── E01-02/
│   └── …
├── docs/          ← 自己写的使用说明、PR 草稿等(与机器产物解耦)
└── scripts/       ← 跑管线的辅助脚本(探索期脚本用 _ 前缀保留溯源)

约定要点:

这套结构来自《渡口》端到端 demo 的实际归档经验,demo 的工作目录在本仓库之外,这里只固化约定。

Star 趋势

Star 趋势曲线

License

Apache 2.0

shuohao-skills (eternityspring/shuohao-skills)

short-drama
Searching Database…

What is this?A collection of agent skills for producing AI short dramas from a novel: it breaks the novel into characters, builds an adaptation outline, generates art/prop bibles, writes the screenplay, and cuts the storyboard. It runs inside Claude Code or codex as a coding agent.
Is this one app or a bunch of separate skills I pick from?It is a set of independent skill folders (novel-outline, novel-characters, character-refs, novel-art, novel-script, novel-storyboard); each is self-contained with its own SKILL.md and can be copied out and run on its own, or chained into the full five-stage pipeline.
How do I install it into my agent?Run the install script: it auto-detects whether you have Claude Code or codex set up and symlinks every skill into place, so a later 'git pull' takes effect immediately without reinstalling. You can also symlink skills manually if you prefer.
What do I need besides Claude Code or codex?Node.js 18 or newer — the skill scripts use only the standard library, so there is no npm install. For the five pipeline skills you just use your existing model session quota, no separate API key needed.
Does image generation need extra setup?Only the character-refs skill needs it, and you pick one of four options the first time you use it: your own ComfyUI with Qwen Image, codex's built-in image generation (uses your ChatGPT subscription quota), an OpenAI API key for GPT Image 2, or a custom command.
Does it work on Linux and Windows too, or just macOS?It has only been verified on macOS with Node 24. The author notes the code makes no OS-specific calls so Linux should theoretically work fine, but it is unverified; Windows isn't mentioned at all.
What does each of the five pipeline skills actually produce?novel-outline makes an adaptation outline (cast list, hook list, episode synopses, asset list); novel-characters builds a character bible with portraits and voice prompts; novel-art makes a scene/prop art bible; novel-script writes the full screenplay with a timing gauge; novel-storyboard cuts it into shots with H3 prompts and exports production packages.
Can I generate reference images for a character outside of a novel pipeline?Yes, the character-refs skill is standalone: describe a character in a sentence, confirm the parsed fields, and it generates a front-facing anchor image plus headshot, 90-degree profile, back view, and detail shots all keyed to that anchor.
Can I view all five reports together instead of five separate HTML files?Yes, a separate assembler script merges the five reports into one page with left-side navigation; it doesn't import any skill's code, it just calls each skill's render --html and stitches the output, scoping CSS/JS so the five reports don't collide.
Are the generated reports only in Chinese?Reports default to Chinese, but running render --lang en produces a full English report (the underlying data stays as-is); character-refs additionally supports a Japanese report UI.
Size
14.2 MB
Stars
4.7K
Updated
CommitOct 15
Age
2mo
Commits · 90 Days