jimliu avatar

Baoyu Article Illustrator

jimliu/baoyu-skills
8.9k

The Article Illustrator skill analyzes articles to identify optimal illustration positions, then generates images that maintain consistency in type and style. It supports various visual content types such as infographics, scenes, flowcharts, comparisons, frameworks, and timelines, with customizable aesthetics. Designed for content creators, it streamlines the process of visualizing key concepts and enhancing articles with tailored illustrations.

npx skills add https://github.com/jimliu/baoyu-skills --skill baoyu-article-illustrator

Article Illustrator

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

Two Dimensions

Dimension Controls Examples Type Information structure infographic, scene, flowchart, comparison, framework, timeline Style Visual aesthetics notion, warm, minimal, blueprint, watercolor, elegant Combine freely: --type infographic --style blueprint Or use presets: --preset tech-explainer → type + style in one flag. See Style Presets.

Types

Type Best For infographic Data, metrics, technical scene Narratives, emotional flowchart Processes, workflows comparison Side-by-side, options framework Models, architecture timeline History, evolution

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

# macOS, Linux, WSL, Git Bash
test -f .baoyu-skills/baoyu-article-illustrator/EXTEND.md && echo "project"
test -f "${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-article-illustrator/EXTEND.md" && echo "xdg"
test -f "$HOME/.baoyu-skills/baoyu-article-illustrator/EXTEND.md" && echo "user"

# PowerShell (Windows)
if (Test-Path .baoyu-skills/baoyu-article-illustrator/EXTEND.md) { "project" }
$xdg = if ($env:XDG_CONFIG_HOME) { $env:XDG_CONFIG_HOME } else { "$HOME/.config" }
if (Test-Path "$xdg/baoyu-skills/baoyu-article-illustrator/EXTEND.md") { "xdg" }
if (Test-Path "$HOME/.baoyu-skills/baoyu-article-illustrator/EXTEND.md") { "user" }

Result Action Found Read, parse, display summary Not found ⛔ Run first-time-setup Full procedures: references/workflow.md

Step 2: Analyze

Analysis Output Content type Technical / Tutorial / Methodology / Narrative Purpose information / visualization / imagination Core arguments 2-5 main points Positions Where illustrations add value CRITICAL: Metaphors → visualize underlying concept, NOT literal image. Full procedures: references/workflow.md

Step 3: Confirm Settings ⚠️

ONE AskUserQuestion, max 4 Qs. Q1-Q2 REQUIRED. Q3 required unless preset chosen. Q Options Q1: Preset or Type [Recommended preset], [alt preset], or manual: infographic, scene, flowchart, comparison, framework, timeline, mixed Q2: Density minimal (1-2), balanced (3-5), per-section (Recommended), rich (6+) Q3: Style [Recommended], minimal-flat, sci-fi, hand-drawn, editorial, scene, poster, Other — skip if preset chosen Q4: Language When article language ≠ EXTEND.md setting 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. Execution strategy: When multiple illustrations have saved prompt files and the task is now plain generation, prefer baoyu-image-gen batch mode (build-batch.ts → --batchfile) over spawning subagents. Use subagents only when each image still needs separate prompt iteration or creative exploration.

  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

Action Steps Edit Update prompt → Regenerate → Update reference Add Position → Prompt → Generate → Update outline → Insert Delete Delete files → Remove reference → Update outline

References

File Content references/workflow.md Detailed procedures references/usage.md Command syntax references/styles.md Style gallery references/style-presets.md Preset shortcuts (type + style) references/prompt-construction.md Prompt templates references/config/first-time-setup.md First-time setup

GitHub Owner

Owner: jimliu

GitHub Links

Files

Style Presets

styles.md

first-time-setup

workflow.md

workflow.md

workflow.md

workflow.md

prompt-construction.md

workflow.md

workflow.md

usage.md

styles.md

style-presets.md

prompt-construction.md

first-time-setup.md

SKILL.md

name: baoyu-article-illustrator description: Analyzes article structure, identifies positions requiring visual aids, generates illustrations with Type × Style two-dimension approach. Use when user asks to "illustrate article", "add images", "generate images for article", or "为文章配图". version: 1.56.1 metadata: openclaw: homepage: https://github.com/JimLiu/baoyu-skills#baoyu-article-illustrator

Article Illustrator

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

Two Dimensions

DimensionControlsExamples
TypeInformation structureinfographic, scene, flowchart, comparison, framework, timeline
StyleVisual aestheticsnotion, warm, minimal, blueprint, watercolor, elegant
Combine freely: --type infographic --style blueprint
Or use presets: --preset tech-explainer → type + style in one flag. See Style Presets.

Types

TypeBest For
infographicData, metrics, technical
sceneNarratives, emotional
flowchartProcesses, workflows
comparisonSide-by-side, options
frameworkModels, architecture
timelineHistory, evolution

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

# macOS, Linux, WSL, Git Bash
test -f .baoyu-skills/baoyu-article-illustrator/EXTEND.md && echo "project"
test -f "${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-article-illustrator/EXTEND.md" && echo "xdg"
test -f "$HOME/.baoyu-skills/baoyu-article-illustrator/EXTEND.md" && echo "user"

# PowerShell (Windows)
if (Test-Path .baoyu-skills/baoyu-article-illustrator/EXTEND.md) { "project" }
$xdg = if ($env:XDG_CONFIG_HOME) { $env:XDG_CONFIG_HOME } else { "$HOME/.config" }
if (Test-Path "$xdg/baoyu-skills/baoyu-article-illustrator/EXTEND.md") { "xdg" }
if (Test-Path "$HOME/.baoyu-skills/baoyu-article-illustrator/EXTEND.md") { "user" }
ResultAction
FoundRead, parse, display summary
Not found⛔ Run first-time-setup
Full procedures: references/workflow.md

Step 2: Analyze

AnalysisOutput
Content typeTechnical / Tutorial / Methodology / Narrative
Purposeinformation / visualization / imagination
Core arguments2-5 main points
PositionsWhere illustrations add value
CRITICAL: Metaphors → visualize underlying concept, NOT literal image.
Full procedures: references/workflow.md

Step 3: Confirm Settings ⚠️

ONE AskUserQuestion, max 4 Qs. Q1-Q2 REQUIRED. Q3 required unless preset chosen.

QOptions
Q1: Preset or Type[Recommended preset], [alt preset], or manual: infographic, scene, flowchart, comparison, framework, timeline, mixed
Q2: Densityminimal (1-2), balanced (3-5), per-section (Recommended), rich (6+)
Q3: Style[Recommended], minimal-flat, sci-fi, hand-drawn, editorial, scene, poster, Other — skip if preset chosen
Q4: LanguageWhen article language ≠ EXTEND.md setting
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. Execution strategy: When multiple illustrations have saved prompt files and the task is now plain generation, prefer baoyu-image-gen batch mode (build-batch.ts → --batchfile) over spawning subagents. Use subagents only when each image still needs separate prompt iteration or creative exploration.

  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

ActionSteps
EditUpdate prompt → Regenerate → Update reference
AddPosition → Prompt → Generate → Update outline → Insert
DeleteDelete files → Remove reference → Update outline

References

FileContent
references/workflow.mdDetailed procedures
references/usage.mdCommand syntax
references/styles.mdStyle gallery
references/style-presets.mdPreset shortcuts (type + style)
references/prompt-construction.mdPrompt templates
references/config/first-time-setup.mdFirst-time setup

More skills

J
Baoyu Cover Image

jimliu

J
Baoyu Infographic

jimliu

J
Baoyu Comic

jimliu