1# EXTEND.md Schema
2 
3Structure for user preferences in `.baoyu-skills/baoyu-slide-deck/EXTEND.md`.
4 
5## Full Schema
6 
7```yaml
8# Slide Deck Preferences
9 
10## Defaults
11style: blueprint              # Preset name OR "custom"
12audience: general             # beginners | intermediate | experts | executives | general
13language: auto                # auto | en | zh | ja | etc.
14review: true                  # true = review outline before generation
15preferred_image_backend: auto # auto | ask | <backend-id>
16generation_batch_size: 4      # 1-8, used when backend/runtime supports batch or parallel slide generation
17 
18## Custom Dimensions (only when style: custom)
19dimensions:
20  texture: clean              # clean | grid | organic | pixel | paper
21  mood: professional          # professional | warm | cool | vibrant | dark | neutral
22  typography: geometric       # geometric | humanist | handwritten | editorial | technical
23  density: balanced           # minimal | balanced | dense
24 
25## Custom Styles (optional)
26custom_styles:
27  my-style:
28    texture: organic
29    mood: warm
30    typography: humanist
31    density: minimal
32    description: "My custom warm and friendly style"
33```
34 
35## Field Descriptions
36 
37### Defaults
38 
39| Field | Type | Default | Description |
40|-------|------|---------|-------------|
41| `style` | string | `blueprint` | Preset name, `custom`, or custom style name |
42| `audience` | string | `general` | Default target audience |
43| `language` | string | `auto` | Output language (auto = detect from input) |
44| `review` | boolean | `true` | Show outline review before generation |
45| `preferred_image_backend` | string | `auto` | Image backend selection. `auto` = prefer runtime-native tool, fall back to the only installed backend, ask if multiple non-native are present. `ask` = always confirm on every run. `<backend-id>` (e.g., `codex-imagegen`, `baoyu-image-gen`, `image_generate`) = pin this backend when available; fall back to `auto` when it isn't. Absent = `auto`. Resolution logic is documented in `SKILL.md`'s `## Image Generation Tools` section. |
46| `generation_batch_size` | int | 4 | Number of slide images to dispatch per batch when the backend has native batch support or the runtime can issue parallel generation calls. Clamp invalid values to 1-8. Current user request overrides this value. |
47 
48### Custom Dimensions
49 
50Only used when `style: custom`. Defines dimension values directly.
51 
52| Field | Options | Default |
53|-------|---------|---------|
54| `texture` | clean, grid, organic, pixel, paper | clean |
55| `mood` | professional, warm, cool, vibrant, dark, neutral | professional |
56| `typography` | geometric, humanist, handwritten, editorial, technical | geometric |
57| `density` | minimal, balanced, dense | balanced |
58 
59### Custom Styles
60 
61Define reusable custom dimension combinations.
62 
63```yaml
64custom_styles:
65  style-name:
66    texture: <texture>
67    mood: <mood>
68    typography: <typography>
69    density: <density>
70    description: "Optional description"
71```
72 
73Then use with: `/baoyu-slide-deck content.md --style style-name`
74 
75## Minimal Examples
76 
77### Just change default style
78 
79```yaml
80style: sketch-notes
81```
82 
83### Prefer no reviews
84 
85```yaml
86review: false
87```
88 
89### Custom default dimensions
90 
91```yaml
92style: custom
93dimensions:
94  texture: organic
95  mood: professional
96  typography: humanist
97  density: minimal
98```
99 
100### Define reusable custom style
101 
102```yaml
103custom_styles:
104  brand-style:
105    texture: clean
106    mood: vibrant
107    typography: editorial
108    density: balanced
109    description: "Company brand style"
110```
111 
112## File Locations
113 
114Priority order (first found wins):
115 
1161. `.baoyu-skills/baoyu-slide-deck/EXTEND.md` (project)
1172. `$HOME/.baoyu-skills/baoyu-slide-deck/EXTEND.md` (user)
118 
119## First-Time Setup
120 
121When no EXTEND.md exists, the skill prompts for initial preferences:
122 
1231. Preferred style (preset or custom)
1242. Default audience
1253. Language preference
1264. Review preference
1275. Save location (project or user)
128 
129Creates EXTEND.md at chosen location.
130