Character Refs

给任何故事里的角色真出参考图(小说改编、自己原创的故事、单独设计一个角色都行,不需要小说原文): 一段话描述角色,拆成分层字段、补全后确认, 先出一张正面全身锚点,其余视图(大头照、90° 侧面、背面、细节、45° 大头照)都只参考这张锚点, 按需分档出图。每张图带标识、可单独重出,重出后自动标出哪些图过期。 支持 Qwen Image(ComfyUI)、codex 内置出图、OpenAI Images API(GPT Image 2)和自定义命令,主图与派生图可以使用不同模型。 产出 asset.json + 一组 PNG + 双击就能开的报告。零依赖。 只要提示词、不出图的话使用 novel-characters。 Use when asked to 出角色图、做角色参考图、给我的角色出图、定妆照、真出三视图、character reference images。

6,810 stars 965 forksImages, Video & Audio

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add eternityspring/shuohao-skills --skill character-refs
Manual install
git clone --depth 1 https://github.com/eternityspring/shuohao-skills.git /tmp/shuohao-skills
mkdir -p ~/.claude/skills
cp -r /tmp/shuohao-skills/skills/character-refs ~/.claude/skills/character-refs

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

## character-refs

输入一段角色描述,输出一组角色参考图——**角色从哪来都行**:小说改编、自己编的故事、临时想到的一个人。**一张正面全身锚点,其余每张都只参考这张锚点**。
给视频模型(H3 / Wan / Seedance)当参考图使用,也给人看。

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

**这是仓库里唯一真出图的 skill。**其余 skill 只交提示词,因为出图那一刻才能决定模型和画风;
这个 skill 就是「那一刻」——模型在 Step 0 由用户选定,画风在建角色时选择(默认动漫,另有写实预设,也能挂自定义画风)。

### 核心规则(先读懂再动手)

- **一组图只有一个根:正面全身锚点。**只有它是文生图,其余全是「锚点 + 一句改图指令」。
  头发、脸、领口三类细节额外挂确认过的正脸大头照。图与图之间不再互相参考——
  所以任何一张出坏了,单独重出这一张就行,不会连锁。
- **分档,默认出到第二档**:

  | 档位 | 内容 | 什么时候出 |
  | --- | --- | --- |
  | 1 | 正面全身(锚点) | 总是,第一张 |
  | 2(默认) | 正脸大头照、90° 侧面(面朝画面右侧)、背面 | 默认就出齐 |
  | 3 | 细节图(最多 8 张):用户点名的、角色最能认出来的地方;没有就用默认的头发 / 发饰、领口、袖口、鞋 | 有配饰或服装局部的特写 |
  | 4(默认不出) | 45° 大头照(面朝画面左侧) | 用户明确要 |

  H3 实测:只给正面全身,服装和背影都对,但脸会走样;**加一张大头照,脸最接近**。所以默认出齐第二档。
  只要锚点(比如先看看长相再说):`gen <asset.json> --tier 1`。
- **模型不锁定**:主图与派生图可以使用不同模型,重出单张也可以换模型。一致性来自「同一张锚点」,
  不来自「同一个模型」(实测 Qwen 锚点 + GPT 派生、GPT 锚点 + Qwen 派生、同组混用都衔接得上)。
  每张图记录自己的模型,同组混用只在报告里提醒。
- **冻结的只有三样**:锚点文件(sha256)、画风快照、文字描述指纹。任何一样变了,
  依赖它的图标成「过期」——**只标记,不删除**,旧版本全部留着。

---

### Step 0 — 初次设置(每台机器一次)

```bash
node {baseDir}/scripts/character-refs.mjs config --show
```

输出末尾写「还缺:……」就要问用户这三件事,**一次问完**:

1. **主图(锚点)使用哪个模型**:
   - `qwen` —— Qwen Image 2.1,走自己的 ComfyUI 服务器。快(每张 25–45 秒)、尺寸精确、不吃订阅额度。
     需要 `COMFY_URL`(可选 `COMFY_USER` / `COMFY_PASS`),放环境变量或一个 .env 文件
   - `codex` —— codex 内置出图(GPT)。不要 API key,但**吃 ChatGPT 订阅额度**(Plus 约 25 张会触顶,几小时后恢复),每张 80–160 秒
Read the full skill on GitHub

Details

Skill name
character-refs
Path
skills/character-refs/SKILL.md
License
Apache-2.0
Repo updated
9 November 2026

FAQ

What does the Character Refs skill do?

