@@ -11,55 +11,34 @@ Analyze articles, identify illustration positions, generate images with Type ×
| Dimension | Controls | Examples |
|-----------|----------|----------|
| **Type ** | Information structure, layout | infographic, scene, flowchart, comparison, framework, timeline |
| **Style ** | Visual aesthetics, mood | notion, warm, minimal, blueprint, watercolor, elegant |
| **Type ** | Information structure | infographic, scene, flowchart, comparison, framework, timeline |
| **Style ** | Visual aesthetics | notion, warm, minimal, blueprint, watercolor, elegant |
Type × : `--type infographic --style blueprint`
Combine freely : `--type infographic --style blueprint`
## Illustration Purpose
Auto-detected during content analysis. Influences type/style recommendations.
| Purpose | Description | Best Types |
|---------|-------------|------------|
| **information ** | Help understand abstract concepts | infographic, flowchart, comparison |
| **visualization ** | Turn abstract ideas into concrete visuals | framework, comparison, infographic |
| **imagination ** | Create atmosphere, spark imagination | scene, timeline |
## Type Gallery
## Types
| Type | Best For |
|------|----------|
| `infographic` | Data, metrics, technical articles |
| `scene` | Narratives, personal stories, emotional content |
| `flowchart` | Tutorial s, workflows, processes |
| `comparison` | Side-by-side, before/after, options |
| `framework` | Methodologies, m odels, architecture |
| `timeline` | History, progress, evolution |
| `infographic` | Data, metrics, technical |
| `scene` | Narratives, emotional |
| `flowchart` | Processe s, workflows |
| `comparison` | Side-by-side, options |
| `framework` | Models, architecture |
| `timeline` | History, evolution |
## Styles
See [references/styles.md ](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 ×
See [references/styles.md ](references/styles.md ) for Core Styles, full gallery, and Type ×
## 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 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
```
@@ -67,8 +46,6 @@ Progress:
**1.5 Load Preferences (EXTEND.md) ⛔ BLOCKING **
**CRITICAL ** : If EXTEND.md not found, MUST complete first-time setup before ANY other steps.
``` bash
test -f .baoyu-skills/baoyu-article-illustrator/EXTEND.md && echo "project"
test -f " $HOME /.baoyu-skills/baoyu-article-illustrator/EXTEND.md " && echo "user"
@@ -76,122 +53,98 @@ test -f "$HOME/.baoyu-skills/baoyu-article-illustrator/EXTEND.md" && echo "user"
| Result | Action |
|--------|--------|
| Found | Read, parse, display summary → Continue |
| Not found | ⛔ Run first-time setup ([ references/config/first-time-setup.md references/config/first-time-setup.md )) |
**Supports ** : Watermark | Preferred type/style | Custom styles | Language | Output directory
**1.0-1.4 ** : Handle reference images, determine input type, ask config questions.
| Found | Read, parse, display summary |
| Not found | ⛔ Run [first-time-setup ](references/config/first-time-setup.md ) |
Full procedures: [references/workflow.md ](references/workflow.md#step-1-pre-check )
---
### Step 2: Analyze
### Step 2: Setup & Analyze
| Analysis | Description |
|----------|-------------|
| Analysis | Output |
|----------|--------|
| Content type | Technical / Tutorial / Methodology / Narrative |
| Illustration p urpose | information / visualization / imagination |
| Core arguments | 2-5 main points to visualize |
| Visual opportunities | Positions w here illustrations add value |
| P urpose | information / visualization / imagination |
| Core arguments | 2-5 main points |
| Positions | W here illustrations add value |
**CRITICAL ** : If article uses metaphors, do NOT illustrate literally. V isualize the ** underlying concept**
**CRITICAL ** : Metaphors → v isualize underlying concept, NOT literal image .
Full procedures: [references/workflow.md ](references/workflow.md#step-2-setup--analyze )
---
### Step 3: Confirm Settings ⚠️
**Do NOT skip. ** Use ONE AskUserQuestion call with max 4 questions. **Q1, Q2, Q3 are ALL REQUIRED.**
**ONE AskUserQuestion, max 4 Qs. Q1-Q3 REQUIRED. **
| Question | Options |
|---------- |---------|
| **Q1: Type ** ⚠️ | [Recommended], 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, Other |
| ** Q4: Language**
| Q | Options |
|---|---------|
| **Q1: Type ** | [Recommended], 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, Other |
| Q4: Language | When article language ≠ EXTEND.md setting |
Full procedures: [references/workflow.md ](references/workflow.md#step-3-confirm-settings- )
---
### Step 4: Generate Outline
Save as `outline.md` with frontmatter (type, density, style, image_count, references) and illustration entries:
Save `outline.md` with frontmatter (type, density, style, image_count) and entries:
``` yaml
## Illustration 1
**Position**: [ section] / [ paragraph]
**Purpose**: [ why this helps ]
**Visual Content** : [ what to show ]
**Position**: [ section/ paragraph]
**Purpose**: [ why]
**Visual Content** : [ what]
**Filename**: 01 -infographic-concept-name.png
```
Full template: [references/workflow.md ](references/workflow.md#step-4-generate-outline )
---
### Step 5: Generate Images
1. ** Create P rompts** : Follow [references/prompt-construction.md ](references/prompt-construction.md )
2. ** Select G eneration S kill** : Check available skills
3. ** Process R eferences** : Handle `direct` /`style` /`palette` usage
4. ** Apply W atermark** : If enabled in EXTEND.md
5. ** Generate** : S equential, retry once on failure
1. Create p rompts per [references/prompt-construction.md ](references/prompt-construction.md )
2. Select g eneration s kill from available skills
3. Process r eferences ( `direct` /`style` /`palette` )
4. Apply w atermark if EXTEND.md enabled
5. Generate s equentially , retry once on failure
Full procedures: [references/workflow.md ](references/workflow.md#step-5-generate-images )
---
### Step 6: Finalize
**Update Article ** : Insert `` after corresponding paragraphs.
Insert `` after 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
├── references/ # if provided
├── outline.md
├── prompts/
│ └── illustration-{slug}.md
└── NN-{type}-{slug}.png
```
**Slug ** : 2-4 word topic in kebab-case.
**Conflict ** : Append `-YYYYMMDD-HHMMSS` if exists.
**Slug ** : 2-4 words, kebab-case. **Conflict ** : append `-YYYYMMDD-HHMMSS` .
## Modification
| Action | Steps |
|--------|-------|
| ** Edit** file FIRST → Regenerate → Update reference |
| **Add ** | Identify p osition → Create p rompt → Generate → Update outline → Insert |
| ** Delete**
| Edit | Update prompt → Regenerate → Update reference |
| Add | P osition → P rompt → Generate → Update outline → Insert |
| Delete | Delete files → Remove reference → Update outline |
## References
| File | Content |
|------|---------|
| [references/workflow.md ](references/workflow.md ) | Detailed workflow procedures |
| [references/usage.md ](references/usage.md ) | Command syntax and options |
| [references/styles.md ](references/styles.md ) | Style gallery & compatibility |
| [references/workflow.md ](references/workflow.md ) | Detailed procedures |
| [references/usage.md ](references/usage.md ) | Command syntax |
| [references/styles.md ](references/styles.md ) | Style gallery |
| [references/prompt-construction.md ](references/prompt-construction.md ) | Prompt templates |
| ` references/styles/<style> .md` ull style specifications |
| `references/config/preferences-schema.md` | EXTEND.md schema |
| `references/config/first-time-setup.md` | First-time setup flow |
| [ references/config/first-time-setup.md ]( references/config/first-time-setup .md) | First-time setup |
Jim Liu 宝玉