1# Usage
2 
3## Command Syntax
4 
5```bash
6# Auto-select type and style based on content
7/baoyu-article-illustrator path/to/article.md
8 
9# Specify type
10/baoyu-article-illustrator path/to/article.md --type infographic
11 
12# Specify style
13/baoyu-article-illustrator path/to/article.md --style blueprint
14 
15# Combine type and style
16/baoyu-article-illustrator path/to/article.md --type flowchart --style notion
17 
18# Specify density
19/baoyu-article-illustrator path/to/article.md --density rich
20 
21# Generate up to 4 images in parallel after prompts are saved
22/baoyu-article-illustrator path/to/article.md --batch-size 4
23 
24# Direct content input (paste mode)
25/baoyu-article-illustrator
26[paste content]
27```
28 
29## Options
30 
31| Option | Description |
32|--------|-------------|
33| `--type <name>` | Illustration type (see Type Gallery in SKILL.md) |
34| `--style <name>` | Visual style (see references/styles.md) |
35| `--preset <name>` | Shorthand for type + style combo (see [references/style-presets.md](references/style-presets.md)) |
36| `--density <level>` | Image count: minimal / balanced / rich |
37| `--batch-size <n>` | Temporary generation batch size for this run. Default: `generation_batch_size` from EXTEND.md, otherwise 4. Clamp to 1-8. |
38 
39## Input Modes
40 
41| Mode | Trigger | Output Directory |
42|------|---------|------------------|
43| File path | `path/to/article.md` | Use `default_output_dir` preference, or ask if not set |
44| Paste content | No path argument | `illustrations/{topic-slug}/` |
45 
46## Output Directory Options
47 
48| Value | Path |
49|-------|------|
50| `same-dir` | `{article-dir}/` |
51| `illustrations-subdir` | `{article-dir}/illustrations/` |
52| `independent` | `illustrations/{topic-slug}/` |
53 
54Configure in EXTEND.md: `default_output_dir: illustrations-subdir`
55 
56## Examples
57 
58**Technical article with data**:
59```bash
60/baoyu-article-illustrator api-design.md --type infographic --style blueprint
61```
62 
63**Same thing with preset**:
64```bash
65/baoyu-article-illustrator api-design.md --preset tech-explainer
66```
67 
68**Personal story**:
69```bash
70/baoyu-article-illustrator journey.md --preset storytelling
71```
72 
73**Tutorial with steps**:
74```bash
75/baoyu-article-illustrator how-to-deploy.md --preset tutorial --density rich
76```
77 
78**Opinion article with poster style**:
79```bash
80/baoyu-article-illustrator opinion.md --preset opinion-piece
81```
82 
83**Preset with override**:
84```bash
85/baoyu-article-illustrator article.md --preset tech-explainer --style notion
86```
87