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>
16 
17## Custom Dimensions (only when style: custom)
18dimensions:
19  texture: clean              # clean | grid | organic | pixel | paper
20  mood: professional          # professional | warm | cool | vibrant | dark | neutral
21  typography: geometric       # geometric | humanist | handwritten | editorial | technical
22  density: balanced           # minimal | balanced | dense
23 
24## Custom Styles (optional)
25custom_styles:
26  my-style:
27    texture: organic
28    mood: warm
29    typography: humanist
30    density: minimal
31    description: "My custom warm and friendly style"
32```
33 
34## Field Descriptions
35 
36### Defaults
37 
38| Field | Type | Default | Description |
39|-------|------|---------|-------------|
40| `style` | string | `blueprint` | Preset name, `custom`, or custom style name |
41| `audience` | string | `general` | Default target audience |
42| `language` | string | `auto` | Output language (auto = detect from input) |
43| `review` | boolean | `true` | Show outline review before generation |
44| `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-imagine`, `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. |
45 
46### Custom Dimensions
47 
48Only used when `style: custom`. Defines dimension values directly.
49 
50| Field | Options | Default |
51|-------|---------|---------|
52| `texture` | clean, grid, organic, pixel, paper | clean |
53| `mood` | professional, warm, cool, vibrant, dark, neutral | professional |
54| `typography` | geometric, humanist, handwritten, editorial, technical | geometric |
55| `density` | minimal, balanced, dense | balanced |
56 
57### Custom Styles
58 
59Define reusable custom dimension combinations.
60 
61```yaml
62custom_styles:
63  style-name:
64    texture: <texture>
65    mood: <mood>
66    typography: <typography>
67    density: <density>
68    description: "Optional description"
69```
70 
71Then use with: `/baoyu-slide-deck content.md --style style-name`
72 
73## Minimal Examples
74 
75### Just change default style
76 
77```yaml
78style: sketch-notes
79```
80 
81### Prefer no reviews
82 
83```yaml
84review: false
85```
86 
87### Custom default dimensions
88 
89```yaml
90style: custom
91dimensions:
92  texture: organic
93  mood: professional
94  typography: humanist
95  density: minimal
96```
97 
98### Define reusable custom style
99 
100```yaml
101custom_styles:
102  brand-style:
103    texture: clean
104    mood: vibrant
105    typography: editorial
106    density: balanced
107    description: "Company brand style"
108```
109 
110## File Locations
111 
112Priority order (first found wins):
113 
1141. `.baoyu-skills/baoyu-slide-deck/EXTEND.md` (project)
1152. `$HOME/.baoyu-skills/baoyu-slide-deck/EXTEND.md` (user)
116 
117## First-Time Setup
118 
119When no EXTEND.md exists, the skill prompts for initial preferences:
120 
1211. Preferred style (preset or custom)
1222. Default audience
1233. Language preference
1244. Review preference
1255. Save location (project or user)
126 
127Creates EXTEND.md at chosen location.
128