character-refs turns a short character description into real reference images. The description is split into fields, gaps are filled and shown for your confirmation, then a front full-body anchor image is generated. Every other view, such as headshot, 90-degree profile, back and detail close-ups, is generated from that one anchor, in tiers you choose.
Each image is labeled, can be regenerated alone, and is marked stale when the anchor, style or description changes. An HTML report shows the whole set. It works with Qwen Image on ComfyUI, Codex image generation, the OpenAI image API or a custom command.
What You Get
- An asset file holding the character description and every version of every image
- A front full-body anchor and, by default, a headshot, a 90-degree profile and a back view
- Optional detail images for hair, collar, sleeves, shoes or named features, and an optional 45-degree headshot
- Images labeled with character, view, version, model and the references they used
- An HTML report with stale images flagged, in Chinese, English or Japanese
Common Use Cases
- Making consistent reference images for a short drama or anime character before video generation
- Designing a character for your own original story without any source novel
- Regenerating one bad view without redoing the whole set
What Makes It Unique
The whole set has a single root: only the anchor is generated from text, and each other view is generated from the anchor, so one bad image never cascades. Models can be mixed between anchor and derived views. Frozen items are tracked by hash, and changing the anchor, style or description marks dependants as stale and keeps all old versions.
Under The Hood
The skill runs a bundled Node script with no npm dependencies. It writes intake, asset, image and report files into the output folder. Image generation goes out to the backend you configure: your ComfyUI server (with optional credentials from environment variables or an env file), the local Codex image tool, or the OpenAI images API with your key, or a custom command you provide, so your prompts are sent to that service. Settings are saved in a local config file. The OpenAI adapter was only tested against a local fake server according to the skill.