Article Illustrator

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

Two Dimensions

Type × Style can be freely combined. Example: --type infographic --style blueprint

Illustration Purpose

Auto-detected during content analysis. Influences type/style recommendations.

Type Gallery

Styles

See references/styles.md for:

• Core Styles: Simplified tier for quick selection (vector, minimal-flat, sci-fi, hand-drawn, editorial, scene)
• Style Gallery: Full 20+ style options with descriptions
• Auto Selection: Content signals → Type/Style recommendations
• Compatibility Matrix: Type × Style combinations

Workflow

Progress:
- [ ] Step 1: Pre-check
  - [ ] 1.5 Load preferences (EXTEND.md) ⛔ BLOCKING
  - [ ] 1.0 Reference images ⚠️ (if provided)
  - [ ] 1.2-1.4 Config questions (1 AskUserQuestion, max 4 Qs)
- [ ] Step 2: Setup & Analyze
- [ ] Step 3: Confirm Settings (1 AskUserQuestion, max 4 Qs)
  - [ ] Q1: Type ⚠️
  - [ ] Q2: Density ⚠️ MUST ASK
  - [ ] Q3: Style ⚠️
- [ ] Step 4: Generate Outline
- [ ] Step 5: Generate Images
- [ ] Step 6: Finalize

Step 1: Pre-check

1.5 Load Preferences (EXTEND.md) ⛔ BLOCKING

CRITICAL: If EXTEND.md not found, MUST complete first-time setup before ANY other steps.

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

1.0-1.4: Handle reference images, determine input type, ask config questions.

Full procedures: references/workflow.md

Step 2: Setup & Analyze

CRITICAL: If article uses metaphors, do NOT illustrate literally. Visualize the underlying concept.

Full procedures: references/workflow.md

Step 3: Confirm Settings ⚠️

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

Full procedures: references/workflow.md

Step 4: Generate Outline

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

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

Full template: references/workflow.md

Step 5: Generate Images

1. Create Prompts: Follow references/prompt-construction.md
2. Select Generation Skill: Check available skills
3. Process References: Handle direct/style/palette usage
4. Apply Watermark: If enabled in EXTEND.md
5. Generate: Sequential, retry once on failure

Full procedures: references/workflow.md

Step 6: Finalize

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

Output Summary:

Article Illustration Complete!
Article: [path] | Type: [type] | Density: [level] | Style: [style]
Images: X/N generated
Positions:
- 01-xxx.png → After "[Section]"

Output Directory

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

Slug: 2-4 word topic in kebab-case. Conflict: Append -YYYYMMDD-HHMMSS if exists.

Modification

References