给任何故事里的角色真出参考图(小说改编、自己原创的故事、单独设计一个角色都行,不需要小说原文): 一段话描述角色,拆成分层字段、补全后确认, 先出一张正面全身锚点,其余视图(大头照、90° 侧面、背面、细节、45° 大头照)都只参考这张锚点, 按需分档出图。每张图带标识、可单独重出,重出后自动标出哪些图过期。 支持 Qwen Image(ComfyUI)、codex 内置出图、OpenAI Images API(GPT Image 2)和自定义命令,主图与派生图可以使用不同模型。 产出 asset.json + 一组 PNG + 双击就能开的报告。零依赖。 只要提示词、不出图的话使用 novel-characters。 Use when asked to 出角色图、做角色参考图、给我的角色出图、定妆照、真出三视图、character reference images。

How do I install the Character Refs skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add eternityspring/shuohao-skills --skill character-refs. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Character Refs popular?

It lives in eternityspring/shuohao-skills, which has 6,810 GitHub stars and 965 forks.

Related skills

Novel Art

6.8k

eternityspring/shuohao-skills

给 AI 短剧出美术设定集(场景 + 叙事道具):场景的设计意图、一致性锚点、光照时段变体、 空景提示词;道具的戏剧功能、状态变体、尺度参照、白底无手提示词。 产出 art.json + Markdown + 单页评审报告(含导出 JSON)。 为 AI 生成而设计,不是实拍——环境和道具都是生成资产,交付的是让它们跨集长一样的一致性方案; 10 道质量门全部由脚本确定性检查(锚点 3–5、无人无手、白底可抠、尺度短语、提示词英文……)。 有 novel-outline 的 outline.json 就用 seed 预填场景清单与出现集。 零依赖、零 API key、不出图——交付的是提示词,出图在下游。 Use when asked to 场景设定、出场景、环境设定集、场景一致性、scene bibles for AI short drama。

Writing & Content965

Novel Characters

6.8k

eternityspring/shuohao-skills

从小说或短故事里拆出角色表、人物画像、形象提示词、音色提示词, 其中形象提示词含一张角色设定图的完整版面指令(左半身像 + 右全身三视图 + 细节条), 产出 JSON + Markdown + 可交互的 report.html。 报告语言可指定(--lang),默认中文,任意语言都支持;零依赖、零 API key、不出图。 Use when asked to 拆小说角色、分析人物、生成角色卡、character sheets from a novel。

Writing & Content965

Novel Outline

6.8k

eternityspring/shuohao-skills

把一本小说改编成短剧大纲五件套:改编说明、人物表、爽点表、分集梗概、资产清单, 产出 outline.json + Markdown + 单页评审报告(KPI 带、关键决策、爽点时间轴、调度矩阵、场景概览、质量门)。 14 道质量门全部由脚本确定性检查(角色分档上限、主场景上限随集数动态、爽点间隔≤3集、每集钩子悬念必填……),不靠模型自觉; 支持体检模式:贴一份现成大纲进来,只跑质量门给诊断。 零依赖、零 API key,用当前会话额度。 Use when asked to 改编大纲、短剧大纲、拆大纲、小说转短剧、adaptation outline。

Writing & Content965

Cartoon 3d Short

4.1k

mromidev/claude-animated-shorts

Make a ~55-70 s vertical cartoon story short in the "2D characters in a colourful 3D world" style (flat bean-head cartoon cards with ink outlines, painted 3D town/world with black ink lines, saturated sky, depth-of-field backgrounds, gliding cameras, voice narration, synthesized SFX + march-style music), rendered with three.js inside Remotion. Proven on "The Bridge That Fell for a Song" (2026-10-31). Use when the user asks for another video "like the bridge video", "like the soldiers/bridge short", "in that cartoon 3D style", a history/science story short with cartoon characters in 3D, or says

Images, Video & Audio853

Yt Viral

6.4k

Jakeschincariol/youtube-agent-skill

Find what is actually working in the user's niche on YouTube and rank it by how far each video beat its own channel, then name the formula. Use for "what's working right now", "find viral videos in my niche", "why did this blow up", competitor research, or a swipe file.

Images, Video & Audio1.8k

Video Outreach

7.2k

tech-leads-club/agent-skills

When the user wants to build video-first cold outreach, create personalized video at scale, implement async selling, or use AI demo generation for prospecting. Also use when the user mentions 'video outreach,' 'personalized video,' 'video prospecting,' 'Tavus,' 'Sendspark,' 'HeyGen,' 'video email,' 'async selling,' 'video demo,' or 'made this for you.' This skill covers video-first outreach systems from personalization through conversion optimization. Do NOT use for technical implementation, code review, or software architecture.

Images, Video & AudioIn 1 list568

Browse the most popular Claude skills, all images, video & audio skills, or write your own with the skills generator.