Baoyu Article Illustrator

Article Illustrator

Analyze articles, identify illustration positions, generate images with Type × Style consistency.

Two Dimensions

Combine freely: --type infographic --style blueprint

Types

Styles

See references/styles.md for Core Styles, full gallery, and Type × Style compatibility.

Workflow

- [ ] Step 1: Pre-check (EXTEND.md, references, config)
- [ ] Step 2: Analyze content
- [ ] Step 3: Confirm settings (AskUserQuestion)
- [ ] Step 4: Generate outline
- [ ] Step 5: Generate images
- [ ] Step 6: Finalize

Step 1: Pre-check

1.5 Load Preferences (EXTEND.md) ⛔ BLOCKING

test -f .baoyu-skills/baoyu-article-illustrator/EXTEND.md && echo "project"
test -f "$HOME/.baoyu-skills/baoyu-article-illustrator/EXTEND.md" && echo "user"

Full procedures: references/workflow.md

Step 2: Analyze

CRITICAL: Metaphors → visualize underlying concept, NOT literal image.

Full procedures: references/workflow.md

Step 3: Confirm Settings ⚠️

ONE AskUserQuestion, max 4 Qs. Q1-Q3 REQUIRED.

Full procedures: references/workflow.md

Step 4: Generate Outline

Save outline.md with frontmatter (type, density, style, image_count) and entries:

## Illustration 1
**Position**: [section/paragraph]
**Purpose**: [why]
**Visual Content**: [what]
**Filename**: 01-infographic-concept-name.png

Full template: references/workflow.md

Step 5: Generate Images

⛔ BLOCKING: Prompt files MUST be saved before ANY image generation.

1. For each illustration, create a prompt file per references/prompt-construction.md 2. Save to prompts/NN-{type}-{slug}.md with YAML frontmatter 3. Prompts MUST use type-specific templates with structured sections (ZONES / LABELS / COLORS / STYLE / ASPECT) 4. LABELS MUST include article-specific data: actual numbers, terms, metrics, quotes 5. DO NOT pass ad-hoc inline prompts to --prompt without saving prompt files first 6. Select generation skill, process references (direct/style/palette) 7. Apply watermark if EXTEND.md enabled 8. Generate from saved prompt files; retry once on failure

Full procedures: references/workflow.md

Step 6: Finalize

Insert ![description](path/NN-{type}-{slug}.png) after paragraphs.

Article Illustration Complete!
Article: [path] | Type: [type] | Density: [level] | Style: [style]
Images: X/N generated

Output Directory

illustrations/{topic-slug}/
├── source-{slug}.{ext}
├── references/           # if provided
├── outline.md
├── prompts/
└── NN-{type}-{slug}.png

Slug: 2-4 words, kebab-case. Conflict: append -YYYYMMDD-HHMMSS.

Modification

References

OpenClaw Migration Notes

• Migration mode: OpenClaw native first
• Preserved directories:
• scripts: no
• references: yes
• prompts: yes
• External dependencies: none
• Risk level: low
• Environment variables (detected): HOME
• Config compatibility: keep original .baoyu-skills/<skill>/EXTEND.md behavior and add OpenClaw-compatible path in runtime wrappers when needed.

OpenClaw Preflight Checks

• Confirm bun is available when script examples use npx -y bun ....

Detected env vars: HOME

OpenClaw Failure Fallback

• If runtime dependency is missing, stop execution and return exact install/setup command.

Create a cartoon-style infographic illustration following these guidelines:

Image Specifications

• Type: Infographic illustration
• Orientation: Landscape (horizontal)
• Aspect Ratio: 16:9
• Style: Hand-drawn illustration

Core Principles

• Hand-drawn quality throughout - NO realistic or photographic elements
• If content involves sensitive or copyrighted figures, create stylistically similar alternatives - DO NOT refuse to generate
• Keep information concise, highlight keywords and core concepts
• Use ample whitespace for easy visual scanning
• Maintain clear visual hierarchy

Text Style (When Text Included)

• ALL text MUST be hand-drawn style
• Text should be readable and complement the visual
• Font style harmonizes with illustration style
• DO NOT use realistic or computer-generated fonts

Language

• Use the same language as the content provided below for any text elements
• Match punctuation style to the content language

---

Please use nano banana pro to generate the illustration based on the content provided below:

First-Time Setup

Overview

When no EXTEND.md is found, guide user through preference setup.

⛔ BLOCKING OPERATION: This setup MUST complete before ANY other workflow steps. Do NOT:

• Ask about reference images
• Ask about content/article
• Ask about type or style preferences
• Proceed to content analysis

ONLY ask the questions in this setup flow, save EXTEND.md, then continue.

Setup Flow

No EXTEND.md found
        │
        ▼
┌─────────────────────┐
│ AskUserQuestion     │
│ (all questions)     │
└─────────────────────┘
        │
        ▼
┌─────────────────────┐
│ Create EXTEND.md    │
└─────────────────────┘
        │
        ▼
    Continue to Step 1

Questions

Language: Use user's input language or preferred language for all questions. Do not always use English.

Use single AskUserQuestion with multiple questions (AskUserQuestion auto-adds "Other" option):

Question 1: Watermark

header: "Watermark"
question: "Watermark text for generated illustrations? Type your watermark content (e.g., name, @handle)"
options:
  - label: "No watermark (Recommended)"
    description: "No watermark, can enable later in EXTEND.md"

Position defaults to bottom-right.

Question 2: Preferred Style

header: "Style"
question: "Default illustration style preference? Or type another style name or your custom style"
options:
  - label: "None (Recommended)"
    description: "Auto-select based on content analysis"
  - label: "notion"
    description: "Minimalist hand-drawn line art"
  - label: "warm"
    description: "Friendly, approachable, personal"

Question 3: Save Location

header: "Save"
question: "Where to save preferences?"
options:
  - label: "Project"
    description: ".baoyu-skills/ (this project only)"
  - label: "User"
    description: "~/.baoyu-skills/ (all projects)"

Save Locations

After Setup

1. Create directory if needed 2. Write EXTEND.md with frontmatter 3. Confirm: "Preferences saved to [path]" 4. Continue to Step 1

EXTEND.md Template

---
version: 1
watermark:
  enabled: [true/false]
  content: "[user input or empty]"
  position: bottom-right
  opacity: 0.7
