baoyu-article-illustrator

What this skill does

# Smart Article Illustration Skill

Analyze article structure and content, identify positions requiring visual aids, and generate illustrations with flexible style options.

## Usage

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

# Specify a style
/baoyu-article-illustrator path/to/article.md --style warm
/baoyu-article-illustrator path/to/article.md --style minimal
/baoyu-article-illustrator path/to/article.md --style watercolor

# 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

| Style                 | Description                                   | Best For                               |
| --------------------- | --------------------------------------------- | -------------------------------------- |
| `notion` (Default)    | Minimalist hand-drawn line art, intellectual  | Knowledge sharing, SaaS, productivity  |
| `elegant`             | Refined, sophisticated, professional          | Business, thought leadership           |
| `warm`                | Friendly, approachable, human-centered        | Personal growth, lifestyle, education  |
| `minimal`             | Ultra-clean, zen-like, focused                | Philosophy, minimalism, core concepts  |
| `playful`             | Fun, creative, whimsical                      | Tutorials, beginner guides, fun topics |
| `nature`              | Organic, calm, earthy                         | Sustainability, wellness, outdoor      |
| `sketch`              | Raw, authentic, notebook-style                | Ideas, brainstorming, drafts           |
| `watercolor`          | Soft artistic with natural warmth             | Lifestyle, travel, creative            |
| `vintage`             | Nostalgic aged-paper aesthetic                | Historical, biography, heritage        |
| `scientific`          | Academic precise diagrams                     | Biology, chemistry, technical          |
| `chalkboard`          | Classroom chalk drawing style                 | Education, tutorials, workshops        |
| `editorial`           | Magazine-style infographic                    | Tech explainers, journalism            |
| `flat`                | Modern flat vector illustration               | Startups, digital, contemporary        |
| `flat-doodle`         | Bold outlines, pastel colors, cute            | Productivity, SaaS, workflows          |
| `retro`               | 80s/90s vibrant nostalgic                     | Pop culture, gaming, entertainment     |
| `blueprint`           | Technical schematics, engineering precision   | Architecture, system design            |
| `vector-illustration` | Flat vector with black outlines, retro colors | Educational, creative, brand content   |
| `sketch-notes`        | Soft hand-drawn, warm educational feel        | Knowledge sharing, tutorials           |
| `pixel-art`           | Retro 8-bit gaming aesthetic                  | Gaming, tech, developer content        |
| `intuition-machine`   | Technical briefing with bilingual labels      | Academic, technical, bilingual         |
| `fantasy-animation`   | Ghibli/Disney whimsical style                 | Storytelling, children's, creative     |

Full style specifications in `references/styles/<style>.md`

## Auto Style Selection

When no `--style` is specified, analyze content to select the best style:

| Content Signals                                              | Selected Style        |
| ------------------------------------------------------------ | --------------------- |
| Personal story, emotion, growth, life, feeling, relationship | `warm`                |
| Simple, zen, focus, essential, core, minimalist              | `minimal`             |
| Fun, easy, beginner, tutorial, guide, how-to, learn          | `playful`             |
| Nature, eco, wellness, health, organic, green, outdoor       | `nature`              |
| Idea, thought, concept, draft, brainstorm, sketch            | `sketch`              |
| Business, professional, strategy, analysis, corporate        | `elegant`             |
| Knowledge, concept, productivity, SaaS, notion, tool         | `notion`              |
| Lifestyle, travel, food, art, creative, artistic             | `watercolor`          |
| History, heritage, vintage, biography, classic, expedition   | `vintage`             |
| Biology, chemistry, medical, scientific, research, academic  | `scientific`          |
| Education, classroom, teaching, school, lecture, workshop    | `chalkboard`          |
| Explainer, journalism, magazine, in-depth, investigation     | `editorial`           |
| Modern, startup, app, product, digital marketing, saas       | `flat`                |
| Productivity, workflow, cute, tools, app tutorial            | `flat-doodle`         |
| 80s, 90s, retro, pop culture, music, nostalgia               | `retro`               |
| Architecture, system, infrastructure, engineering, technical | `blueprint`           |
| Brand, explainer, children, cute, toy, geometric             | `vector-illustration` |
| Notes, doodle, friendly, warm tutorial, onboarding           | `sketch-notes`        |
| Gaming, 8-bit, pixel, developer, retro tech                  | `pixel-art`           |
| Bilingual, briefing, academic, research, documentation       | `intuition-machine`   |
| Fantasy, story, magical, Ghibli, Disney, children            | `fantasy-animation`   |
| Default                                                      | `notion`              |

## File Management

### Output Directory

Each session creates an independent directory named by content slug:

```
illustrations/{topic-slug}/
├── source-{slug}.{ext}    # Source files (text, images, etc.)
├── outline.md
├── outline-{style}.md     # Style variant outlines
├── prompts/
│   ├── illustration-concept-a.md
│   ├── illustration-concept-b.md
│   └── ...
├── illustration-concept-a.png
├── illustration-concept-b.png
└── ...
```

**Slug Generation**:

1. Extract main topic from content (2-4 words, kebab-case)
2. Example: "The Future of AI" → `future-of-ai`

### Conflict Resolution

If `illustrations/{topic-slug}/` already exists:

- Append timestamp: `{topic-slug}-YYYYMMDD-HHMMSS`
- Example: `ai-future` exists → `ai-future-20260118-143052`

### Source Files

Copy all sources with naming `source-{slug}.{ext}`:

- `source-article.md` (main text content)
- `source-photo.jpg` (image from conversation)
- `source-reference.pdf` (additional file)

Multiple sources supported: text, images, files from conversation.

## Workflow

### Step 1: Analyze Content & Select Style

1. Read article content
2. If `--style` specified, use that style
3. Otherwise, scan for style signals and auto-select
4. **Language detection**:
   - Detect **source language** from article content
   - Detect **user language** from conversation context
   - Note if source_language ≠ user_language (will ask in Step 4)
5. Extract key information:
   - Main topic and themes
   - Core messages per section
   - Abstract concepts needing visualization

### Step 2: Identify Illustration Positions

**Three Purposes of Illustrations**:

1. **Information Supplement**: Help understand abstract concepts
2. **Concept Visualization**: Transform abstract ideas into concrete visuals
3. **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