Skip to content
Back to search

shuohao-skills

AI 短剧制作的 skill 集合:拆角色、排大纲、出场景与道具设定、写剧本、切分镜 | Agent skills for AI short-drama production — character bibles, adaptation outlines, art bibles, screenplays, storyboards. Runs in Claude Code & codex.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/eternityspring--shuohao-skills/badge.svg)](/listings/eternityspring--shuohao-skills)

HTML

<a href="/listings/eternityspring--shuohao-skills"><img src="/api/listings/eternityspring--shuohao-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 229 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. # shuohao-skills
  3. **Agent-agnostic skills for AI short-drama production**
  4. English | [中文](README.zh.md) | [X @eternityspring](https://x.com/eternityspring)
  5. **[Skills](#skills) · [Install](#install) · [Requirements](#requirements) · [Repository conventions](#repository-conventions)**
  6. </div>
  7. > 👋 **Open to work / collaboration** — I'm between jobs right now, and this repo is what I build in that spare time.
  8. > Happy to hear from anyone this resonates with. Besides **remote work**, I'm also open to a **half-collaboration**: a few thousand RMB a month for living costs plus a profit share. On-site trips are possible where the work genuinely needs them. What I'm really after is finding people on the same wavelength to build something in this AI wave.
  9. > Email: **[eternityspring@gmail.com](mailto:eternityspring@gmail.com)** · Résumé: **[resume.79px.com](https://resume.79px.com)** · WeChat **`hao_dev`** (please mention `github` when you add me)
  10. >
  11. > These skills are free and open source, built and battle-tested on real AI short-drama production.
  12. > If they save you an afternoon, consider [**buying me a coffee on Ko-fi**](https://ko-fi.com/eternityspring) ☕ — it keeps the updates coming.
  13. ## ❤️ Sponsor
  14. > [Want to appear here?](mailto:eternityspring@gmail.com)
  15. <details open>
  16. <summary>Click to collapse</summary>
  17. <table>
  18. <tr>
  19. <td width="180"><a href="https://go.apimart.ai/tw-shuohao-skills"><img src="assets/apimart-logo.png" alt="APIMart" width="150"></a></td>
  20. <td>Thanks to <a href="https://go.apimart.ai/tw-shuohao-skills">APIMart</a> for sponsoring this project! APIMart is a low-cost API platform for AI image & video generation — GPT-Image-2 from $0.006/image, 160+ images per dollar. One async API covers both image and video: submit a task, get an ID, fetch results via polling or callback. Batch tens of thousands of images without timeouts, switch models without changing code. Pay-as-you-go with no monthly fee — <a href="https://go.apimart.ai/tw-shuohao-skills">sign up here</a> to get started.</td>
  21. </tr>
  22. <tr>
  23. <td width="180"><a href="https://studio.reelbenchai.com"><img src="assets/reelbench-first-screen-en.png" alt="Reelbench Studio" width="150"></a></td>
  24. <td><a href="https://studio.reelbenchai.com">Reelbench Studio</a> is a paid AI video workspace built by the author of these skills, delivered as source code that runs offline. Local Codex handles understanding, breakdown and orchestration, a self-hosted ComfyUI generates the images and video, and your assets and projects stay on your own machine.</td>
  25. </tr>
  26. <tr>
  27. <td width="180"><img src="assets/reelref-miniapp-qr.png" alt="赛博班底 mini program code" width="150"></td>
  28. <td>赛博班底 is a WeChat mini program built by the author of these skills: reference images for AI short video, covering characters, costumes, expressions and more, filterable by category and tag. Every image comes with a Chinese prompt you can copy in one tap, and you can long-press the full-size image to save it. Scan the code on the left in WeChat to open it.</td>
  29. </tr>
  30. </table>
  31. </details>
  32. ## Skills
  33. **Agent-agnostic skills for AI short-drama production** — from a novel to shoot-ready material: character bibles, adaptation outlines, scene & prop bibles, screenplays, opening staging, and storyboards. Each skill is self-contained and works with any Agent that can read `SKILL.md` and run the bundled scripts; Claude Code and Codex are two supported examples, not requirements.
  34. The repository now contains **seven skills: six production stages plus standalone character reference generation**. The outline settles the adaptation; characters, art, and screenplay iterate together; staging fixes each scene's opening positions before storyboarding.
  35. ```mermaid
  36. flowchart TD
  37. novel[Source novel] --> outline[novel-outline]
  38. outline --> characters[novel-characters]
  39. outline --> art[novel-art]
  40. outline --> script[novel-script]
  41. characters <--> art
  42. art <--> script
  43. script <--> characters
  44. characters -. Character designs .-> refs[character-refs]
  45. art --> staging[novel-staging]
  46. script --> staging
  47. staging -->|Copy opening blocking| storyboard[novel-storyboard]
  48. refs -. Reference images .-> storyboard
  49. storyboard --> production[Video production packs]
  50. ```
  51. | Skill | What it does |
  52. | --- | --- |
  53. | [**novel-outline**](skills/novel-outline/README.en.md) | Adapts a novel into a five-piece short-drama outline: adaptation notes, cast, beats, per-episode synopses, asset list (including a narrative-prop table). All 14 quality gates are script-checked; includes a checkup mode for existing outlines |
  54. | [**novel-characters**](skills/novel-characters/README.en.md) | Turns the cast the outline settled on into a character bible: profiles, design prompts, voice prompts, model sheets. Seeds the roster from outline.json; report language is configurable |
  55. | [**character-refs**](skills/character-refs/README.en.md) | **Actually generates** reference images for characters from any story (not just novels — your own original story works too): describe a character in one message; it is split into fields, gaps filled and confirmed, then a front full-body anchor is generated and every other view (headshot, 90° profile, back, details) references only that anchor, in on-demand tiers. Every image is labeled and individually regenerable, with staleness tracked. Works with Qwen Image (ComfyUI), codex image generation, the GPT Image 2 API, or a custom command |
  56. | [**novel-art**](skills/novel-art/README.en.md) | Art bibles for AI production (scenes + narrative props): consistency anchors, lighting & state variants, scale references, no-people/no-hands white plates. Seeds from outline.json; all 10 quality gates script-checked |
  57. | [**novel-script**](skills/novel-script/README.en.md) | Screenwriting for AI short drama: scenes + beat flow (action beats alternating with dialogue lines), per-episode duration deterministically estimated from reading speed, a gated cold-open hook in the first 3 beats, a per-character line book with voice prompts that feeds straight into TTS. All 10 quality gates script-checked |
  58. | [**novel-staging**](skills/novel-staging/README.en.md) | Plans opening positions from the screenplay and scene images: each character’s seat or standing position, facing direction, opening presence, and extras. Produces staging.json, an editable top-view report, and opening blocking sentences for the storyboard. All 8 quality gates script-checked |
  59. | [**novel-storyboard**](skills/novel-storyboard/README.en.md) | Storyboarding for AI short drama: segments (one generation, ≤15s) → cuts (2–5s hard gate) → keyframes (master pinned at 0.00s, sub-frames at their cut marks), with MiniMax H3 prompt alignment and cut times audited verbatim; frames actually generated with the design sheets as references, plus one-command H3 / Seedance production packs. All 18 quality gates script-checked |
  60. **All six pipeline skills render their reports in English too** — reports default to a Chinese UI; pass `--lang en` to `render` for a fully English report (data content stays as authored). character-refs ships Chinese, English and Japanese UIs too, and translates on the spot for other languages.
  61. ## Scene Staging: inputs, outputs, and handoff
  62. `novel-staging` runs after the screenplay and before the storyboard. It reads `script.json` for scenes and cast; `art.json` supplies locations, `outline.json` supplies character names, and scene images show the objects people can stand beside or sit on. The screenplay is required; the other inputs improve the result. Without scene images, positions inferred from the art specification are marked provisional. These files can come from any producer; no other skill installation is required.
  63. | Output | What it provides |
  64. | --- | --- |
  65. | `staging.json` | Opening presence, anchor object, side, position, posture, facing, and extras for every scene |
  66. | `staging.md` (optional) | Text export with inventories, position tables, and opening blocking sentences |
  67. | **`staging-report.html` (default)** | Interactive tool report with a draggable top view and live checks; export edits back to JSON |
  68. | `blocking` command output | One opening blocking sentence per scene, ready to copy into its first storyboard segment |
  69. An Agent reads the scene images and plans the staging; the bundled Node.js tools seed the data, check the eight gates, render reports, and generate the blocking sentences. The HTML tool report is the default user-facing result and opens locally in a browser. JSON is working data; Markdown is generated only on request. To try the completed sample from the repository root:
  70. ```bash
  71. node skills/novel-staging/scripts/novel-staging.mjs validate skills/novel-staging/examples/渡口-staging.json --script skills/novel-staging/references/test-fixtures/upstream/渡口-script.json --art skills/novel-staging/references/test-fixtures/upstream/渡口-art.json
  72. node skills/novel-staging/scripts/novel-staging.mjs render skills/novel-staging/examples/渡口-staging.json --lang en > staging-report.html
  73. node skills/novel-staging/scripts/novel-staging.mjs blocking skills/novel-staging/examples/渡口-staging.json --lang en
  74. ```
  75. **The storyboard does not automatically import `staging.json` yet.** Give the Agent the accepted opening blocking sentences and ask it to copy each one into the first segment of its scene. This stage outputs staging data and reports; it does not generate images or video. See the [skill guide](skills/novel-staging/README.en.md) for authoring a new staging plan.
  76. ## One page for five stage reports
  77. The assembler currently supports **outline, characters, art, screenplay, and storyboard**. It does not include the staging report or character-refs gallery. These five supported reports can be merged into a single page with a left-hand nav — **you get a pane for every supported stage you actually have**:
  78. ```bash
  79. node scripts/report.mjs --from <demo-dir> --out report.html
  80. ```
  81. `--from` discovers the five json files using the [working-directory convention](#repository-conventions); you can also point at each one directly (`--outline` `--cast` `--art` `--script` `--storyboard`). Ran only the character pass? You get one pane, no error.
  82. It is an **assembler, not a separate skill**: it imports no skill code, it shells out to each skill's own `render --html` and stitches the results. So the five skills stay untouched, still run standalone, and are still copyable on their own — and when a skill changes its rendering, this picks it up for free.
  83. Merging solves three problems, **all of them inside the assembler, none inside the skills**:
  84. - **Style bleed.** The five reports share 57 class names, 13 of which mean different things in different reports (`.copy`, `.kpis`, `.badge`, `.chip`…), so every selector gets a scope prefix
  85. - **Script bleed.** Each report's script does document-wide lookups like `document.querySelector('.expo')`. Merged, that only ever finds the first one — all five export buttons would break. Each script gets wrapped in a scoping proxy
  86. - **Asset paths.** Each report's images are relative to its own json directory (`images/…`, `E01-01/f1.png`) and get rebased against the output file
  87. One pane shows at a time by default (the five together run to roughly 600k characters). "Show all" in the bottom-left expands every pane so Cmd+F reaches the whole document. Number keys `1`–`5` switch panes, and `#pane-script` deep-links straight to one.
  88. ```bash
  89. node scripts/report-selftest.mjs # 92 assertions, no browser needed
  90. ```
  91. Reports from the six production stages:
  92. **novel-outline · short-drama adaptation outline**
  93. ![Adaptation outline report](skills/novel-outline/assets/report.webp)
  94. **novel-characters · character bible**
  95. ![Character bible report](skills/novel-characters/assets/report.webp)
  96. **novel-art · art bible (scenes + props, sheets actually generated by the skill)**
  97. ![Art bible report](skills/novel-art/assets/report.webp)
  98. **novel-script · screenplay (duration gauge + episode scripts + line book)**
  99. ![Screenplay report](skills/novel-script/assets/report.webp)
  100. **novel-staging · opening staging (a top view you drag people on, then export)**
  101. ![Staging report with English UI](skills/novel-staging/assets/report-en.jpg)
  102. **novel-storyboard · storyboard (cut rhythm strip + master/sub keyframes actually generated by the skill + H3 prompts)**
  103. ![Storyboard report](skills/novel-storyboard/assets/report.webp)
  104. No novel needed for this one — real reference images for any character:
  105. **character-refs · character references (anchor by GPT, the rest by Qwen, all actually generated by the skill)**
  106. ![Character references report](skills/character-refs/assets/report.webp)
  107. ## Install
  108. ```bash
  109. git clone https://github.com/eternityspring/shuohao-skills.git
  110. cd shuohao-skills
  111. ./scripts/install.sh
  112. ```
  113. The installer currently detects Claude Code and Codex and **symlinks** every skill into place — so `git pull` takes effect immediately, with no reinstall. The skills themselves are not tied to either runtime. For any other Agent, copy or symlink the skill directory into its skills directory, or load its `SKILL.md` directly.
  114. ```bash
  115. ./scripts/install.sh novel-characters # just one skill
  116. ./scripts/install.sh --codex # only into codex
  117. ./scripts/install.sh --uninstall # remove the symlinks
  118. ```
  119. Prefer to do it by hand:
  120. ```bash
  121. AGENT_SKILLS_DIR=/path/to/your-agent/skills
  122. ln -s "$PWD/skills/novel-characters" "$AGENT_SKILLS_DIR/novel-characters"
  123. ln -s "$PWD/skills/novel-characters" ~/.claude/skills/novel-characters
  124. ln -s "$PWD/skills/novel-characters" ~/.codex/skills/novel-characters
  125. ```
  126. ## Requirements
  127. | | Required? | Notes |
  128. | --- | --- | --- |
  129. | **Node** | Yes | ≥ 18. The skill scripts use only the standard library — **no npm dependencies, nothing to install** |
  130. | **Model quota** | Yes | Uses your current session's quota. **No API key needed** |
  131. | **Agent runtime** | Yes | Any Agent that can read `SKILL.md` and run the bundled Node.js scripts. Claude Code and Codex are supported examples |
  132. | **Image model** | Only for character-refs | One of: your own ComfyUI (Qwen Image), local codex image generation (uses your ChatGPT plan quota), an OpenAI API key (GPT Image 2), or a custom command. Chosen on first use |
  133. > **Note on output language.** These skills are Chinese-first. `novel-characters` produces Chinese character profiles even for an English source novel, and its validator actively rejects English in those fields. See that skill's README for what it would take to change.
  134. ## Repository conventions
  135. One directory per skill, **self-contained and copyable on its own**:
  136. ```
  137. skills/<skill-name>/
  138. ├── SKILL.md the workflow the agent reads (required)
  139. ├── README.md the docs a human reads
  140. ├── scripts/
  141. │ ├── <name>.mjs deterministic helpers, zero dependencies
  142. │ └── selftest.mjs self-test, never calls a model (required)
  143. ├── references/ detailed instructions, loaded on demand
  144. ├── examples/ bundled samples that double as test fixtures
  145. └── assets/ screenshots
  146. ```
  147. Two hard requirements:
  148. - Every skill must have a `SKILL.md`
  149. - Every skill must have a `scripts/selftest.mjs` that **calls no model and costs no quota**, covering all deterministic logic
  150. Run every self-test before adding a skill:
  151. ```bash
  152. for f in skills/*/scripts/selftest.mjs; do node "$f"; done
  153. ```
  154. There is no CI — the self-tests run in about a second, so running them locally beats waiting on a pipeline. **Only tested on macOS with Node 24**; there is no platform-specific code, so Linux and older Node releases should be fine, but that is unverified.
  155. ## Star history
  156. [![Star History Chart](https://api.star-history.com/svg?repos=eternityspring/shuohao-skills&type=Date)](https://star-history.com/#eternityspring/shuohao-skills&Date)
  157. ## License
  158. [Apache 2.0](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.