# Visual Ip Illustrations

> Visual IP Illustrations generates selectable visual-IP article-body illustrations for articles, posts, blogs, Notion docs, workflow docs, methods, processes, structures, states, metaphors, opinions, shot lists, title-removal edits, and image repair. The omitted visual IP default is Xiaohei, with localized route aliases preserved in references/routing.md; Littlebox, Tom, Ferris, Seal, OpenClaw, Go Gopher, Cai Xukun, Hermes Agent, and Linux Mascot are explicit selectable routes.

- Skill: `yangchuansheng/visual-ip-illustrations` (Agent Skill, multi-file: 93 files)
- Install (CLI): `npx skillmds@latest add yangchuansheng/visual-ip-illustrations`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yangchuansheng/visual-ip-illustrations/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: yangchuansheng (https://skillmd.com/u/yangchuansheng)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/yangchuansheng/visual-ip-illustrations

---


# Visual IP Illustrations

## Core Positioning

Visual IP Illustrations designs and generates 16:9 horizontal article-body illustrations. The goal is to turn a key judgment, process, structure, state, or metaphor from the article into a clean, strange, creative, readable hand-drawn explanatory image.

Canonical invocation: `$visual-ip-illustrations`.

Compatibility marker: `$ian-xiaohei-illustrations` remains the v1.4 compatibility alias; existing prompts can continue using `$ian-xiaohei-illustrations` during the v1.4 local migration window.

## 1.4 Runtime Identity and Local Migration

- Canonical runtime identity: Visual IP Illustrations.
- Canonical skill invocation: `$visual-ip-illustrations`.
- v1.4 compatibility alias: `$ian-xiaohei-illustrations`.
- Canonical package slug/path: `visual-ip-illustrations`.
- Legacy package slug/path: `ian-xiaohei-illustrations`.
- Local migration: install or copy the package as `visual-ip-illustrations` for canonical discovery while keeping `ian-xiaohei-illustrations` available for existing prompts during v1.4.

## Visual IP Routes

The omitted visual IP default is Xiaohei. Compatibility marker: omitted visual IP selects the Xiaohei route. Omitted visual IP selects only the Xiaohei route.

Xiaohei is a black solid-bodied character with white dot eyes, thin legs, and a blank expression. Xiaohei performs one serious, absurd, conceptually valid action and carries the central cognitive action in the image.

Littlebox is an explicit route for a closed paper-box character. It uses thick rough black marker linework, a pale sky-blue or pale lavender background, amber seam tape, and sparse coral accents. It translates the same cognitive action into collecting, packaging, sorting, delivering, blocking, or repairing.

Tom is an explicit protected-character route: route id `tom`, display name `Tom`, default=false, output_suffix: tom, route status `gated-authorized`. Tom rights authority is `references/ips/tom/rights.md`, and planning, generation, QA, edit, and delivery surfaces keep the rights-status note.

Ferris is an explicit Rust-community mascot route: route id `ferris`, display name `Ferris`, default=false, output_suffix: ferris, route status `source-reviewed`. Ferris source/trademark authority is `references/ips/ferris/source.md`, and planning, generation, QA, edit, and delivery surfaces keep the source/trademark note.

Seal is an explicit route: route id `seal`, display name `Seal`, default=false, output_suffix: seal, route status `active`. Seal is a product-neutral hoodie seal article character. Seal source-history authority is `references/ips/seal/source.md`, and planning, generation, QA, edit, and delivery surfaces keep the hoodie seal identity note, Logo-free note, and `assets/<article-slug>-seal/`.

Seal imagery is logo-free: cap, hoodie chest, mascot body, props, and scene use no cap logo, no chest logo, no mascot logos, no logo patches, no logo-like wave/cloud mark, no emblem, and no text badge.

OpenClaw is an explicit source-reviewed logo-mascot route: route id `openclaw`, display name `OpenClaw`, default=false, output_suffix: openclaw, route status `source-reviewed`. OpenClaw source/license authority is `references/ips/openclaw/source.md`, and planning, generation, QA, edit, and delivery surfaces keep the uploaded-logo identity note, source/license note, and `assets/<article-slug>-openclaw/`.

OpenClaw imagery preserves the red logo-derived mascot identity: red round body, side claw-like arms, two antennae, black eyes, cyan pupils, and short legs.

Go Gopher is an explicit source-reviewed article-illustration mascot route: route id `gopher`, display name `Go Gopher`, default=false, output_suffix: gopher, route status `source-reviewed`. Go Gopher source/license authority is `references/ips/gopher/source.md`, local visual authority is route-local `skills/visual-ip-illustrations/references/ips/gopher/gopher.png`, and planning, generation, QA, edit, and delivery surfaces keep the route-local `gopher.png` identity note, source/license note, public sample review boundary, Go logo boundary, official endorsement boundary, and `assets/<article-slug>-gopher/`.

Go Gopher imagery preserves the source-reviewed mascot identity: blue rounded upright body, rounded head/body silhouette, small rounded ears, large simple eyes, black nose, buck teeth, beige muzzle and paws, compact limbs, friendly standing posture, black outline, and white sticker-like border. Go Gopher attribution stays attached through Renee French and the Creative Commons Attribution 4.0 boundary.

Cai Xukun is an explicit gated public-figure stylized mascot route: route id `caixukun`, display name `Cai Xukun`, default=false, output_suffix: caixukun, route status `gated-public-figure`. Cai Xukun source authority is `references/ips/caixukun/source.md`, and planning, generation, QA, edit, and delivery surfaces keep the uploaded-image identity note, source-image context note, public-figure likeness boundary, public sample review boundary, route isolation status, and `assets/<article-slug>-caixukun/`.

Cai Xukun imagery preserves uploaded-image identity markers from `references/ips/caixukun/source.md`: yellow duck-like rounded mascot body, silver layered idol hair, oversized white eyes, red cheek circles, orange beak, black high-collar top, white straps, white lower outfit, and compact black or gray boots. The green reference background is source-image context, while generated article illustrations use sparse 16:9 white-background style. Public generated Cai Xukun samples require release review before appearing in public examples or release surfaces.

Hermes Agent is an explicit source-reviewed uploaded-image article-illustration route: route id `hermes`, display name `Hermes Agent`, default=false, output_suffix: hermes, route status `source-reviewed`. Hermes Agent source authority is `references/ips/hermes/source.md`, and planning, generation, QA, edit, and delivery surfaces keep uploaded visual authority from `Generated image 1 (16).jpeg`, official source context, MIT license context, public sample review boundary, mythology-drift boundary, product-poster boundary, route isolation status, and `assets/<article-slug>-hermes/`.

Hermes Agent imagery preserves uploaded-image identity markers from `references/ips/hermes/source.md`: monochrome full-body logo-style character, black bob haircut with bright highlights, headset or earpiece, black sleeveless dress, white collar tag with an `A`-like mark, black thigh-high stockings, platform heels, and slender fashion-figure posture. Generated article illustrations use sparse 16:9 white-background article style. Public generated Hermes Agent samples require release review before appearing in public examples or release surfaces.

Linux Mascot is an explicit source-reviewed uploaded-image article-illustration route: route id `linux`, display name `Linux Mascot`, default=false, output_suffix: linux, route status `source-reviewed`. Linux Mascot source authority is `references/ips/linux/source.md`, and planning, generation, QA, edit, and delivery surfaces keep uploaded visual authority from `/Users/longnv/Downloads/Linux-logo.jpg`, Larry Ewing Tux attribution, The GIMP attribution condition, Linux trademark boundary, distro-logo boundary, product-output boundary, public sample review boundary, route isolation status, and `assets/<article-slug>-linux/`.

Linux Mascot imagery preserves uploaded-image identity markers from `references/ips/linux/source.md`: glossy black rounded penguin head and body, white face eye patches, large oval eyes with dark pupils and small highlights, yellow-orange beak with two nostril dots, white oval belly, long black flippers, seated rounded posture, and oversized yellow-orange webbed feet. Generated article illustrations use sparse 16:9 white-background article style. Public generated Linux Mascot samples require release review before appearing in public examples or release surfaces. Product-output boundary: product advertising, product-poster output, CLI screenshots, web hero graphics, kernel dashboard screenshots, and operating-system marketing graphics stay outside Linux Mascot route identity.

## Reference Loading

Read `references/routing.md` first, then load only the selected route's required references. Keep context route-local and task-scoped.

- `references/routing.md`: visual IP routes, aliases, defaults, output suffixes, required references, attribution contexts, and route statuses.
- `references/ips/xiaohei/index.md`: Xiaohei canonical pack navigation, file responsibilities, and output path.
- `references/ips/xiaohei/style-dna.md`: Xiaohei style DNA, color, text, and vetoes.
- `references/ips/xiaohei/xiaohei-ip.md`: Xiaohei character identity, personality, action library, and vetoes.
- `references/ips/xiaohei/composition-patterns.md`: Xiaohei structure types, original metaphor method, and anti-copy rules.
- `references/ips/xiaohei/prompt-template.md`: Xiaohei single-image prompt template.
- `references/ips/xiaohei/qa-checklist.md`: Xiaohei post-generation checks and iteration rules.
- `references/ips/littlebox/index.md`: Littlebox canonical pack navigation, file responsibilities, source attribution, and output path.
- `references/ips/littlebox/style-dna.md`: Littlebox visual language, background pool, marker linework, color, labels, and vetoes.
- `references/ips/littlebox/littlebox-ip.md`: Littlebox closed paper-box identity, tape, arms, lid, actions, and failure modes.
- `references/ips/littlebox/composition-patterns.md`: Littlebox composition families, physical metaphors, spatial rules, flow rules, and anti-copy rules.
- `references/ips/littlebox/language-and-labels.md`: Littlebox English prompt rules, user's-language visible labels, planning notes, and delivery-note rules.
- `references/ips/littlebox/prompt-template.md`: Littlebox shot-list format, single-image English prompt template, and edit prompts.
- `references/ips/littlebox/qa-checklist.md`: Littlebox post-generation identity, linework, label, background, action, and delivery checks.
- `references/ips/tom/index.md`: Tom canonical pack navigation, route status, rights authority, output path, and reference list.
- `references/ips/tom/rights.md`: Tom authorization scope, distribution boundary, public-sample policy, reviewer fields, and route-status authority.
- `references/ips/tom/style-dna.md`: Tom sparse article-illustration style, recognition cues, protected-route visual vetoes, and route leakage signals.
- `references/ips/tom/tom-ip.md`: Tom identity, solo route boundary, cognitive-action responsibility, recognition gates, and failure modes.
- `references/ips/tom/composition-patterns.md`: Tom composition families, supporting objects, original metaphor gates, and protected-route gates.
- `references/ips/tom/prompt-template.md`: Tom planning fields, single-image prompt, edit gates, rights-status note, and output reminder.
- `references/ips/tom/qa-checklist.md`: Tom protected-route QA, failure categories, repair moves, and delivery judgment.
- `references/ips/ferris/index.md`: Ferris canonical pack navigation, route status, source/trademark authority, output path, and reference list.
- `references/ips/ferris/source.md`: Ferris source context, CC0/public-domain context, Rust trademark boundary, public-sample policy, reviewer fields, and route-status authority.
- `references/ips/ferris/style-dna.md`: Ferris sparse article-illustration style, recognition cues, source/trademark visual vetoes, and route leakage signals.
- `references/ips/ferris/ferris-ip.md`: Ferris identity, route boundary, cognitive-action responsibility, recognition gates, and failure modes.
- `references/ips/ferris/composition-patterns.md`: Ferris composition families, Rust-themed supporting objects, original metaphor gates, and source/trademark gates.
- `references/ips/ferris/prompt-template.md`: Ferris planning fields, single-image prompt, edit gates, source/trademark note, and output reminder.
- `references/ips/ferris/qa-checklist.md`: Ferris source-reviewed QA, failure categories, repair moves, and delivery judgment.
- `references/ips/seal/index.md`: Seal canonical pack navigation, route status, source-history authority, output path, and reference list.
- `references/ips/seal/source.md`: Seal source-history authority, hoodie seal identity note, logo-free behavior, public-sample policy, reviewer fields, and route-status authority.
- `references/ips/seal/style-dna.md`: Seal sparse article-illustration style, hoodie seal identity markers, product-neutral article metaphors, visual vetoes, and route gates.
- `references/ips/seal/seal-ip.md`: Seal identity, hoodie seal visual markers, cognitive-action responsibility, recognition gates, and failure modes.
- `references/ips/seal/composition-patterns.md`: Seal composition families, hoodie seal action patterns, supporting object pool, and original metaphor gates.
- `references/ips/seal/prompt-template.md`: Seal planning fields, single-image prompt, edit gates, hoodie seal identity note, and output reminder.
- `references/ips/seal/qa-checklist.md`: Seal QA, failure categories, repair moves, and delivery judgment.
- `references/ips/openclaw/index.md`: OpenClaw canonical pack navigation, route status, source/license authority, uploaded-logo identity note, output path, and reference list.
- `references/ips/openclaw/source.md`: OpenClaw source/license authority, official repository, MIT License, OpenClaw Foundation copyright, uploaded-logo authority, public-sample policy, reviewer fields, and route-status authority.
- `references/ips/openclaw/style-dna.md`: OpenClaw sparse article-illustration style, uploaded-logo identity markers, visual vetoes, and route gates.
- `references/ips/openclaw/openclaw-ip.md`: OpenClaw identity, recognition rules, cognitive-action responsibility, route boundary, and failure modes.
- `references/ips/openclaw/composition-patterns.md`: OpenClaw composition families, article-metaphor invention rules, OpenClaw action patterns, supporting object pool, and anti-repeat rules.
- `references/ips/openclaw/prompt-template.md`: OpenClaw planning fields, one-image generation prompt, edit gates, uploaded-logo identity note, source/license note, and output reminder.
- `references/ips/openclaw/qa-checklist.md`: OpenClaw QA gates, uploaded-logo identity checks, failure signals, iteration moves, and delivery judgment.
- `references/ips/gopher/index.md`: Go Gopher pack navigation, route status, source/license authority, output path, shared failure categories, operational coherence, and scope boundary.
- `references/ips/gopher/source.md`: Go blog source context, Renee French attribution, Creative Commons Attribution 4.0 boundary, route-local `skills/visual-ip-illustrations/references/ips/gopher/gopher.png` visual authority, sample policy, review owner, and route status changes.
- `references/ips/gopher/style-dna.md`: sparse Go Gopher article-illustration style, visual marker preservation, visual vetoes, sample boundary, and route isolation.
- `references/ips/gopher/gopher-ip.md`: Go Gopher identity, recognition rules, cognitive-action responsibility, route boundary, and failure modes.
- `references/ips/gopher/composition-patterns.md`: composition families, article-metaphor invention, Go Gopher action patterns, supporting object pool, and anti-repeat rules.
- `references/ips/gopher/prompt-template.md`: planning fields, one-image prompt template, edit prompts, local visual authority note, source/license note, and output reminder.
- `references/ips/gopher/qa-checklist.md`: pass/fail gates, Go Gopher identity checks, iteration moves, route leakage repair, public sample boundary, and delivery judgment.
- `references/ips/caixukun/index.md`: Cai Xukun pack navigation, route status, source authority, output path, shared failure categories, operational coherence, and scope boundary.
- `references/ips/caixukun/source.md`: Cai Xukun uploaded visual authority, public-figure likeness boundary, source-image context, sample policy, review owner, route status, and route-local authority.
- `references/ips/caixukun/style-dna.md`: Cai Xukun sparse article-illustration style, uploaded-image marker preservation, green-background carryover prevention, visual vetoes, stable gates, and route isolation.
- `references/ips/caixukun/caixukun-ip.md`: Cai Xukun stylized mascot identity, recognition rules, cognitive-action responsibility, public-figure likeness boundary, route boundary, and failure modes.
- `references/ips/caixukun/composition-patterns.md`: Cai Xukun composition families, article-metaphor invention, mascot action patterns, supporting object pool, anti-repeat rules, and route leakage boundaries.
- `references/ips/caixukun/prompt-template.md`: Cai Xukun planning fields, one-image prompt template, edit prompts, uploaded-image identity note, public-figure likeness-boundary repair, green-background carryover repair, route leakage repair, and output reminder.
- `references/ips/caixukun/qa-checklist.md`: Cai Xukun pass/fail gates, uploaded-image identity checks, public-figure likeness checks, iteration moves, route leakage repair, public sample boundary, and delivery judgment.
- `references/ips/hermes/index.md`: Hermes Agent pack navigation, route contract, uploaded marker set, failure categories, operational coherence, and output path.
- `references/ips/hermes/source.md`: Hermes Agent official source context, MIT license context, uploaded-image authority, sample policy, product boundary, mythology boundary, review fields, and route status authority.
- `references/ips/hermes/style-dna.md`: Hermes Agent sparse visual style, route isolation gate, product-poster gate, mythology-drift gate, and visual rejection patterns.
- `references/ips/hermes/hermes-ip.md`: Hermes Agent identity, recognition rules, cognitive-action responsibility, action verbs, route boundary, and failure modes.
- `references/ips/hermes/composition-patterns.md`: Hermes Agent composition families, active-composition gate, metaphor invention rule, supporting objects, action patterns, and anti-repeat rules.
- `references/ips/hermes/prompt-template.md`: Hermes Agent planning fields, one-image prompt template, edit repairs, source notes, mythology-drift note, product-poster boundary note, and output reminder.
- `references/ips/hermes/qa-checklist.md`: Hermes Agent pass/fail gates, uploaded-image identity checks, source and MIT license checks, iteration moves, route leakage repair, public sample boundary, and delivery judgment.
- `references/ips/linux/index.md`: Linux Mascot pack navigation, route contract, uploaded marker set, failure categories, operational coherence, and output path.
- `references/ips/linux/source.md`: Linux Mascot source authority, Larry Ewing Tux attribution, The GIMP attribution condition, Linux trademark guidance, uploaded visual authority, public-sample policy, reviewer fields, and route-status authority.
- `references/ips/linux/style-dna.md`: Linux Mascot sparse visual style, uploaded Tux marker preservation, trademark-boundary gate, product-output gate, visual vetoes, and route isolation gate.
- `references/ips/linux/linux-ip.md`: Linux Mascot identity, recognition rules, cognitive-action responsibility, action verbs, route boundary, and failure modes.
- `references/ips/linux/composition-patterns.md`: Linux Mascot composition families, original article-metaphor invention, Tux action patterns, supporting object pool, trademark drift guardrails, and route leakage boundary.
- `references/ips/linux/prompt-template.md`: Linux Mascot planning fields, one-image prompt template, edit gates, source and trademark notes, route leakage repair, and output reminder.
- `references/ips/linux/qa-checklist.md`: Linux Mascot pass/fail gates, uploaded-image identity checks, source and trademark checks, iteration moves, route leakage repair, public sample boundary, and delivery judgment.
- `references/style-dna.md`, `references/xiaohei-ip.md`, `references/composition-patterns.md`, `references/prompt-template.md`, `references/qa-checklist.md`: legacy root compatibility entry points for existing prompts and docs; current Xiaohei behavior reads the canonical `references/ips/xiaohei/` files.
- `assets/examples/`: low-frequency visual calibration only. Use them for density and participation calibration, then create a fresh metaphor for the current article.

## Workflow

### 1. Select the Visual IP Route

Read `references/routing.md` first and choose the route for the current task.

- Omitted visual IP selects `xiaohei`.
- Xiaohei aliases listed in `references/routing.md` select the same Xiaohei route.
- Littlebox aliases listed in `references/routing.md` select the same Littlebox route.
- Tom aliases listed in `references/routing.md` select the same Tom route: route id `tom`, display name `Tom`, default=false, output_suffix: tom, route status `gated-authorized`, rights pointer `references/ips/tom/rights.md`.
- Ferris aliases listed in `references/routing.md` select the same Ferris route: route id `ferris`, display name `Ferris`, default=false, output_suffix: ferris, route status `source-reviewed`, source/trademark pointer `references/ips/ferris/source.md`.
- Seal aliases listed in `references/routing.md` select the same Seal route: route id `seal`, display name `Seal`, default=false, output_suffix: seal, route status `active`, source pointer `references/ips/seal/source.md`.
- `OpenClaw`, `openclaw`, `OpenClaw logo`, `OpenClaw mascot`, and the OpenClaw aliases listed in `references/routing.md` select the same OpenClaw route: route id `openclaw`, display name `OpenClaw`, default=false, output_suffix: openclaw, route status `source-reviewed`, source/license pointer `references/ips/openclaw/source.md`.
- `Go Gopher`, `Gopher`, `golang gopher`, `Go mascot`, and Go Gopher-qualified route phrases select the same Go Gopher route: route id `gopher`, display name `Go Gopher`, default=false, output_suffix: gopher, route status `source-reviewed`, source/license pointer `references/ips/gopher/source.md`, and route-local `skills/visual-ip-illustrations/references/ips/gopher/gopher.png` visual authority. Generic route phrases stay governed by `references/routing.md` and remain outside Go Gopher selection.
- Cai Xukun aliases listed in `references/routing.md` select the same Cai Xukun route: route id `caixukun`, display name `Cai Xukun`, default=false, output_suffix: caixukun, route status `gated-public-figure`, source pointer `references/ips/caixukun/source.md`, and output path `assets/<article-slug>-caixukun/`. Broad celebrity, idol, duck, yellow mascot, and fandom words stay governed by `references/routing.md` and remain outside Cai Xukun selection.
- `Hermes Agent`, `Hermes`, `hermes`, `hermes-agent`, `Hermes logo`, and `Hermes Agent logo` select the same Hermes Agent route: route id `hermes`, display name `Hermes Agent`, default=false, output_suffix: hermes, route status `source-reviewed`, source pointer `references/ips/hermes/source.md`, uploaded visual authority from `Generated image 1 (16).jpeg`, and output path `assets/<article-slug>-hermes/`. Broad assistant, AI agent, logo, anime, monochrome girl, fashion figure, Greek messenger, winged sandals, and caduceus terms stay governed by `references/routing.md` and remain outside Hermes Agent selection.
- `Linux Mascot`, `Linux mascot`, `Linux`, `linux`, `Tux`, `tux`, `Linux penguin`, and `Tux penguin` select the same Linux Mascot route: route id `linux`, display name `Linux Mascot`, default=false, output_suffix: linux, route status `source-reviewed`, source pointer `references/ips/linux/source.md`, uploaded visual authority from `/Users/longnv/Downloads/Linux-logo.jpg`, and output path `assets/<article-slug>-linux/`. Broad penguin, server, kernel, distro, distro-logo, Linux Foundation, operating-system, CLI, terminal, product, brand-campaign, and generic mascot terms stay governed by `references/routing.md` and remain outside Linux Mascot selection.
- Mixed requests across Xiaohei, Littlebox, Tom, Ferris, Seal, OpenClaw, Go Gopher, Cai Xukun, Hermes Agent, and Linux Mascot first identify one shared core idea, then create separate route groups. Each selected variant group uses its own route id, required_references, prompt template, composition rules, QA, edit repairs, output_suffix, route note, and output directory.
- Xiaohei keeps the `$ian-xiaohei-illustrations` compatibility behavior and `assets/<article-slug>-illustrations/` output path; canonical invocation is `$visual-ip-illustrations`.
- Littlebox uses `assets/<article-slug>-littlebox/`.
- Tom uses `assets/<article-slug>-tom/` and keeps `gated-authorized` plus `references/ips/tom/rights.md` in planning, generation, QA, edit, and delivery.
- Ferris uses `assets/<article-slug>-ferris/` and keeps `source-reviewed` plus `references/ips/ferris/source.md` in planning, generation, QA, edit, and delivery.
- Seal uses `assets/<article-slug>-seal/` and keeps `active` plus `references/ips/seal/source.md` in planning, generation, QA, edit, and delivery.
- OpenClaw uses `assets/<article-slug>-openclaw/` and keeps `source-reviewed` plus `references/ips/openclaw/source.md` in planning, generation, QA, edit, and delivery.
- Go Gopher uses `assets/<article-slug>-gopher/` and keeps `source-reviewed`, `references/ips/gopher/source.md`, route-local `skills/visual-ip-illustrations/references/ips/gopher/gopher.png`, Renee French attribution, Creative Commons Attribution 4.0 boundary, public sample review boundary, Go logo boundary, and official endorsement boundary in planning, generation, QA, edit, and delivery.
- Cai Xukun uses `assets/<article-slug>-caixukun/` and keeps `gated-public-figure`, `references/ips/caixukun/source.md`, uploaded-image identity note, public-figure likeness boundary, source-image context note, public sample review boundary, route isolation status, and neutral article-concept labels after public-figure claim sanitization in planning, generation, QA, edit, and delivery.
- Hermes Agent uses `assets/<article-slug>-hermes/` and keeps `source-reviewed`, `references/ips/hermes/source.md`, uploaded-image authority status from `Generated image 1 (16).jpeg`, source context note, MIT license context, mythology-drift boundary, product-poster boundary status, public sample review boundary, route isolation status, and broad-term selection exclusions in planning, generation, QA, edit, and delivery.
- Linux Mascot uses `assets/<article-slug>-linux/` and keeps `source-reviewed`, `references/ips/linux/source.md`, uploaded-image authority note from `/Users/longnv/Downloads/Linux-logo.jpg`, Tux source attribution note, The GIMP attribution condition, Linux trademark boundary, distro-logo boundary, product-output boundary, public sample review boundary, route isolation status, and broad-term selection exclusions in planning, generation, QA, edit, and delivery.
- Xiaohei `required_references` point to the canonical `references/ips/xiaohei/` pack; root paths remain compatibility entry points.
- Littlebox `required_references` point to `references/ips/littlebox/`: `style-dna.md`, `littlebox-ip.md`, `composition-patterns.md`, `language-and-labels.md`, `prompt-template.md`, and `qa-checklist.md`.
- Tom `required_references` point to `references/ips/tom/`: `index.md`, `rights.md`, `style-dna.md`, `tom-ip.md`, `composition-patterns.md`, `prompt-template.md`, and `qa-checklist.md`.
- Ferris `required_references` point to `references/ips/ferris/`: `index.md`, `source.md`, `style-dna.md`, `ferris-ip.md`, `composition-patterns.md`, `prompt-template.md`, and `qa-checklist.md`.
- Seal `required_references` point to `references/ips/seal/`: `index.md`, `source.md`, `style-dna.md`, `seal-ip.md`, `composition-patterns.md`, `prompt-template.md`, and `qa-checklist.md`.
- OpenClaw `required_references` point to `references/ips/openclaw/`: `index.md`, `source.md`, `style-dna.md`, `openclaw-ip.md`, `composition-patterns.md`, `prompt-template.md`, and `qa-checklist.md`.
- Go Gopher `required_references` point to `references/ips/gopher/`: `index.md`, `source.md`, `style-dna.md`, `gopher-ip.md`, `composition-patterns.md`, `prompt-template.md`, and `qa-checklist.md`.
- Cai Xukun `required_references` point to `references/ips/caixukun/`: `index.md`, `source.md`, `style-dna.md`, `caixukun-ip.md`, `composition-patterns.md`, `prompt-template.md`, and `qa-checklist.md`.
- Hermes Agent `required_references` point to `references/ips/hermes/`: `index.md`, `source.md`, `style-dna.md`, `hermes-ip.md`, `composition-patterns.md`, `prompt-template.md`, and `qa-checklist.md`.
- Linux Mascot `required_references` point to `references/ips/linux/`: `index.md`, `source.md`, `style-dna.md`, `linux-ip.md`, `composition-patterns.md`, `prompt-template.md`, and `qa-checklist.md`.
- Each variant group loads only its own `required_references` and uses its own action library, metaphor rules, background rules, labels, QA, and output path.
- The shared workflow handles article comprehension, cognitive-anchor selection, shot planning, one-image generation, QA handoff, asset preservation, and delivery reporting.
- Visual style, character identity, prompt wording, and QA details come from the selected IP's reference files.

### 2. Read and Digest the Source Article

Read the user's article, link, Notion page, Markdown file, screenshot, or pasted text. Extract:

- the core claim
- paragraphs that carry cognitive turns
- ideas that benefit from visual explanation
- text-only passages

Prioritize cognitive anchors such as a core judgment, two breakpoints, an input-output loop, a split path, before/after contrast, one source used multiple ways, a handoff path, a common pitfall, or a role-state shift.

### 3. Plan the Shot List First

When the user asks for planning, analysis, or placement recommendations, return a shot list. For each image, include:

- placement after the paragraph
- topic
- core idea
- structure type
- selected visual IP's central action
- suggested elements
- suggested visible labels in the user's language

Littlebox shot-list entries also include:

- Placement
- Core idea
- `Littlebox state: closed`
- Visual metaphor
- Assigned background: `#E3F2FD` or `#E6E6FA`
- Suggested objects
- Short visible labels copied in the user's language

For Littlebox multi-image planning, assign backgrounds before generation. Even counts use the same number of `#E3F2FD` and `#E6E6FA`; odd counts differ by at most one unless article rhythm requires a stronger sequence. Littlebox planning notes, visible labels, and delivery notes follow the user's language. Generation prompts sent to the image model stay English and quote the visible labels exactly in the user's language.

Tom shot-list entries use `references/ips/tom/prompt-template.md` and include:

- Placement
- Core idea
- Structure type
- Tom state
- Tom action
- Supporting objects
- Visible labels
- Output path: `assets/<article-slug>-tom/`
- Rights-status note: Tom is a `gated-authorized` protected-character route; check `references/ips/tom/rights.md` for authorization scope and distribution boundary.

Ferris shot-list entries use `references/ips/ferris/prompt-template.md` and include:

- Placement
- Core idea
- Structure type
- Ferris state
- Ferris action
- Supporting objects
- Visible labels
- Output path: `assets/<article-slug>-ferris/`
- Source/trademark note: Ferris is a `source-reviewed` Rust-community mascot route; check `references/ips/ferris/source.md` for source context and trademark boundary.

Seal shot-list entries use `references/ips/seal/prompt-template.md` and include:

- Placement
- Core idea
- Structure type
- Seal state
- Seal action
- Supporting objects
- Visible labels
- Output path: `assets/<article-slug>-seal/`
- Hoodie seal identity note: Seal is an active product-neutral hoodie seal route; preserve white rounded seal body, plain navy cap, plain deep-blue hoodie, glossy dark eyes, black nose, whisker dots, small smile, short rounded flippers, compact legs, and side-rear white tail.
- Logo-free note: cap, hoodie chest, mascot body, props, and scene stay plain and mark-free.
- No-logo note: cap, hoodie chest, mascot body, props, and scene use no cap logo, no chest logo, no mascot logos, no logo patches, no logo-like wave/cloud mark, no emblem, and no text badge.

Seal planning prose can follow the user's language. Seal image-generation prompts stay English. Visible labels are copied exactly in the user's language. Seal performs the central cognitive action. Prefer one or two product-neutral article-metaphor supporting objects, then assign a Seal action such as inspect, repair, shield, bridge, tune, roll back, stamp, sort, assemble, or guide.

OpenClaw shot-list entries use `references/ips/openclaw/prompt-template.md` and include:

- Placement
- Core idea
- Structure type
- OpenClaw state
- OpenClaw action
- Supporting objects
- Visible labels
- Output path: `assets/<article-slug>-openclaw/`
- Uploaded-logo identity note: preserve red round body, side claw-like arms, two antennae, black eyes, cyan pupils, and short legs.
- Source/license note: OpenClaw is a `source-reviewed` logo-mascot route; check `references/ips/openclaw/source.md` for the official repository, MIT License, OpenClaw Foundation copyright, uploaded-logo authority, and public-sample policy.

OpenClaw planning prose can follow the user's language. OpenClaw image-generation prompts stay English. Visible labels are copied exactly in the user's language. OpenClaw performs the central cognitive action. Prefer sparse article-metaphor objects such as maps, bridges, knots, compasses, shelves, lamps, shields, stamps, keys, trails, gates, scales, buckets, envelopes, threads, lenses, hooks, claws, or small hand-built machines, then assign an OpenClaw action such as inspect, grip, sort, bridge, tune, stamp, carry, map, connect, shield, compare, mark, untangle, weigh, guide, assemble, or repair.

Go Gopher shot-list entries use `references/ips/gopher/prompt-template.md` and include:

- Placement
- Core idea
- Structure type
- Gopher state
- Gopher action
- Supporting objects
- Visible labels
- Output path: `assets/<article-slug>-gopher/`
- Source/license note: Go Gopher is a `source-reviewed` article-illustration mascot route; check `references/ips/gopher/source.md` for Go blog source context, Renee French attribution, Creative Commons Attribution 4.0 boundary, route-local `skills/visual-ip-illustrations/references/ips/gopher/gopher.png` visual authority, and public sample review boundary.

Go Gopher planning prose can follow the user's language. Go Gopher image-generation prompts stay English. Visible labels are copied exactly in the user's requested language. Go Gopher performs the central cognitive action. Prefer sparse article-metaphor objects such as maps, bridges, knots, compasses, shelves, lamps, shields, stamps, keys, trails, gates, scales, buckets, envelopes, threads, lenses, hooks, stepping stones, signposts, levers, or small hand-built machines, then assign a Go Gopher action such as inspect, point, carry, sort, bridge, repair, guide, stamp, mark, tune, shield, weigh, connect, untangle, map, compare, lift, assemble, or route.

Cai Xukun shot-list entries use `references/ips/caixukun/prompt-template.md` and include:

- Placement
- Core idea
- Structure type
- Selected IP `Cai Xukun`
- Route status `gated-public-figure`
- Cai Xukun mascot state
- Cai Xukun mascot action
- Supporting objects
- Visible labels as neutral article-concept labels in the user's requested language after public-figure claim sanitization
- Likeness boundary note
- Source-image context note
- Output path `assets/<article-slug>-caixukun/`

Cai Xukun planning prose can follow the user's language. Cai Xukun image-generation prompts stay English. Visible labels are copied exactly in the user's requested language after removing or rewriting official endorsement, affiliation, impersonation, campaign, celebrity advertising, and fandom-promotion claims into neutral article-concept labels. Cai Xukun performs the central cognitive action as a `gated-public-figure` stylized mascot route. Preserve the uploaded-image identity note from `references/ips/caixukun/source.md`, keep the green reference background as source-image context, keep generated output in sparse 16:9 white-background article style, and preserve the public sample review boundary.

Hermes Agent shot-list entries use `references/ips/hermes/prompt-template.md` and include:

- Placement
- Core idea
- Structure type
- Selected IP `Hermes Agent`
- Route status `source-reviewed`
- Hermes Agent state
- Hermes Agent action
- Supporting objects
- Visible labels copied exactly in the user's requested language
- Source context note
- Mythology-drift note
- Product-poster boundary note
- Output path: `assets/<article-slug>-hermes/`

Hermes Agent planning prose can follow the user's language. Hermes Agent image-generation prompts stay English. Visible labels are copied exactly in the user's requested language. Hermes Agent performs the central cognitive action as a source-reviewed uploaded-image article-illustration route. Preserve uploaded visual authority from `Generated image 1 (16).jpeg`, keep official source context and MIT license context attached through `references/ips/hermes/source.md`, keep generated output in sparse 16:9 white-background article style, keep mythology-drift and product-poster boundary notes visible, and preserve the public sample review boundary.

Linux Mascot shot-list entries use `references/ips/linux/prompt-template.md` and include:

- Placement
- Core idea
- Structure type
- Linux Mascot state
- Linux Mascot action
- Supporting objects
- Visible labels
- Source context note
- Trademark-boundary note
- Output path: `assets/<article-slug>-linux/`

Linux Mascot planning prose can follow the user's language. Linux Mascot image-generation prompts stay English. Visible labels copied exactly in the user's requested language. Linux Mascot performs the central cognitive action as a source-reviewed uploaded-image article-illustration route. Preserve uploaded visual authority from `/Users/longnv/Downloads/Linux-logo.jpg`, keep Larry Ewing Tux attribution, The GIMP attribution condition, Linux trademark context, and public sample review boundary attached through `references/ips/linux/source.md`, keep generated output in sparse 16:9 white-background article style, keep trademark-boundary and product-output notes visible, and preserve route isolation status.

Mixed-IP shot lists first state the shared core idea, then split into independent selected route groups:

- Xiaohei variant group: Xiaohei action, white-background hand-drawn metaphor, suggested labels, `references/ips/xiaohei/` QA, `assets/<article-slug>-illustrations/`
- Littlebox variant group: `Littlebox state: closed`, visual metaphor, assigned background, suggested objects, short visible labels, `references/ips/littlebox/` QA, `assets/<article-slug>-littlebox/`
- Tom variant group: Tom state, Tom action, supporting objects, visible labels, `references/ips/tom/` QA, `assets/<article-slug>-tom/`, rights-status note, `gated-authorized`, `references/ips/tom/rights.md`
- Ferris variant group: Ferris state, Ferris action, supporting objects, visible labels, `references/ips/ferris/` QA, `assets/<article-slug>-ferris/`, source/trademark note, `source-reviewed`, `references/ips/ferris/source.md`
- Seal variant group: Seal state, Seal action, supporting objects, visible labels, `references/ips/seal/` QA, `assets/<article-slug>-seal/`, hoodie seal identity note, Logo-free note, `active`, `references/ips/seal/source.md`
- OpenClaw variant group: OpenClaw state, OpenClaw action, supporting objects, visible labels, `references/ips/openclaw/` QA, `assets/<article-slug>-openclaw/`, uploaded-logo identity note, source/license note, `source-reviewed`, `references/ips/openclaw/source.md`
- Go Gopher variant group

…(truncated)
