Smart Article Illustration Skill
Analyze article structure and content, identify positions requiring visual aids, and generate illustrations with flexible style options.
Usage
# Auto-select style based on content
/baoyu-article-illustrator path/to/article.md
# Specify a style
/baoyu-article-illustrator path/to/article.md --style tech
/baoyu-article-illustrator path/to/article.md --style warm
/baoyu-article-illustrator path/to/article.md --style minimal
# Combine with other options
/baoyu-article-illustrator path/to/article.md --style playful
Options
| Option |
Description |
--style <name> |
Specify illustration style (see Style Gallery below) |
Style Gallery
1. elegant
Refined, sophisticated, professional
- Colors: Soft coral, muted teal, dusty rose, cream background
- Elements: Delicate line work, subtle icons, balanced composition
- Best for: Professional articles, thought leadership, business topics
2. tech
Modern, futuristic, digital
- Colors: Deep blue, electric cyan, purple, dark backgrounds
- Elements: Geometric shapes, circuit patterns, data visualizations, tech icons
- Best for: AI, programming, technology, digital transformation articles
3. warm
Friendly, approachable, human-centered
- Colors: Warm orange, golden yellow, terracotta, cream
- Elements: Rounded shapes, friendly characters, sun/light motifs, hearts
- Best for: Personal growth, lifestyle, education, human interest stories
4. bold
High contrast, impactful, energetic
- Colors: Vibrant red/orange, deep black, bright yellow accents
- Elements: Strong shapes, dramatic contrast, dynamic compositions
- Best for: Opinion pieces, important warnings, call-to-action content
5. minimal
Ultra-clean, zen-like, focused
- Colors: Black, white, single accent color
- Elements: Maximum whitespace, single focal element, simple lines
- Best for: Philosophy, minimalism, focused explanations
6. playful
Fun, creative, whimsical
- Colors: Pastel rainbow, bright pops, light backgrounds
- Elements: Doodles, quirky characters, speech bubbles, emoji-style icons
- Best for: Tutorials, beginner guides, casual content, fun topics
7. nature
Organic, calm, earthy
- Colors: Forest green, earth brown, sky blue, sand beige
- Elements: Plant motifs, natural textures, flowing lines, organic shapes
- Best for: Sustainability, wellness, outdoor topics, slow living
8. sketch
Raw, authentic, notebook-style
- Colors: Pencil gray, paper white, occasional color highlights
- Elements: Rough lines, sketch marks, handwritten notes, arrows
- Best for: Ideas in progress, brainstorming, thought processes
9. notion (Default)
Minimalist hand-drawn line art, intellectual
- Colors: Black outlines, white background, 1-2 pastel accents
- Elements: Simple line doodles, geometric shapes, hand-drawn wobble, maximum whitespace
- Best for: Knowledge sharing, concept explanations, SaaS content, productivity articles
Auto Style Selection
When no --style is specified, analyze content to select the best style:
| Content Signals |
Selected Style |
| AI, coding, tech, digital, algorithm, data |
tech |
| Personal story, emotion, growth, life, feeling |
warm |
| Warning, urgent, must-read, critical, important |
bold |
| Simple, zen, focus, essential, core |
minimal |
| Fun, easy, beginner, tutorial, guide, how-to |
playful |
| Nature, eco, wellness, health, organic, green |
nature |
| Idea, thought, concept, draft, brainstorm |
sketch |
| Business, professional, strategy, analysis |
elegant |
| Knowledge, concept, productivity, SaaS, notion |
notion |
File Management
Save illustrations to imgs/ subdirectory in the same folder as the article:
path/to/
├── article.md
└── imgs/
├── outline.md
├── prompts/
│ ├── illustration-concept-a.md
│ ├── illustration-concept-b.md
│ └── ...
├── illustration-concept-a.png
├── illustration-concept-b.png
└── ...
Workflow
Step 1: Analyze Content & Select Style
- Read article content
- If
--style specified, use that style
- Otherwise, scan for style signals and auto-select
- Extract key information:
- Main topic and themes
- Core messages per section
- Abstract concepts needing visualization
Step 2: Identify Illustration Positions
Three Purposes of Illustrations:
- Information Supplement: Help understand abstract concepts
- Concept Visualization: Transform abstract ideas into concrete visuals
- Imagination Guidance: Create atmosphere, enhance reading experience
Content Suitable for Illustrations:
- Abstract concepts needing visualization
- Processes/steps needing diagrams
- Comparisons needing visual representation
- Core arguments needing reinforcement
- Scenarios needing imagination guidance
Illustration Count:
- Consider at least 1 image per major section
- Prioritize core arguments and abstract concepts
- Principle: More is better than fewer
Step 3: Generate Illustration Plan
# Illustration Plan
**Article**: [article path]
**Style**: [selected style]
**Illustration Count**: N images
---
## Illustration 1
**Insert Position**: [section name] / [paragraph description]
**Purpose**: [why illustration needed here]
**Visual Content**: [what the image should show]
**Filename**: illustration-[slug].png
---
## Illustration 2
...
Step 4: Create Prompt Files
Save prompts to prompts/ directory with style-specific details.
Prompt Format:
Illustration theme: [concept in 2-3 words]
Style: [style name]
Visual composition:
- Main visual: [description matching style]
- Layout: [element positioning]
- Decorative elements: [style-appropriate decorations]
Color scheme:
- Primary: [style primary color]
- Background: [style background color]
- Accent: [style accent color]
Text content (if any):
- [Any labels or captions in content language]
Style notes: [specific style characteristics]
Step 5: Generate Images
Image Generation Skill Selection:
- Check available image generation skills
- If multiple skills available, ask user to choose
Generation Flow:
- Call selected image generation skill with prompt file and output path
- Generate images sequentially
- After each image, output progress: "Generated X/N"
- On failure, auto-retry once
- If retry fails, log reason, continue to next
Step 6: Update Article
Insert generated images at corresponding positions:
Insertion Rules:
- Insert image after corresponding paragraph
- Leave one blank line before and after image
- Alt text uses concise description in article's language
Step 7: Output Summary
Article Illustration Complete!
Article: [article path]
Style: [style name]
Generated: X/N images successful
Illustration Positions:
- illustration-xxx.png → After section "Section Name"
- illustration-yyy.png → After section "Another Section"
...
[If any failures]
Failed:
- illustration-zzz.png: [failure reason]
Style Reference Details
elegant
Colors: Soft coral (#E8A598), muted teal (#5B8A8A), dusty rose (#D4A5A5)
Background: Warm cream (#F5F0E6), soft beige
Accents: Gold (#C9A962), copper
Elements: Delicate lines, refined icons, subtle gradients, balanced whitespace
tech
Colors: Deep blue (#1A365D), electric cyan (#00D4FF), purple (#6B46C1)
Background: Dark gray (#1A202C), near-black (#0D1117)
Accents: Neon green (#00FF88), bright white
Elements: Circuit patterns, data nodes, geometric grids, glowing effects
warm
Colors: Warm orange (#ED8936), golden yellow (#F6AD55), terracotta (#C05621)
Background: Cream (#FFFAF0), soft peach (#FED7AA)
Accents: Deep brown (#744210), soft red
Elements: Rounded shapes, smiling faces, sun rays, hearts, cozy lighting
bold
Colors: Vibrant red (#E53E3E), bright orange (#DD6B20), electric yellow (#F6E05E)
Background: Deep black (#000000), dark charcoal
Accents: White, neon highlights
Elements: Strong shapes, exclamation marks, arrows, dramatic contrast
minimal
Colors: Pure black (#000000), white (#FFFFFF)
Background: White or off-white (#FAFAFA)
Accents: Single color (content-derived)
Elements: Single focal point, maximum negative space, thin precise lines
playful
Colors: Pastel pink (#FED7E2), mint (#C6F6D5), lavender (#E9D8FD), sky blue (#BEE3F8)
Background: Light cream (#FFFBEB), soft white
Accents: Bright pops - yellow, coral, turquoise
Elements: Doodles, stars, swirls, cute characters, speech bubbles
nature
Colors: Forest green (#276749), sage (#9AE6B4), earth brown (#744210)
Background: Sand beige (#F5E6D3), sky blue (#E0F2FE)
Accents: Sunset orange, water blue
Elements: Leaves, trees, mountains, organic flowing lines, natural textures
sketch
Colors: Pencil gray (#4A5568), paper white (#FAFAFA)
Background: Off-white paper texture (#F7FAFC)
Accents: Single highlight color (blue, red, or yellow)
Elements: Rough sketch lines, arrows, handwritten labels, crossed-out marks
notion
Colors: Black (#1A1A1A), dark gray (#4A4A4A)
Background: Pure white (#FFFFFF), off-white (#FAFAFA)
Accents: Pastel blue (#A8D4F0), pastel yellow (#F9E79F), pastel pink (#FADBD8)
Elements: Simple line doodles, hand-drawn wobble effect, geometric shapes, stick figures, maximum whitespace
Typography: Clean hand-drawn lettering, simple sans-serif labels
Notes
- Illustrations serve the content: supplement information, visualize concepts
- Maintain selected style consistency across all illustrations in one article
- Image generation typically takes 10-30 seconds per image
- Sensitive figures should use cartoon alternatives
- Prompt and illustration text language should match article language
1---2name: baoyu-article-illustrator3description: Smart article illustration skill. Analyzes article content and generates illustrations at positions requiring visual aids with multiple style options. Use when user asks to "add illustrations to article", "generate images for article", or "illustrate article".4---56# Smart Article Illustration Skill78Analyze article structure and content, identify positions requiring visual aids, and generate illustrations with flexible style options.910## Usage1112```bash13# Auto-select style based on content14/baoyu-article-illustrator path/to/article.md1516# Specify a style17/baoyu-article-illustrator path/to/article.md --style tech18/baoyu-article-illustrator path/to/article.md --style warm19/baoyu-article-illustrator path/to/article.md --style minimal2021# Combine with other options22/baoyu-article-illustrator path/to/article.md --style playful23```2425## Options2627| Option | Description |28|--------|-------------|29| `--style <name>` | Specify illustration style (see Style Gallery below) |3031## Style Gallery3233### 1. `elegant`34Refined, sophisticated, professional35- **Colors**: Soft coral, muted teal, dusty rose, cream background36- **Elements**: Delicate line work, subtle icons, balanced composition37- **Best for**: Professional articles, thought leadership, business topics3839### 2. `tech`40Modern, futuristic, digital41- **Colors**: Deep blue, electric cyan, purple, dark backgrounds42- **Elements**: Geometric shapes, circuit patterns, data visualizations, tech icons43- **Best for**: AI, programming, technology, digital transformation articles4445### 3. `warm`46Friendly, approachable, human-centered47- **Colors**: Warm orange, golden yellow, terracotta, cream48- **Elements**: Rounded shapes, friendly characters, sun/light motifs, hearts49- **Best for**: Personal growth, lifestyle, education, human interest stories5051### 4. `bold`52High contrast, impactful, energetic53- **Colors**: Vibrant red/orange, deep black, bright yellow accents54- **Elements**: Strong shapes, dramatic contrast, dynamic compositions55- **Best for**: Opinion pieces, important warnings, call-to-action content5657### 5. `minimal`58Ultra-clean, zen-like, focused59- **Colors**: Black, white, single accent color60- **Elements**: Maximum whitespace, single focal element, simple lines61- **Best for**: Philosophy, minimalism, focused explanations6263### 6. `playful`64Fun, creative, whimsical65- **Colors**: Pastel rainbow, bright pops, light backgrounds66- **Elements**: Doodles, quirky characters, speech bubbles, emoji-style icons67- **Best for**: Tutorials, beginner guides, casual content, fun topics6869### 7. `nature`70Organic, calm, earthy71- **Colors**: Forest green, earth brown, sky blue, sand beige72- **Elements**: Plant motifs, natural textures, flowing lines, organic shapes73- **Best for**: Sustainability, wellness, outdoor topics, slow living7475### 8. `sketch`76Raw, authentic, notebook-style77- **Colors**: Pencil gray, paper white, occasional color highlights78- **Elements**: Rough lines, sketch marks, handwritten notes, arrows79- **Best for**: Ideas in progress, brainstorming, thought processes8081### 9. `notion` (Default)82Minimalist hand-drawn line art, intellectual83- **Colors**: Black outlines, white background, 1-2 pastel accents84- **Elements**: Simple line doodles, geometric shapes, hand-drawn wobble, maximum whitespace85- **Best for**: Knowledge sharing, concept explanations, SaaS content, productivity articles8687## Auto Style Selection8889When no `--style` is specified, analyze content to select the best style:9091| Content Signals | Selected Style |92|----------------|----------------|93| AI, coding, tech, digital, algorithm, data | `tech` |94| Personal story, emotion, growth, life, feeling | `warm` |95| Warning, urgent, must-read, critical, important | `bold` |96| Simple, zen, focus, essential, core | `minimal` |97| Fun, easy, beginner, tutorial, guide, how-to | `playful` |98| Nature, eco, wellness, health, organic, green | `nature` |99| Idea, thought, concept, draft, brainstorm | `sketch` |100| Business, professional, strategy, analysis | `elegant` |101| Knowledge, concept, productivity, SaaS, notion | `notion` |102103## File Management104105Save illustrations to `imgs/` subdirectory in the same folder as the article:106107```108path/to/109├── article.md110└── imgs/111 ├── outline.md112 ├── prompts/113 │ ├── illustration-concept-a.md114 │ ├── illustration-concept-b.md115 │ └── ...116 ├── illustration-concept-a.png117 ├── illustration-concept-b.png118 └── ...119```120121## Workflow122123### Step 1: Analyze Content & Select Style1241251. Read article content1262. If `--style` specified, use that style1273. Otherwise, scan for style signals and auto-select1284. Extract key information:129 - Main topic and themes130 - Core messages per section131 - Abstract concepts needing visualization132133### Step 2: Identify Illustration Positions134135**Three Purposes of Illustrations**:1361. **Information Supplement**: Help understand abstract concepts1372. **Concept Visualization**: Transform abstract ideas into concrete visuals1383. **Imagination Guidance**: Create atmosphere, enhance reading experience139140**Content Suitable for Illustrations**:141- Abstract concepts needing visualization142- Processes/steps needing diagrams143- Comparisons needing visual representation144- Core arguments needing reinforcement145- Scenarios needing imagination guidance146147**Illustration Count**:148- Consider at least 1 image per major section149- Prioritize core arguments and abstract concepts150- **Principle: More is better than fewer**151152### Step 3: Generate Illustration Plan153154```markdown155# Illustration Plan156157**Article**: [article path]158**Style**: [selected style]159**Illustration Count**: N images160161---162163## Illustration 1164165**Insert Position**: [section name] / [paragraph description]166**Purpose**: [why illustration needed here]167**Visual Content**: [what the image should show]168**Filename**: illustration-[slug].png169170---171172## Illustration 2173...174```175176### Step 4: Create Prompt Files177178Save prompts to `prompts/` directory with style-specific details.179180**Prompt Format**:181182```markdown183Illustration theme: [concept in 2-3 words]184Style: [style name]185186Visual composition:187- Main visual: [description matching style]188- Layout: [element positioning]189- Decorative elements: [style-appropriate decorations]190191Color scheme:192- Primary: [style primary color]193- Background: [style background color]194- Accent: [style accent color]195196Text content (if any):197- [Any labels or captions in content language]198199Style notes: [specific style characteristics]200```201202### Step 5: Generate Images203204**Image Generation Skill Selection**:2051. Check available image generation skills2062. If multiple skills available, ask user to choose207208**Generation Flow**:2091. Call selected image generation skill with prompt file and output path2102. Generate images sequentially2113. After each image, output progress: "Generated X/N"2124. On failure, auto-retry once2135. If retry fails, log reason, continue to next214215### Step 6: Update Article216217Insert generated images at corresponding positions:218219```markdown220221```222223**Insertion Rules**:224- Insert image after corresponding paragraph225- Leave one blank line before and after image226- Alt text uses concise description in article's language227228### Step 7: Output Summary229230```231Article Illustration Complete!232233Article: [article path]234Style: [style name]235Generated: X/N images successful236237Illustration Positions:238- illustration-xxx.png → After section "Section Name"239- illustration-yyy.png → After section "Another Section"240...241242[If any failures]243Failed:244- illustration-zzz.png: [failure reason]245```246247## Style Reference Details248249### elegant250```251Colors: Soft coral (#E8A598), muted teal (#5B8A8A), dusty rose (#D4A5A5)252Background: Warm cream (#F5F0E6), soft beige253Accents: Gold (#C9A962), copper254Elements: Delicate lines, refined icons, subtle gradients, balanced whitespace255```256257### tech258```259Colors: Deep blue (#1A365D), electric cyan (#00D4FF), purple (#6B46C1)260Background: Dark gray (#1A202C), near-black (#0D1117)261Accents: Neon green (#00FF88), bright white262Elements: Circuit patterns, data nodes, geometric grids, glowing effects263```264265### warm266```267Colors: Warm orange (#ED8936), golden yellow (#F6AD55), terracotta (#C05621)268Background: Cream (#FFFAF0), soft peach (#FED7AA)269Accents: Deep brown (#744210), soft red270Elements: Rounded shapes, smiling faces, sun rays, hearts, cozy lighting271```272273### bold274```275Colors: Vibrant red (#E53E3E), bright orange (#DD6B20), electric yellow (#F6E05E)276Background: Deep black (#000000), dark charcoal277Accents: White, neon highlights278Elements: Strong shapes, exclamation marks, arrows, dramatic contrast279```280281### minimal282```283Colors: Pure black (#000000), white (#FFFFFF)284Background: White or off-white (#FAFAFA)285Accents: Single color (content-derived)286Elements: Single focal point, maximum negative space, thin precise lines287```288289### playful290```291Colors: Pastel pink (#FED7E2), mint (#C6F6D5), lavender (#E9D8FD), sky blue (#BEE3F8)292Background: Light cream (#FFFBEB), soft white293Accents: Bright pops - yellow, coral, turquoise294Elements: Doodles, stars, swirls, cute characters, speech bubbles295```296297### nature298```299Colors: Forest green (#276749), sage (#9AE6B4), earth brown (#744210)300Background: Sand beige (#F5E6D3), sky blue (#E0F2FE)301Accents: Sunset orange, water blue302Elements: Leaves, trees, mountains, organic flowing lines, natural textures303```304305### sketch306```307Colors: Pencil gray (#4A5568), paper white (#FAFAFA)308Background: Off-white paper texture (#F7FAFC)309Accents: Single highlight color (blue, red, or yellow)310Elements: Rough sketch lines, arrows, handwritten labels, crossed-out marks311```312313### notion314```315Colors: Black (#1A1A1A), dark gray (#4A4A4A)316Background: Pure white (#FFFFFF), off-white (#FAFAFA)317Accents: Pastel blue (#A8D4F0), pastel yellow (#F9E79F), pastel pink (#FADBD8)318Elements: Simple line doodles, hand-drawn wobble effect, geometric shapes, stick figures, maximum whitespace319Typography: Clean hand-drawn lettering, simple sans-serif labels320```321322## Notes323324- Illustrations serve the content: supplement information, visualize concepts325- Maintain selected style consistency across all illustrations in one article326- Image generation typically takes 10-30 seconds per image327- Sensitive figures should use cartoon alternatives328- Prompt and illustration text language should match article language
aiskillstore