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)
1---2name: visual-ip-illustrations3description: 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.4---56# Visual IP Illustrations78## Core Positioning910Visual 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.1112Canonical invocation: `$visual-ip-illustrations`.1314Compatibility 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.1516## 1.4 Runtime Identity and Local Migration1718- Canonical runtime identity: Visual IP Illustrations.19- Canonical skill invocation: `$visual-ip-illustrations`.20- v1.4 compatibility alias: `$ian-xiaohei-illustrations`.21- Canonical package slug/path: `visual-ip-illustrations`.22- Legacy package slug/path: `ian-xiaohei-illustrations`.23- 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.2425## Visual IP Routes2627The omitted visual IP default is Xiaohei. Compatibility marker: omitted visual IP selects the Xiaohei route. Omitted visual IP selects only the Xiaohei route.2829Xiaohei 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.3031Littlebox 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.3233Tom 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.3435Ferris 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.3637Seal 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/`.3839Seal 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.4041OpenClaw 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/`.4243OpenClaw imagery preserves the red logo-derived mascot identity: red round body, side claw-like arms, two antennae, black eyes, cyan pupils, and short legs.4445Go 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/`.4647Go 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.4849Cai 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/`.5051Cai 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.5253Hermes 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/`.5455Hermes 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.5657Linux 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/`.5859Linux 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.6061## Reference Loading6263Read `references/routing.md` first, then load only the selected route's required references. Keep context route-local and task-scoped.6465- `references/routing.md`: visual IP routes, aliases, defaults, output suffixes, required references, attribution contexts, and route statuses.66- `references/ips/xiaohei/index.md`: Xiaohei canonical pack navigation, file responsibilities, and output path.67- `references/ips/xiaohei/style-dna.md`: Xiaohei style DNA, color, text, and vetoes.68- `references/ips/xiaohei/xiaohei-ip.md`: Xiaohei character identity, personality, action library, and vetoes.69- `references/ips/xiaohei/composition-patterns.md`: Xiaohei structure types, original metaphor method, and anti-copy rules.70- `references/ips/xiaohei/prompt-template.md`: Xiaohei single-image prompt template.71- `references/ips/xiaohei/qa-checklist.md`: Xiaohei post-generation checks and iteration rules.72- `references/ips/littlebox/index.md`: Littlebox canonical pack navigation, file responsibilities, source attribution, and output path.73- `references/ips/littlebox/style-dna.md`: Littlebox visual language, background pool, marker linework, color, labels, and vetoes.74- `references/ips/littlebox/littlebox-ip.md`: Littlebox closed paper-box identity, tape, arms, lid, actions, and failure modes.75- `references/ips/littlebox/composition-patterns.md`: Littlebox composition families, physical metaphors, spatial rules, flow rules, and anti-copy rules.76- `references/ips/littlebox/language-and-labels.md`: Littlebox English prompt rules, user's-language visible labels, planning notes, and delivery-note rules.77- `references/ips/littlebox/prompt-template.md`: Littlebox shot-list format, single-image English prompt template, and edit prompts.78- `references/ips/littlebox/qa-checklist.md`: Littlebox post-generation identity, linework, label, background, action, and delivery checks.79- `references/ips/tom/index.md`: Tom canonical pack navigation, route status, rights authority, output path, and reference list.80- `references/ips/tom/rights.md`: Tom authorization scope, distribution boundary, public-sample policy, reviewer fields, and route-status authority.81- `references/ips/tom/style-dna.md`: Tom sparse article-illustration style, recognition cues, protected-route visual vetoes, and route leakage signals.82- `references/ips/tom/tom-ip.md`: Tom identity, solo route boundary, cognitive-action responsibility, recognition gates, and failure modes.83- `references/ips/tom/composition-patterns.md`: Tom composition families, supporting objects, original metaphor gates, and protected-route gates.84- `references/ips/tom/prompt-template.md`: Tom planning fields, single-image prompt, edit gates, rights-status note, and output reminder.85- `references/ips/tom/qa-checklist.md`: Tom protected-route QA, failure categories, repair moves, and delivery judgment.86- `references/ips/ferris/index.md`: Ferris canonical pack navigation, route status, source/trademark authority, output path, and reference list.87- `references/ips/ferris/source.md`: Ferris source context, CC0/public-domain context, Rust trademark boundary, public-sample policy, reviewer fields, and route-status authority.88- `references/ips/ferris/style-dna.md`: Ferris sparse article-illustration style, recognition cues, source/trademark visual vetoes, and route leakage signals.89- `references/ips/ferris/ferris-ip.md`: Ferris identity, route boundary, cognitive-action responsibility, recognition gates, and failure modes.90- `references/ips/ferris/composition-patterns.md`: Ferris composition families, Rust-themed supporting objects, original metaphor gates, and source/trademark gates.91- `references/ips/ferris/prompt-template.md`: Ferris planning fields, single-image prompt, edit gates, source/trademark note, and output reminder.92- `references/ips/ferris/qa-checklist.md`: Ferris source-reviewed QA, failure categories, repair moves, and delivery judgment.93- `references/ips/seal/index.md`: Seal canonical pack navigation, route status, source-history authority, output path, and reference list.94- `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.95- `references/ips/seal/style-dna.md`: Seal sparse article-illustration style, hoodie seal identity markers, product-neutral article metaphors, visual vetoes, and route gates.96- `references/ips/seal/seal-ip.md`: Seal identity, hoodie seal visual markers, cognitive-action responsibility, recognition gates, and failure modes.97- `references/ips/seal/composition-patterns.md`: Seal composition families, hoodie seal action patterns, supporting object pool, and original metaphor gates.98- `references/ips/seal/prompt-template.md`: Seal planning fields, single-image prompt, edit gates, hoodie seal identity note, and output reminder.99- `references/ips/seal/qa-checklist.md`: Seal QA, failure categories, repair moves, and delivery judgment.100- `references/ips/openclaw/index.md`: OpenClaw canonical pack navigation, route status, source/license authority, uploaded-logo identity note, output path, and reference list.101- `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.102- `references/ips/openclaw/style-dna.md`: OpenClaw sparse article-illustration style, uploaded-logo identity markers, visual vetoes, and route gates.103- `references/ips/openclaw/openclaw-ip.md`: OpenClaw identity, recognition rules, cognitive-action responsibility, route boundary, and failure modes.104- `references/ips/openclaw/composition-patterns.md`: OpenClaw composition families, article-metaphor invention rules, OpenClaw action patterns, supporting object pool, and anti-repeat rules.105- `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.106- `references/ips/openclaw/qa-checklist.md`: OpenClaw QA gates, uploaded-logo identity checks, failure signals, iteration moves, and delivery judgment.107- `references/ips/gopher/index.md`: Go Gopher pack navigation, route status, source/license authority, output path, shared failure categories, operational coherence, and scope boundary.108- `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.109- `references/ips/gopher/style-dna.md`: sparse Go Gopher article-illustration style, visual marker preservation, visual vetoes, sample boundary, and route isolation.110- `references/ips/gopher/gopher-ip.md`: Go Gopher identity, recognition rules, cognitive-action responsibility, route boundary, and failure modes.111- `references/ips/gopher/composition-patterns.md`: composition families, article-metaphor invention, Go Gopher action patterns, supporting object pool, and anti-repeat rules.112- `references/ips/gopher/prompt-template.md`: planning fields, one-image prompt template, edit prompts, local visual authority note, source/license note, and output reminder.113- `references/ips/gopher/qa-checklist.md`: pass/fail gates, Go Gopher identity checks, iteration moves, route leakage repair, public sample boundary, and delivery judgment.114- `references/ips/caixukun/index.md`: Cai Xukun pack navigation, route status, source authority, output path, shared failure categories, operational coherence, and scope boundary.115- `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.116- `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.117- `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.118- `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.119- `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.120- `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.121- `references/ips/hermes/index.md`: Hermes Agent pack navigation, route contract, uploaded marker set, failure categories, operational coherence, and output path.122- `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.123- `references/ips/hermes/style-dna.md`: Hermes Agent sparse visual style, route isolation gate, product-poster gate, mythology-drift gate, and visual rejection patterns.124- `references/ips/hermes/hermes-ip.md`: Hermes Agent identity, recognition rules, cognitive-action responsibility, action verbs, route boundary, and failure modes.125- `references/ips/hermes/composition-patterns.md`: Hermes Agent composition families, active-composition gate, metaphor invention rule, supporting objects, action patterns, and anti-repeat rules.126- `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.127- `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.128- `references/ips/linux/index.md`: Linux Mascot pack navigation, route contract, uploaded marker set, failure categories, operational coherence, and output path.129- `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.130- `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.131- `references/ips/linux/linux-ip.md`: Linux Mascot identity, recognition rules, cognitive-action responsibility, action verbs, route boundary, and failure modes.132- `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.133- `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.134- `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.135- `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.136- `assets/examples/`: low-frequency visual calibration only. Use them for density and participation calibration, then create a fresh metaphor for the current article.137138## Workflow139140### 1. Select the Visual IP Route141142Read `references/routing.md` first and choose the route for the current task.143144- Omitted visual IP selects `xiaohei`.145- Xiaohei aliases listed in `references/routing.md` select the same Xiaohei route.146- Littlebox aliases listed in `references/routing.md` select the same Littlebox route.147- 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`.148- 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`.149- 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`.150- `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`.151- `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.152- 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.153- `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.154- `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.155- 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.156- Xiaohei keeps the `$ian-xiaohei-illustrations` compatibility behavior and `assets/<article-slug>-illustrations/` output path; canonical invocation is `$visual-ip-illustrations`.157- Littlebox uses `assets/<article-slug>-littlebox/`.158- Tom uses `assets/<article-slug>-tom/` and keeps `gated-authorized` plus `references/ips/tom/rights.md` in planning, generation, QA, edit, and delivery.159- Ferris uses `assets/<article-slug>-ferris/` and keeps `source-reviewed` plus `references/ips/ferris/source.md` in planning, generation, QA, edit, and delivery.160- Seal uses `assets/<article-slug>-seal/` and keeps `active` plus `references/ips/seal/source.md` in planning, generation, QA, edit, and delivery.161- OpenClaw uses `assets/<article-slug>-openclaw/` and keeps `source-reviewed` plus `references/ips/openclaw/source.md` in planning, generation, QA, edit, and delivery.162- 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.163- 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.164- 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.165- 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.166- Xiaohei `required_references` point to the canonical `references/ips/xiaohei/` pack; root paths remain compatibility entry points.167- 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`.168- 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`.169- 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`.170- 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`.171- 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`.172- 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`.173- 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`.174- 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`.175- 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`.176- Each variant group loads only its own `required_references` and uses its own action library, metaphor rules, background rules, labels, QA, and output path.177- The shared workflow handles article comprehension, cognitive-anchor selection, shot planning, one-image generation, QA handoff, asset preservation, and delivery reporting.178- Visual style, character identity, prompt wording, and QA details come from the selected IP's reference files.179180### 2. Read and Digest the Source Article181182Read the user's article, link, Notion page, Markdown file, screenshot, or pasted text. Extract:183184- the core claim185- paragraphs that carry cognitive turns186- ideas that benefit from visual explanation187- text-only passages188189Prioritize 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.190191### 3. Plan the Shot List First192193When the user asks for planning, analysis, or placement recommendations, return a shot list. For each image, include:194195- placement after the paragraph196- topic197- core idea198- structure type199- selected visual IP's central action200- suggested elements201- suggested visible labels in the user's language202203Littlebox shot-list entries also include:204205- Placement206- Core idea207- `Littlebox state: closed`208- Visual metaphor209- Assigned background: `#E3F2FD` or `#E6E6FA`210- Suggested objects211- Short visible labels copied in the user's language212213For 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.214215Tom shot-list entries use `references/ips/tom/prompt-template.md` and include:216217- Placement218- Core idea219- Structure type220- Tom state221- Tom action222- Supporting objects223- Visible labels224- Output path: `assets/<article-slug>-tom/`225- Rights-status note: Tom is a `gated-authorized` protected-character route; check `references/ips/tom/rights.md` for authorization scope and distribution boundary.226227Ferris shot-list entries use `references/ips/ferris/prompt-template.md` and include:228229- Placement230- Core idea231- Structure type232- Ferris state233- Ferris action234- Supporting objects235- Visible labels236- Output path: `assets/<article-slug>-ferris/`237- Source/trademark note: Ferris is a `source-reviewed` Rust-community mascot route; check `references/ips/ferris/source.md` for source context and trademark boundary.238239Seal shot-list entries use `references/ips/seal/prompt-template.md` and include:240241- Placement242- Core idea243- Structure type244- Seal state245- Seal action246- Supporting objects247- Visible labels248- Output path: `assets/<article-slug>-seal/`249- 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.250- Logo-free note: cap, hoodie chest, mascot body, props, and scene stay plain and mark-free.251- 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.252253Seal 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.254255OpenClaw shot-list entries use `references/ips/openclaw/prompt-template.md` and include:256257- Placement258- Core idea259- Structure type260- OpenClaw state261- OpenClaw action262- Supporting objects263- Visible labels264- Output path: `assets/<article-slug>-openclaw/`265- Uploaded-logo identity note: preserve red round body, side claw-like arms, two antennae, black eyes, cyan pupils, and short legs.266- 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.267268OpenClaw 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.269270Go Gopher shot-list entries use `references/ips/gopher/prompt-template.md` and include:271272- Placement273- Core idea274- Structure type275- Gopher state276- Gopher action277- Supporting objects278- Visible labels279- Output path: `assets/<article-slug>-gopher/`280- 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.281282Go 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.283284Cai Xukun shot-list entries use `references/ips/caixukun/prompt-template.md` and include:285286- Placement287- Core idea288- Structure type289- Selected IP `Cai Xukun`290- Route status `gated-public-figure`291- Cai Xukun mascot state292- Cai Xukun mascot action293- Supporting objects294- Visible labels as neutral article-concept labels in the user's requested language after public-figure claim sanitization295- Likeness boundary note296- Source-image context note297- Output path `assets/<article-slug>-caixukun/`298299Cai 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.300301Hermes Agent shot-list entries use `references/ips/hermes/prompt-template.md` and include:302303- Placement304- Core idea305- Structure type306- Selected IP `Hermes Agent`307- Route status `source-reviewed`308- Hermes Agent state309- Hermes Agent action310- Supporting objects311- Visible labels copied exactly in the user's requested language312- Source context note313- Mythology-drift note314- Product-poster boundary note315- Output path: `assets/<article-slug>-hermes/`316317Hermes 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.318319Linux Mascot shot-list entries use `references/ips/linux/prompt-template.md` and include:320321- Placement322- Core idea323- Structure type324- Linux Mascot state325- Linux Mascot action326- Supporting objects327- Visible labels328- Source context note329- Trademark-boundary note330- Output path: `assets/<article-slug>-linux/`331332Linux 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.333334Mixed-IP shot lists first state the shared core idea, then split into independent selected route groups:335336- Xiaohei variant group: Xiaohei action, white-background hand-drawn metaphor, suggested labels, `references/ips/xiaohei/` QA, `assets/<article-slug>-illustrations/`337- Littlebox variant group: `Littlebox state: closed`, visual metaphor, assigned background, suggested objects, short visible labels, `references/ips/littlebox/` QA, `assets/<article-slug>-littlebox/`338- 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`339- 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`340- 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`341- 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`342- Go Gopher variant group343344…(truncated)