preferred_style:
  name: [selected style or null]
  description: ""
language: null
custom_styles: []
---

Modifying Preferences Later

Users can edit EXTEND.md directly or run setup again:

• Delete EXTEND.md to trigger setup
• Edit YAML frontmatter for quick changes
• Full schema: config/preferences-schema.md

Preferences Schema

Full Schema

---
version: 1

watermark:
  enabled: false
  content: ""
  position: bottom-right  # bottom-right|bottom-left|bottom-center|top-right

preferred_style:
  name: null              # Built-in or custom style name
  description: ""         # Override/notes

language: null            # zh|en|ja|ko|auto

default_output_dir: null  # same-dir|illustrations-subdir|independent

custom_styles:
  - name: my-style
    description: "Style description"
    color_palette:
      primary: ["#1E3A5F", "#4A90D9"]
      background: "#F5F7FA"
      accents: ["#00B4D8", "#48CAE4"]
    visual_elements: "Clean lines, geometric shapes"
    typography: "Modern sans-serif"
    best_for: "Business, education"
---

Field Reference

Position Options

Output Directory Options

Custom Style Fields

Example: Minimal Preferences

---
version: 1
watermark:
  enabled: true
  content: "@myusername"
preferred_style:
  name: notion
---

Example: Full Preferences

---
version: 1
watermark:
  enabled: true
  content: "@myaccount"
  position: bottom-right

preferred_style:
  name: notion
  description: "Clean illustrations for tech articles"

language: zh

custom_styles:
  - name: corporate
    description: "Professional B2B style"
    color_palette:
      primary: ["#1E3A5F", "#4A90D9"]
      background: "#F5F7FA"
      accents: ["#00B4D8", "#48CAE4"]
    visual_elements: "Clean lines, subtle gradients, geometric shapes"
    typography: "Modern sans-serif, professional"
    best_for: "Business, SaaS, enterprise"
---

Prompt Construction

Prompt File Format

Each prompt file uses YAML frontmatter + content:

---
illustration_id: 01
type: infographic
style: blueprint
references:                    # ⚠️ ONLY if files EXIST in references/ directory
  - ref_id: 01
    filename: 01-ref-diagram.png
    usage: direct              # direct | style | palette
---

[Type-specific template content below...]

⚠️ CRITICAL - When to include `references` field:

Reference Usage Types (only when file exists):

If no reference file but style/palette extracted verbally, append directly to prompt body:

COLORS (from reference):
- Primary: #E8756D coral
- Secondary: #7ECFC0 mint
...

STYLE (from reference):
- Clean lines, minimal shadows
- Gradient backgrounds
...

---

Default Composition Requirements

Apply to ALL prompts by default:

Add to ALL prompts:

Clean composition with generous white space. Simple or no background. Main elements centered or positioned by content needs.

---

Character Rendering

When depicting people:

Add to ALL prompts with human figures:

Human figures: simplified stylized silhouettes or symbolic representations, not photorealistic.

---

Text in Illustrations

Add to prompts with text:

Text should be large and prominent with handwritten-style fonts. Keep minimal, focus on keywords.

---

Principles

Good prompts must include:

1. Layout Structure First: Describe composition, zones, flow direction 2. Specific Data/Labels: Use actual numbers, terms from article 3. Visual Relationships: How elements connect 4. Semantic Colors: Meaning-based color choices (red=warning, green=efficient) 5. Style Characteristics: Line treatment, texture, mood 6. Aspect Ratio: End with ratio and complexity level

Type-Specific Templates

Infographic

[Title] - Data Visualization

Layout: [grid/radial/hierarchical]

ZONES:
- Zone 1: [data point with specific values]
- Zone 2: [comparison with metrics]
- Zone 3: [summary/conclusion]

LABELS: [specific numbers, percentages, terms from article]
COLORS: [semantic color mapping]
STYLE: [style characteristics]
ASPECT: 16:9

Infographic + vector-illustration:

