1---
2name: preferences-schema
3description: EXTEND.md YAML schema for baoyu-cover-image user preferences
4---
5 
6# Preferences Schema
7 
8## Full Schema
9 
10```yaml
11---
12version: 3
13 
14watermark:
15  enabled: false
16  content: ""
17  position: bottom-right  # bottom-right|bottom-left|bottom-center|top-right
18 
19preferred_type: null      # hero|conceptual|typography|metaphor|scene|minimal or null for auto-select
20 
21preferred_palette: null   # warm|elegant|cool|dark|earth|vivid|pastel|mono|retro|duotone|macaron or null for auto-select
22 
23preferred_rendering: null # flat-vector|hand-drawn|painterly|digital|pixel|chalk or null for auto-select
24 
25preferred_text: title-only  # none|title-only|title-subtitle|text-rich
26 
27preferred_mood: balanced    # subtle|balanced|bold
28 
29default_aspect: "2.35:1"  # 2.35:1|16:9|1:1
30 
31quick_mode: false         # Skip confirmation when true
32 
33language: null            # zh|en|ja|ko|auto (null = auto-detect)
34 
35preferred_image_backend: auto  # auto|ask|<backend-id>
36 
37custom_palettes:
38  - name: my-palette
39    description: "Palette description"
40    colors:
41      primary: ["#1E3A5F", "#4A90D9"]
42      background: "#F5F7FA"
43      accents: ["#00B4D8"]
44    decorative_hints: "Clean lines, geometric shapes"
45    best_for: "Business, tech content"
46---
47```
48 
49## Field Reference
50 
51| Field | Type | Default | Description |
52|-------|------|---------|-------------|
53| `version` | int | 3 | Schema version |
54| `watermark.enabled` | bool | false | Enable watermark |
55| `watermark.content` | string | "" | Watermark text (@username or custom) |
56| `watermark.position` | enum | bottom-right | Position on image |
57| `preferred_type` | string | null | Type name or null for auto |
58| `preferred_palette` | string | null | Palette name or null for auto |
59| `preferred_rendering` | string | null | Rendering name or null for auto |
60| `preferred_text` | string | title-only | Text density level |
61| `preferred_mood` | string | balanced | Mood intensity level |
62| `default_aspect` | string | "2.35:1" | Default aspect ratio |
63| `quick_mode` | bool | false | Skip confirmation step |
64| `language` | string | null | Output language (null = auto-detect) |
65| `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. |
66| `custom_palettes` | array | [] | User-defined palettes |
67 
68## Type Options
69 
70| Value | Description |
71|-------|-------------|
72| `hero` | Large visual impact, title overlay |
73| `conceptual` | Concept visualization, abstract core ideas |
74| `typography` | Text-focused layout, prominent title |
75| `metaphor` | Visual metaphor, concrete expressing abstract |
76| `scene` | Atmospheric scene, narrative feel |
77| `minimal` | Minimalist composition, generous whitespace |
78 
79## Palette Options
80 
81| Value | Description |
82|-------|-------------|
83| `warm` | Friendly, approachable — orange, golden yellow, terracotta |
84| `elegant` | Sophisticated, refined — soft coral, muted teal, dusty rose |
85| `cool` | Technical, professional — engineering blue, navy, cyan |
86| `dark` | Cinematic, premium — electric purple, cyan, magenta |
87| `earth` | Natural, organic — forest green, sage, earth brown |
88| `vivid` | Energetic, bold — bright red, neon green, electric blue |
89| `pastel` | Gentle, whimsical — soft pink, mint, lavender |
90| `mono` | Clean, focused — black, near-black, white |
91| `retro` | Nostalgic, vintage — muted orange, dusty pink, maroon |
92 
93## Rendering Options
94 
95| Value | Description |
96|-------|-------------|
97| `flat-vector` | Clean outlines, uniform fills, geometric icons |
98| `hand-drawn` | Sketchy, organic, imperfect strokes, paper texture |
99| `painterly` | Soft brush strokes, color bleeds, watercolor feel |
100| `digital` | Polished, precise edges, subtle gradients, UI components |
101| `pixel` | Pixel grid, dithering, chunky 8-bit shapes |
102| `chalk` | Chalk strokes, dust effects, blackboard texture |
103 
104## Text Options
105 
106| Value | Description |
107|-------|-------------|
108| `none` | Pure visual, no text elements |
109| `title-only` | Single headline |
110| `title-subtitle` | Title + subtitle |
111| `text-rich` | Title + subtitle + keyword tags (2-4) |
112 
113## Mood Options
114 
115| Value | Description |
116|-------|-------------|
117| `subtle` | Low contrast, muted colors, calm aesthetic |
118| `balanced` | Medium contrast, normal saturation, versatile |
119| `bold` | High contrast, vivid colors, dynamic energy |
120 
121## Position Options
122 
123| Value | Description |
124|-------|-------------|
125| `bottom-right` | Lower right corner (default, most common) |
126| `bottom-left` | Lower left corner |
127| `bottom-center` | Bottom center |
128| `top-right` | Upper right corner |
129 
130## Aspect Ratio Options
131 
132| Value | Description | Best For |
133|-------|-------------|----------|
134| `2.35:1` | Cinematic widescreen | Article headers, blog covers |
135| `16:9` | Standard widescreen | Presentations, video thumbnails |
136| `1:1` | Square | Social media, profile images |
137 
138## Custom Palette Fields
139 
140| Field | Required | Description |
141|-------|----------|-------------|
142| `name` | Yes | Unique palette identifier (kebab-case) |
143| `description` | Yes | What the palette conveys |
144| `colors.primary` | No | Main colors (array of hex) |
145| `colors.background` | No | Background color (hex) |
146| `colors.accents` | No | Accent colors (array of hex) |
147| `decorative_hints` | No | Decorative elements and patterns |
148| `best_for` | No | Recommended content types |
149 
150## Example: Minimal Preferences
151 
152```yaml
153---
154version: 3
155watermark:
156  enabled: true
157  content: "@myhandle"
158preferred_type: null
159preferred_palette: elegant
160preferred_rendering: hand-drawn
161preferred_text: title-only
162preferred_mood: balanced
163quick_mode: false
164---
165```
166 
167## Example: Full Preferences
168 
169```yaml
170---
171version: 3
172watermark:
173  enabled: true
174  content: "myblog.com"
175  position: bottom-right
176 
177preferred_type: conceptual
178 
179preferred_palette: cool
180 
181preferred_rendering: digital
182 
183preferred_text: title-subtitle
184 
185preferred_mood: subtle
186 
187default_aspect: "16:9"
188 
189quick_mode: true
190 
191language: en
192 
193preferred_image_backend: codex-imagegen
194 
195custom_palettes:
196  - name: corporate-tech
197    description: "Professional B2B tech palette"
198    colors:
199      primary: ["#1E3A5F", "#4A90D9"]
200      background: "#F5F7FA"
201      accents: ["#00B4D8", "#48CAE4"]
202    decorative_hints: "Clean lines, subtle gradients, circuit patterns"
203    best_for: "SaaS, enterprise, technical"
204---
205```
206 
207## Migration from v2
208 
209When loading v2 schema, auto-upgrade:
210 
211| v2 Field | v3 Field | Migration |
212|----------|----------|-----------|
213| `version: 2` | `version: 3` | Update |
214| `preferred_style` | `preferred_palette` + `preferred_rendering` | Use preset mapping table |
215| `custom_styles` | `custom_palettes` | Rename, restructure fields |
216 
217**Style → Palette + Rendering mapping**:
218 
219| v2 `preferred_style` | v3 `preferred_palette` | v3 `preferred_rendering` |
220|----------------------|----------------------|-------------------------|
221| `elegant` | `elegant` | `hand-drawn` |
222| `blueprint` | `cool` | `digital` |
223| `chalkboard` | `dark` | `chalk` |
224| `dark-atmospheric` | `dark` | `digital` |
225| `editorial-infographic` | `cool` | `digital` |
226| `fantasy-animation` | `pastel` | `painterly` |
227| `flat-doodle` | `pastel` | `flat-vector` |
228| `intuition-machine` | `retro` | `digital` |
229| `minimal` | `mono` | `flat-vector` |
230| `nature` | `earth` | `hand-drawn` |
231| `notion` | `mono` | `digital` |
232| `pixel-art` | `vivid` | `pixel` |
233| `playful` | `pastel` | `hand-drawn` |
234| `retro` | `retro` | `digital` |
235| `sketch-notes` | `warm` | `hand-drawn` |
236| `vector-illustration` | `retro` | `flat-vector` |
237| `vintage` | `retro` | `hand-drawn` |
238| `warm` | `warm` | `hand-drawn` |
239| `watercolor` | `earth` | `painterly` |
240| null (auto) | null | null |
241 
242**Custom style migration**:
243 
244| v2 Field | v3 Field |
245|----------|----------|
246| `custom_styles[].name` | `custom_palettes[].name` |
247| `custom_styles[].description` | `custom_palettes[].description` |
248| `custom_styles[].color_palette` | `custom_palettes[].colors` |
249| `custom_styles[].visual_elements` | `custom_palettes[].decorative_hints` |
250| `custom_styles[].typography` | (removed — determined by rendering) |
251| `custom_styles[].best_for` | `custom_palettes[].best_for` |
252 
253## Migration from v1
254 
255When loading v1 schema, auto-upgrade to v3:
256 
257| v1 Field | v3 Field | Default Value |
258|----------|----------|---------------|
259| (missing) | `version` | 3 |
260| (missing) | `preferred_palette` | null |
261| (missing) | `preferred_rendering` | null |
262| (missing) | `preferred_text` | title-only |
263| (missing) | `preferred_mood` | balanced |
264| (missing) | `quick_mode` | false |
265 
266v1 `--no-title` flag maps to `preferred_text: none`.
267