Flat vector illustration infographic. Clean black outlines on all elements.
COLORS: Cream background (#F5F0E6), Coral Red (#E07A5F), Mint Green (#81B29A), Mustard Yellow (#F2CC8F)
ELEMENTS: Geometric simplified icons, no gradients, playful decorative elements (dots, stars)

Scene

[Title] - Atmospheric Scene

FOCAL POINT: [main subject]
ATMOSPHERE: [lighting, mood, environment]
MOOD: [emotion to convey]
COLOR TEMPERATURE: [warm/cool/neutral]
STYLE: [style characteristics]
ASPECT: 16:9

Flowchart

[Title] - Process Flow

Layout: [left-right/top-down/circular]

STEPS:
1. [Step name] - [brief description]
2. [Step name] - [brief description]
...

CONNECTIONS: [arrow types, decision points]
STYLE: [style characteristics]
ASPECT: 16:9

Flowchart + vector-illustration:

Flat vector flowchart with bold arrows and geometric step containers.
COLORS: Cream background (#F5F0E6), steps in Coral/Mint/Mustard, black outlines
ELEMENTS: Rounded rectangles, thick arrows, simple icons per step

Comparison

[Title] - Comparison View

LEFT SIDE - [Option A]:
- [Point 1]
- [Point 2]

RIGHT SIDE - [Option B]:
- [Point 1]
- [Point 2]

DIVIDER: [visual separator]
STYLE: [style characteristics]
ASPECT: 16:9

Comparison + vector-illustration:

Flat vector comparison with split layout. Clear visual separation.
COLORS: Left side Coral (#E07A5F), Right side Mint (#81B29A), cream background
ELEMENTS: Bold icons, black outlines, centered divider line

Framework

[Title] - Conceptual Framework

STRUCTURE: [hierarchical/network/matrix]

NODES:
- [Concept 1] - [role]
- [Concept 2] - [role]

RELATIONSHIPS: [how nodes connect]
STYLE: [style characteristics]
ASPECT: 16:9

Framework + vector-illustration:

Flat vector framework diagram with geometric nodes and bold connectors.
COLORS: Cream background (#F5F0E6), nodes in Coral/Mint/Mustard/Blue, black outlines
ELEMENTS: Rounded rectangles or circles for nodes, thick connecting lines

Timeline

[Title] - Chronological View

DIRECTION: [horizontal/vertical]

EVENTS:
- [Date/Period 1]: [milestone]
- [Date/Period 2]: [milestone]

MARKERS: [visual indicators]
STYLE: [style characteristics]
ASPECT: 16:9

What to Avoid

• Vague descriptions ("a nice image")
• Literal metaphor illustrations
• Missing concrete labels/annotations
• Generic decorative elements

Watermark Integration

If watermark enabled in preferences, append:

Include a subtle watermark "[content]" positioned at [position] with approximately [opacity*100]% visibility.

Style Reference

Core Styles

Simplified style tier for quick selection:

Use Core Styles for most cases. See full Style Gallery below for granular control.

---

Style Gallery

Full specifications: references/styles/<style>.md

Type × Style Compatibility Matrix

✓✓ = highly recommended | ✓ = compatible | ✗ = not recommended

Auto Selection by Type

Auto Selection by Content Signals

Style Characteristics by Type

infographic + vector-illustration

• Clean flat vector shapes, bold geometric forms
• Vibrant but harmonious color palette
• Clear visual hierarchy with icons and labels
• Modern, professional, highly readable
• Perfect for knowledge articles and tutorials

flowchart + vector-illustration

• Bold arrows and connectors
• Distinct step containers with icons
• Clean progression flow
• High contrast for readability

comparison + vector-illustration

• Split layout with clear visual separation
• Bold iconography for each side
• Color-coded distinctions
• Easy at-a-glance comparison

framework + vector-illustration

• Geometric node representations
• Clear hierarchical structure
• Bold connecting lines
• Modern system diagram aesthetic

infographic + blueprint

• Technical precision, schematic lines
• Grid-based layout, clear zones
• Monospace labels, data-focused
• Blue/white color scheme

infographic + notion

• Hand-drawn feel, approachable
• Soft icons, rounded elements
• Neutral palette, clean backgrounds
• Perfect for SaaS/productivity

scene + warm

• Golden hour lighting, cozy atmosphere
• Soft gradients, natural textures
• Inviting, personal feeling
• Great for storytelling

scene + watercolor

• Artistic, painterly effect
• Soft edges, color bleeding
• Dreamy, creative mood
• Best for lifestyle/travel

flowchart + notion

• Clear step indicators
• Simple arrow connections
• Minimal decoration
• Focus on process clarity

flowchart + blueprint

• Technical precision
• Detailed connection points
• Engineering aesthetic
• For complex systems

comparison + elegant

• Refined dividers
• Balanced typography
• Professional appearance
• Business comparisons

framework + blueprint

• Precise node connections
• Hierarchical clarity
• System architecture feel
• Technical frameworks

timeline + elegant

• Sophisticated markers
• Refined typography
• Historical gravitas
• Professional presentations

timeline + warm

• Friendly progression
• Organic flow
• Personal journey feel
• Growth narratives

blueprint

Precise technical blueprint style with engineering precision

Design Aesthetic

Clean, structured visual metaphors using blueprints, diagrams, and schematics. Precise, analytical and aesthetically refined. Information presented in grid-based layouts with engineering precision. Technical drawing quality with professional polish.

Background

• Color: Blueprint Off-White (#FAF8F5)
• Texture: Subtle grid overlay, engineering paper feel

Color Palette

Visual Elements

• Precise lines with consistent stroke weights
• Technical schematics and clean vector graphics
• Thin line work in technical drawing style
• Connection lines: straight or 90-degree angles only
• Data visualization with minimal charts
• Dimension lines and measurement indicators
• Cross-section style diagrams
• Isometric or orthographic projections

Style Rules

Do

• Maintain consistent line weights
• Use grid alignment for all elements
• Keep color palette restrained
• Create clear visual hierarchy through scale
• Use geometric precision for all shapes

Don't

• Use hand-drawn or organic shapes
• Add decorative flourishes
• Use curved connection lines
• Include photographic elements
• Add unnecessary embellishments

Best For

Technical architecture, system design, data analysis, engineering documentation, process flows, infrastructure articles

chalkboard

Black chalkboard background with colorful chalk drawing style

Design Aesthetic

Classic classroom chalkboard aesthetic with hand-drawn chalk illustrations. Nostalgic educational feel with imperfect, sketchy lines that capture the warmth of traditional teaching. Colorful chalk creates visual hierarchy while maintaining the authentic chalkboard experience.

Background

• Color: Chalkboard Black (#1A1A1A) or Dark Green-Black (#1C2B1C)
• Texture: Realistic chalkboard texture with subtle scratches, dust particles, and faint eraser marks

Typography

Hand-drawn chalk lettering style with visible chalk texture. Imperfect baseline adds authenticity. White or bright colored chalk for emphasis.

Color Palette

Visual Elements

• Hand-drawn chalk illustrations with sketchy, imperfect lines
• Chalk dust effects around text and key elements
• Doodles: stars, arrows, underlines, circles, checkmarks
• Mathematical formulas and simple diagrams
• Eraser smudges and chalk residue textures
• Wooden frame border optional
• Stick figures and simple icons
• Connection lines with hand-drawn feel

Style Rules

Do

• Maintain authentic chalk texture on all elements
• Use imperfect, hand-drawn quality throughout
• Add subtle chalk dust and smudge effects
• Create visual hierarchy with color variety
• Include playful doodles and annotations

Don't

• Use perfect geometric shapes
• Create clean digital-looking lines
• Add photorealistic elements
• Use gradients or glossy effects
• Make it look computerized

Best For

Educational articles, tutorials, teaching content, workshops, informal learning, knowledge sharing, how-to guides, classroom-style explanations

editorial

Magazine-style editorial infographic for professional content

Design Aesthetic

High-quality magazine explainer aesthetic. Clear visual storytelling with structured layouts and professional typography. Think Wired, The Verge, or quality science publications. Complex information made digestible.

Background

• Color: Pure White (#FFFFFF) or Light Gray (#F8F9FA)
• Texture: None or subtle paper grain

Color Palette

Visual Elements

• Clean flat illustrations
• Structured multi-section layouts
• Callout boxes for insights
• Icon-based visualizations
• Visual metaphors for concepts
• Flow diagrams with hierarchy
• Pull quotes and highlights
• Clear section dividers

Style Rules

Do

• Create clear narrative flow
• Use structured layouts
• Include callout boxes
• Design visual metaphors
• Maintain magazine polish

Don't

• Use photographic imagery
• Create cluttered layouts
• Mix too many styles
• Add purposeless decoration
• Compromise clarity for style

Best For

Technology explainers, science communication, research articles, policy analysis, investigative pieces, thought leadership, long-form journalism

elegant

Refined, sophisticated illustration style for professional content

Design Aesthetic

Elegant and refined visual approach with sophisticated color palette. Professional polish with subtle artistic touches. Emphasizes clarity and thoughtful composition. Conveys authority and trustworthiness without being cold or clinical.

Background

• Color: Warm Cream (#F5F0E6) or Soft Beige (#FAF6F0)
• Texture: Subtle paper texture, very light grain

Color Palette

Visual Elements

• Delicate line work with refined strokes
• Subtle icons with balanced weight
• Graceful curves and flowing compositions
• Soft gradients with smooth transitions
• Balanced whitespace and breathing room
• Thin borders and elegant dividers
• Subtle drop shadows for depth

Style Rules

Do

• Use refined color combinations
• Create balanced, harmonious compositions
• Keep elements light and airy
• Use subtle gradients sparingly
• Maintain generous margins

Don't

• Use harsh contrasts
• Overcrowd the composition
• Add playful or casual elements
• Use neon or overly bright colors
• Create busy or cluttered layouts

Best For

Professional articles, thought leadership pieces, business topics, executive communications, corporate blogs, strategy discussions, industry analysis

fantasy-animation

Whimsical hand-drawn animation style inspired by Ghibli/Disney

Design Aesthetic

Charming hand-drawn animation aesthetic reminiscent of classic Disney, Studio Ghibli, or European storybook illustration. Soft, painterly textures with warm, inviting colors. Friendly characters, magical elements, and storybook feel. Enchanting, nostalgic, and emotionally engaging.

Background

• Color: Soft Sky Blue (#E8F4FC) or Warm Cream (#FFF8E7)
• Texture: Subtle watercolor wash, soft brush strokes

Color Palette

Visual Elements

• Central illustrated character (friendly, expressive)
• Small companion creatures (animals, magical beings)
• Storybook-style environment backgrounds
• Magical floating objects (books, orbs, sparkles)
• Decorative elements: stars, flowers, leaves
• Soft shadows and gentle highlights
• Layered depth with foreground/background

Style Rules

Do

• Create warm, inviting compositions
• Use soft edges and painterly textures
• Include charming character illustrations
• Add magical decorative touches
• Maintain storybook narrative feel

Don't

• Use harsh geometric shapes
• Create dark or intimidating imagery
• Add photorealistic elements
• Use cold color palettes
• Make it look digital/computerized

Best For

Educational content, children's articles, storytelling, creative topics, fantasy/gaming, inspirational pieces, family-friendly content

flat-doodle

Cute flat doodle illustration style with bold outlines

Design Aesthetic

Cheerful and approachable visual style combining flat design with doodle charm. Features bold black outlines around simple shapes. Bright pastel colors with no gradients or shading. Cute rounded proportions that feel friendly. Clean white backgrounds create focus and clarity.

Background

• Color: Clean White (#FFFFFF)
• Texture: None - pure white isolated background

Color Palette

Visual Elements

• Bold black outlines around all shapes
• Simple flat color fills
• Cute rounded proportions
• Minimal geometric shapes
• Productivity icons (laptops, calendars, checkmarks)
• Isolated elements on white
• No shading or gradients
• Hand-drawn quality with clean edges

Style Rules

Do

• Use bold black outlines consistently
• Keep shapes simple and rounded
• Use bright pastel palette
• Isolate elements on white background
• Maintain cute proportions
• Keep minimal shading

Don't

• Add shadows or depth effects
• Use gradients or textures
• Create complex detailed illustrations
• Overlap too many elements
• Use dark or moody backgrounds
• Add realistic proportions

Best For

Productivity articles, SaaS and app content, workflow tutorials, beginner guides, casual business content, tool introductions, lifestyle productivity

flat

Modern flat vector illustration style for contemporary content

Design Aesthetic

Contemporary flat design aesthetic with bold shapes and limited depth. Clean geometric forms with no gradients or shadows. Modern, accessible, and highly readable. Optimized for digital consumption with scalable vector quality.

Background

• Color: White (#FFFFFF) or Soft Gray (#F5F5F5)
• Texture: None - clean solid backgrounds

Color Palette

Visual Elements

• Bold geometric shapes
• Flat color fills with no gradients
• Simple character illustrations
• Clean icon designs
• Minimal line work
• Overlapping shape compositions
• Abstract concept visualizations
• Consistent stroke weights

Style Rules

Do

• Use flat solid colors
• Create clean geometric shapes
• Keep elements simple
• Maintain consistent styling
• Use bold color combinations

Don't

• Add shadows or depth
• Use gradients or textures
• Create realistic illustrations
• Add unnecessary details
• Use photographic elements

Best For

Modern articles, app and product content, startup stories, digital topics, contemporary business, tech company blogs, social media content

intuition-machine

Technical briefing infographic style with aged paper and bilingual labels

Design Aesthetic

Academic/technical briefing style with clean 2D or isometric technical illustrations. Information-dense but organized with clear visual hierarchy. Vintage blueprint aesthetic with modern clarity. Multiple explanatory elements with bilingual callouts.

Background

• Color: Aged Cream (#F5F0E6)
• Texture: Subtle paper texture with light creases, vintage technical print feel

Color Palette

Visual Elements

• Isometric 3D or flat 2D technical diagrams
• Explanatory text boxes with labeled content
• Bilingual callout labels (English + Chinese)
• Faded thematic background patterns
• Clean black outlines on elements
• Split or triptych layouts
• Key insight boxes

Style Rules

Do

• Include multiple text boxes with content
• Use bilingual labels for key elements
• Add faded thematic background patterns
• Maintain aged paper texture
• Create clear visual hierarchy

Don't

• Create photorealistic 3D renders
• Leave illustrations without explanatory text
• Add stamps or watermarks in corners
• Use gradients or glossy effects
• Make it look too modern/digital

Best For

Technical explanations, concept breakdowns, academic content, research summaries, bilingual audiences, knowledge documentation

minimal

Ultra-clean, zen-like illustration style for focused content

Design Aesthetic

Maximum simplicity with purposeful restraint. Every element serves a function. Zen-like calm and focus through extensive negative space. Single focal point approach that guides attention naturally. Quiet elegance through reduction.

Background

• Color: Pure White (#FFFFFF) or Off-White (#FAFAFA)
• Texture: None - clean solid backgrounds

Color Palette

Note: Accent color is derived from content context. Use sparingly.

Visual Elements

• Single focal element per illustration
• Maximum negative space
• Thin, precise lines
• Simple geometric forms
• Subtle shadows if any
• Typography as primary element
• Strategic use of single accent
• Clean, uncluttered compositions

Style Rules

Do

• Embrace empty space
• Use single focal points
• Keep lines thin and precise
• Let content breathe
• Question every element

Don't

• Add decorative elements
• Use multiple accent colors
• Fill available space
• Add textures or patterns
• Create visual complexity

Best For

Philosophy articles, minimalism content, focused explanations, meditation and mindfulness, essential concepts, clarity-focused writing

nature

Organic, earthy illustration style for environmental and wellness content

Design Aesthetic

Natural and organic visual approach inspired by the outdoors. Earth tones and natural textures that evoke calm and connection to nature. Flowing lines and organic shapes. Creates a sense of tranquility and environmental awareness.

Background

• Color: Sand Beige (#F5E6D3) or Sky Blue wash (#E0F2FE)
• Texture: Natural paper texture with organic feel

Color Palette

Visual Elements

• Leaf and plant motifs
• Tree and branch silhouettes
• Mountain and landscape shapes
• Organic flowing lines
• Natural textures (wood grain, stone)
• Water and wave patterns
• Animal silhouettes
• Sun and moon symbols

Style Rules

Do

• Use earth-inspired colors
• Create organic, flowing shapes
• Include nature elements
• Evoke outdoor atmosphere
• Maintain calm and balance

Don't

• Use synthetic or neon colors
• Create rigid geometric shapes
• Add tech or digital elements
• Use stark contrasts
• Overcomplicate compositions

Best For

Sustainability articles, wellness content, outdoor topics, slow living, environmental issues, health and fitness, gardening, travel nature pieces

notion

Minimalist hand-drawn line art style for knowledge content (Default)

Design Aesthetic

Clean, minimalist hand-drawn line art with intellectual feel. Simple doodle-style illustrations with intentional wobble. Maximum whitespace with single concept focus. Notion-like aesthetic that feels thoughtful and organized.

Background

• Color: Pure White (#FFFFFF) or Off-White (#FAFAFA)
• Texture: None - clean solid backgrounds

Color Palette

Visual Elements

• Simple line doodles
• Hand-drawn wobble effect
• Basic geometric shapes
• Stick figures for people
• Conceptual icons
• Clean hand-drawn lettering
• Minimal decorative elements
• Single-weight line work

Style Rules

Do

• Use maximum whitespace
• Keep illustrations simple
• Add slight hand-drawn wobble
• Focus on single concepts
• Use pastel accents sparingly

Don't

• Create complex illustrations
• Use many colors at once
• Add detailed textures
• Make precise geometric shapes
• Overcrowd the composition

Best For

Knowledge sharing, concept explanations, SaaS content, productivity articles, educational posts, how-to guides, professional blogs

pixel-art

Retro 8-bit pixel art aesthetic with nostalgic gaming style

Design Aesthetic

Pixelated retro aesthetic reminiscent of classic 8-bit and 16-bit era games. Chunky pixels, limited color palettes, and nostalgic gaming references. Simple geometric shapes rendered in blocky pixel form. Fun, playful, and immediately recognizable retro tech aesthetic.

Background

• Color: Light Blue (#87CEEB) or Soft Lavender (#E6E6FA)
• Texture: Subtle pixel grid pattern, optional CRT scanline effect

Color Palette

Visual Elements

• All elements rendered with visible pixel structure
• Simple iconography: notepad, checkboxes, gears, rockets
• Text bubbles with pixel borders
• 8-bit decorations: stars, hearts, arrows
• Progress bars with chunky pixel segments
• Dithering patterns for color transitions
• Limited 16-32 color palette

Style Rules

Do

• Maintain consistent pixel grid throughout
• Use limited color palette (16-32 colors max)
• Create blocky, geometric shapes
• Add nostalgic gaming references
• Use dithering for color transitions

Don't

• Use smooth gradients or anti-aliasing
• Create photorealistic elements
• Use thin lines or fine details
• Add modern glossy effects
• Break the pixel grid alignment

Best For

Gaming articles, tech tutorials, nostalgic content, developer topics, retro-themed pieces, creative tech content

playful

Fun, creative illustration style for casual and educational content

Design Aesthetic

Whimsical and entertaining visual approach that sparks joy. Pastel colors with bright pops of energy. Doodle-like quality that feels approachable and fun. Creates a sense of play and discovery. Encourages engagement through visual delight.

Background

• Color: Light Cream (#FFFBEB) or Soft White (#FFF)
• Texture: Subtle, playful pattern or clean

Color Palette

Visual Elements

• Doodles and sketchy lines
• Star and sparkle decorations
• Swirls and curvy elements
• Cute character illustrations
• Speech bubbles and callouts
• Emoji-style icons
• Confetti and celebration marks
• Playful hand-lettering

Style Rules

Do

• Use varied pastel palette
• Add whimsical decorations
• Create friendly characters
• Include playful details
• Keep energy high and positive

Don't

• Use dark or moody colors
• Create serious compositions
• Add corporate elements
• Use rigid geometric shapes
• Make it feel professional

Best For

Tutorials and guides, beginner-friendly content, casual articles, fun topics, children's content, hobby-related posts, entertaining explanations

retro

80s/90s nostalgic aesthetic with vibrant colors and geometric patterns

Design Aesthetic

Nostalgic retro aesthetic inspired by 80s and 90s design trends. Vibrant neon colors, geometric patterns, and Memphis design influence. Energetic, fun, and unapologetically bold. Perfect for content that embraces nostalgia or playful energy.

Background

• Color: Deep Purple (#2D1B4E) or Dark Teal (#0F4C5C)
• Texture: Subtle grid patterns or geometric shapes

Color Palette

Visual Elements

• Geometric patterns (triangles, circles)
• Grid backgrounds and lines
• Neon glow effects
• Memphis design shapes
• Zigzag and wavy patterns
• Retro computer graphics
• Bold outline strokes
• Gradient sunsets

Style Rules

Do

• Use bold neon colors
• Create geometric patterns
• Add retro typography
• Include Memphis-style shapes
• Embrace maximalism

Don't

• Use muted or subtle colors
• Create minimal compositions
• Add modern flat design
• Make it look contemporary
• Use understated elements

Best For

Pop culture articles, gaming content, music and entertainment, nostalgia pieces, youth-focused content, creative industry, party and event content

scientific

Academic scientific illustration style for technical diagrams and processes

Design Aesthetic

Academic scientific illustration aesthetic for biological, chemical, and technical diagrams. Clean, precise diagrams with proper labeling and clear visual flow. Educational clarity with professional polish. Textbook quality illustrations.

Background

• Color: Off-White (#FAFAFA) or Light Blue-Gray (#F0F4F8)
• Texture: None or subtle paper grain

Color Palette

Visual Elements

• Precise labeled diagrams
• Flow arrows showing direction
• Modular components with colors
• Chemical formulas and notation
• Cross-section views
• Numbered step sequences
• Molecule and cell representations
• Process summary boxes

Style Rules

Do

• Use precise consistent lines
• Label all components clearly
• Show directional flow
• Include technical notation
• Create clear numbered sequences

Don't

• Use decorative elements
• Create imprecise diagrams
• Omit important labels
• Use inconsistent styling
• Add artistic flourishes

Best For

Biology articles, chemistry explanations, medical content, research summaries, academic writing, technical documentation, process explanations

sketch-notes

Soft hand-drawn illustration style with warm, educational feel

Design Aesthetic

Hand-drawn feel with soft, relaxed brush strokes. Fresh, refined style with minimalist editorial approach. Emphasis on precision, clarity and intelligent elegance while prioritizing warmth, approachability and friendliness.

Background

• Color: Warm Off-White (#FAF8F0)
• Texture: Subtle paper grain, warm tone

Color Palette

Visual Elements

• Connection lines with hand-drawn wavy feel
• Conceptual abstract icons illustrating ideas
• Color fills don't completely fill outlines (hand-painted feel)
• Simple geometric shapes with rounded corners
• Arrows and pointers with sketchy style
• Doodle decorations: stars, spirals, underlines

Style Rules

Do

• Keep layouts open and well-structured
• Emphasize information hierarchy
• Use hand-drawn quality for all elements
• Allow imperfection (slight wobbles add character)
• Layer elements with subtle overlaps

Don't

• Use perfect geometric shapes
• Create photorealistic elements
• Overcrowd with too many elements
• Use pure white backgrounds
• Make it look computer-generated

Best For

Educational content, knowledge sharing, technical explanations, tutorials, onboarding materials, friendly articles

sketch

Raw, authentic notebook-style illustration for ideas and processes

Design Aesthetic

Hand-drawn sketch aesthetic that feels authentic and in-progress. Pencil-on-paper quality with intentional imperfection. Suggests thinking, brainstorming, and creative exploration. Raw and honest visual approach that invites collaboration.

Background

• Color: Off-White Paper (#F7FAFC) or Cream (#FAFAFA)
• Texture: Paper texture with visible grain

Color Palette

Visual Elements

• Rough sketch lines with natural variation
• Arrows and directional pointers
• Handwritten labels and notes
• Crossed-out marks and corrections
• Underlines and emphasis marks
• Simple diagram shapes
• Margin notes style
• Quick icon sketches

Style Rules

Do

• Use pencil-like line quality
• Include natural imperfections
• Add handwritten annotations
• Create diagram-style layouts
• Show thinking process

Don't

• Use perfect geometric shapes
• Add polished or refined elements
• Create colorful compositions
• Use digital effects
• Make it look finished

Best For

Ideas in progress, brainstorming articles, thought processes, concept exploration, draft-stage thinking, planning content, problem-solving pieces

vector-illustration

Flat vector illustration style with clear black outlines and retro soft colors

Design Aesthetic

Flat vector illustration with no gradients or 3D effects. Clear, uniform-thickness black outlines on all elements. Geometric simplification reducing complex objects to basic shapes. Toy model aesthetic that's cute, playful, and approachable. Coloring book style with closed outlines.

Background

• Color: Cream Off-White (#F5F0E6)
• Texture: Subtle paper texture, warm nostalgic feel

Color Palette

Visual Elements

• All objects have closed black outlines (coloring book style)
• Rounded line endings, avoid sharp corners
• Trees simplified to lollipop or triangle shapes
• Buildings as rectangular blocks with grid windows
• Depth through layering and overlap
• Decorative elements: sunbursts, pill-shaped clouds, dots, stars
• People as simple geometric figures

Style Rules

Do

• Maintain consistent outline thickness
• Use soft, vintage color palette
• Simplify objects to basic geometric shapes
• Create depth through layering
• Add playful decorative elements

Don't

• Use gradients or realistic shading
• Create photorealistic elements
• Use thin or varying line weights
• Include complex detailed illustrations
• Add textures inside shapes

Best For

Educational content, creative articles, children's content, brand showcases, explainer pieces, warm approachable topics

vintage

Nostalgic aged-paper aesthetic for historical and heritage content

Design Aesthetic

Nostalgic vintage aesthetic with aged paper textures and historical document styling. Explorer's journal and antique map quality. Rich warm tones with weathered textures. Evokes discovery, heritage, and timeless knowledge.

Background

• Color: Aged Parchment (#F5E6D3) or Sepia Cream (#FFF8DC)
• Texture: Heavy aged paper texture with subtle stains and worn edges

Color Palette

Visual Elements

• Antique map styling with route lines
• Compass roses and navigation elements
• Specimen-style drawings
• Handwritten annotations
• Rope, leather, brass decorative motifs
• Vintage photograph frames
• Aged paper edge effects
• Historical document styling

Style Rules

Do

• Apply consistent aged texture
• Use period-appropriate styling
• Include map and journey elements
• Create layered compositions
• Maintain warm sepia tones

Don't

• Use modern digital styling
• Create crisp clean edges
• Use cold or bright colors
• Add contemporary elements
• Make it look new or fresh

Best For

Historical articles, travel and exploration, biography pieces, heritage stories, scientific discovery narratives, museum-style content, classic literature references

warm

Friendly, approachable illustration style for human-centered content

Design Aesthetic

Warm and inviting visual approach that feels personal and approachable. Soft, friendly colors that evoke comfort and connection. Emphasizes human elements and emotional resonance. Creates an atmosphere of trust and openness.

Background

• Color: Cream (#FFFAF0) or Soft Peach (#FED7AA)
• Texture: Soft paper texture with warm undertones

Color Palette

Visual Elements

• Rounded shapes and soft corners
• Friendly character illustrations
• Sun rays and warm light motifs
• Heart symbols and care icons
• Cozy lighting effects
• Gentle gradients with warmth
• Soft shadows without harsh edges
• Hand-drawn quality touches

Style Rules

Do

• Use warm, inviting colors
• Create rounded, friendly shapes
• Include human-centered elements
• Evoke feelings of comfort
• Maintain soft, gentle contrasts

Don't

• Use cold or stark colors
• Create sharp, aggressive shapes
• Add technical or clinical elements
• Use dark, moody backgrounds
• Create sterile compositions

Best For

Personal growth articles, lifestyle content, education, human interest stories, wellness topics, relationship advice, self-help content, community building

watercolor

Soft, artistic watercolor illustration style with natural warmth

Design Aesthetic

Gentle watercolor aesthetic with visible brush strokes and natural color bleeding. Hand-painted feel with soft edges and organic shapes. Warm, approachable, and artistically refined. Combines artistic expression with clear visual communication.

Background

• Color: Warm Off-White (#FAF8F0) or Soft Cream (#FFF9E6)
• Texture: Subtle watercolor paper texture with visible grain

Color Palette

Visual Elements

• Watercolor washes as backgrounds
• Illustrated elements with visible brush strokes
• Natural elements: leaves, flowers, bubbles
• Color bleeds and soft edges
• Hand-drawn arrows and lines
• Layered wash effects
• Soft gradients through water
• Expressive character illustrations

Style Rules

Do

• Allow color to bleed beyond edges
• Use visible brush stroke textures
• Create soft, organic shapes
• Include hand-drawn quality
• Maintain warm color palette

Don't

• Use sharp geometric shapes
• Create hard digital edges
• Use cold or stark colors
• Add photographic elements
• Create overly precise illustrations

Best For

Lifestyle articles, wellness content, travel pieces, food and cooking, personal stories, creative topics, artistic portfolios, warm educational content

Usage

Command Syntax

# Auto-select type and style based on content
/baoyu-article-illustrator path/to/article.md

# Specify type
/baoyu-article-illustrator path/to/article.md --type infographic

# Specify style
/baoyu-article-illustrator path/to/article.md --style blueprint

# Combine type and style
/baoyu-article-illustrator path/to/article.md --type flowchart --style notion

# Specify density
/baoyu-article-illustrator path/to/article.md --density rich

# Direct content input (paste mode)
/baoyu-article-illustrator
[paste content]

Options

Input Modes

Output Directory Options

Configure in EXTEND.md: default_output_dir: illustrations-subdir

Examples

Technical article with data:

/baoyu-article-illustrator api-design.md --type infographic --style blueprint

Personal story:

/baoyu-article-illustrator journey.md --type scene --style warm

Tutorial with steps:

/baoyu-article-illustrator how-to-deploy.md --type flowchart --density rich

Detailed Workflow Procedures

Step 1: Pre-check

1.0 Detect & Save Reference Images ⚠️ REQUIRED if images provided

Check if user provided reference images. Handle based on input type:

CRITICAL: Only add references to prompt frontmatter if files are ACTUALLY SAVED to references/ directory.

If user provides file path: 1. Copy to references/NN-ref-{slug}.png 2. Create description: references/NN-ref-{slug}.md 3. Verify files exist before proceeding

If user can't provide path (extracted verbally): 1. Analyze image visually, extract: colors, style, composition 2. Create references/extracted-style.md with extracted info 3. DO NOT add references to prompt frontmatter 4. Instead, append extracted style/colors directly to prompt text

Description File Format (only when file saved):

---
ref_id: NN
filename: NN-ref-{slug}.png
---
[User's description or auto-generated description]

Verification (only for saved files):

Reference Images Saved:
- 01-ref-{slug}.png ✓ (can use --ref)
- 02-ref-{slug}.png ✓ (can use --ref)

Or for extracted style:

Reference Style Extracted (no file):
- Colors: #E8756D coral, #7ECFC0 mint...
- Style: minimal flat vector, clean lines...
→ Will append to prompt text (not --ref)

---

1.1 Determine Input Type

Backup rule for pasted content: If source.md exists in target directory, rename to source-backup-YYYYMMDD-HHMMSS.md before saving.

1.2-1.4 Configuration (file path input only)

Check preferences and existing state, then ask ALL needed questions in ONE AskUserQuestion call (max 4 questions).

Questions to include (skip if preference exists or not applicable):

Preference Values (if configured, skip asking):

1.5 Load Preferences (EXTEND.md) ⛔ BLOCKING

CRITICAL: If EXTEND.md not found, MUST complete first-time setup before ANY other questions or steps. Do NOT proceed to reference images, do NOT ask about content, do NOT ask about type/style — ONLY complete the preferences setup first.

test -f .baoyu-skills/baoyu-article-illustrator/EXTEND.md && echo "project"
test -f "$HOME/.baoyu-skills/baoyu-article-illustrator/EXTEND.md" && echo "user"

Supports: Watermark | Preferred type/style | Custom styles | Language | Output directory

---

Step 2: Setup & Analyze

2.1 Analyze Content

2.2 Extract Core Arguments

• Main thesis
• Key concepts reader needs
• Comparisons/contrasts
• Framework/model proposed

CRITICAL: If article uses metaphors (e.g., "电锯切西瓜"), do NOT illustrate literally. Visualize the underlying concept.

2.3 Identify Positions

Illustrate:

• Core arguments (REQUIRED)
• Abstract concepts
• Data comparisons
• Processes, workflows

Do NOT Illustrate:

• Metaphors literally
• Decorative scenes
• Generic illustrations

2.4 Analyze Reference Images (if provided in Step 1.0)

For each reference image:

---

Step 3: Confirm Settings ⚠️

Do NOT skip. Use ONE AskUserQuestion call with max 4 questions. Q1, Q2, Q3 are ALL REQUIRED.

Q1: Illustration Type ⚠️ REQUIRED

• [Recommended based on analysis] (Recommended)
• infographic / scene / flowchart / comparison / framework / timeline / mixed

Q2: Density ⚠️ REQUIRED - DO NOT SKIP

• minimal (1-2) - Core concepts only
• balanced (3-5) - Major sections
• per-section - At least 1 per section/chapter (Recommended)
• rich (6+) - Comprehensive coverage

Q3: Style ⚠️ REQUIRED (ALWAYS ask, even with preferred_style in EXTEND.md)

If EXTEND.md has preferred_style:

• [Custom style name + brief description] (Recommended)
• [Top compatible core style 1]
• [Top compatible core style 2]
• Other (see full Style Gallery)

If no preferred_style (present Core Styles first):

• [Best compatible core style] (Recommended)
• [Other compatible core style 1]
• [Other compatible core style 2]
• Other (see full Style Gallery)

Core Styles (simplified selection):

Style selection based on Type × Style compatibility matrix (styles.md). Full specs: styles/<style>.md

Q4: Image Text Language ⚠️ REQUIRED when article language ≠ EXTEND.md language

Detect article language from content. If different from EXTEND.md language setting, MUST ask:

• Article language (match article content) (Recommended)
• EXTEND.md language (user's general preference)

Skip only if: Article language matches EXTEND.md language, or EXTEND.md has no language setting.

Display Reference Usage (if references detected in Step 1.0)

When presenting outline preview to user, show reference assignments:

Reference Images:
| Ref | Filename | Recommended Usage |
|-----|----------|-------------------|
| 01 | 01-ref-diagram.png | direct → Illustration 1, 3 |
| 02 | 02-ref-chart.png | palette → Illustration 2 |

---

Step 4: Generate Outline

Save as outline.md:

---
type: infographic
density: balanced
style: blueprint
image_count: 4
references:                    # Only if references provided
  - ref_id: 01
    filename: 01-ref-diagram.png
    description: "Technical diagram showing system architecture"
  - ref_id: 02
    filename: 02-ref-chart.png
    description: "Color chart with brand palette"
---

## Illustration 1

**Position**: [section] / [paragraph]
**Purpose**: [why this helps]
**Visual Content**: [what to show]
**Type Application**: [how type applies]
**References**: [01]                    # Optional: list ref_ids used
**Reference Usage**: direct             # direct | style | palette
**Filename**: 01-infographic-concept-name.png

## Illustration 2
...

Requirements:

• Each position justified by content needs
• Type applied consistently
• Style reflected in descriptions
• Count matches density
• References assigned based on Step 2.4 analysis

---

Step 5: Generate Images

5.1 Create Prompts ⛔ BLOCKING

Every illustration MUST have a saved prompt file before generation begins. DO NOT skip this step.

For each illustration in the outline:

1. Create prompt file: prompts/NN-{type}-{slug}.md 2. Include YAML frontmatter:

   ---
   illustration_id: 01
   type: infographic
   style: custom-flat-vector
   ---

3. Follow type-specific template from prompt-construction.md 4. Prompt quality requirements (all REQUIRED):

• Layout: Describe overall composition (grid / radial / hierarchical / left-right / top-down)
• ZONES: Describe each visual area with specific content, not vague descriptions
• LABELS: Use actual numbers, terms, metrics, quotes from the article — NOT generic placeholders
• COLORS: Specify hex codes with semantic meaning (e.g., Coral (#E07A5F) for emphasis)
• STYLE: Describe line treatment, texture, mood, character rendering
• ASPECT: Specify ratio (e.g., 16:9)

5. Apply defaults: composition requirements, character rendering, text guidelines, watermark 6. Backup rule: If prompt file exists, rename to prompts/NN-{type}-{slug}-backup-YYYYMMDD-HHMMSS.md

Verification ⛔: Before proceeding to 5.2, confirm ALL prompt files exist:

Prompt Files:
- prompts/01-infographic-overview.md ✓
- prompts/02-infographic-distillation.md ✓
...

DO NOT pass ad-hoc inline text to --prompt without first saving prompt files. The generation command should either use --promptfiles prompts/NN-{type}-{slug}.md or read the saved file content for --prompt.

CRITICAL - References in Frontmatter:

• Only add references field if files ACTUALLY EXIST in references/ directory
• If style/palette was extracted verbally (no file), append info to prompt BODY instead
• Before writing frontmatter, verify: test -f references/NN-ref-{slug}.png

5.2 Select Generation Skill

Check available skills. If multiple, ask user.

5.3 Process References ⚠️ REQUIRED if references saved in Step 1.0

DO NOT SKIP if user provided reference images. For each illustration with references:

1. VERIFY files exist first:

   test -f references/NN-ref-{slug}.png && echo "exists" || echo "MISSING"

• If file MISSING but in frontmatter → ERROR, fix frontmatter or remove references field
• If file exists → proceed with processing

2. Read prompt frontmatter for reference info 3. Process based on usage type:

4. Check image generation skill capability:

Verification: Before generating, confirm reference processing:

Reference Processing:
- Illustration 1: using 01-ref-brand.png (direct) ✓
- Illustration 2: extracted palette from 02-ref-style.png ✓

5.4 Apply Watermark (if enabled)

Add: Include a subtle watermark "[content]" at [position].

5.5 Generate

1. For each illustration:

• Backup rule: If image file exists, rename to NN-{type}-{slug}-backup-YYYYMMDD-HHMMSS.md
• If references with direct usage: include --ref parameter
• Generate image

2. After each: "Generated X/N" 3. On failure: retry once, then log and continue

---

Step 6: Finalize

6.1 Update Article

Insert after corresponding paragraph:

![description](illustrations/{slug}/NN-{type}-{slug}.png)

Alt text: concise description in article's language.

6.2 Output Summary

Article Illustration Complete!

Article: [path]
Type: [type] | Density: [level] | Style: [style]
Location: [directory]
Images: X/N generated

Positions:
- 01-xxx.png → After "[Section]"
- 02-yyy.png → After "[Section]"

[If failures]
Failed:
- NN-zzz.png: [reason]