宝玉知识信息图

Preferences Schema#

Full Schema#

---

version: 1



preferred_layout: null    # any of the 21 layouts (see Layout Gallery in SKILL.md) or null

preferred_style: null     # any of the 21 styles (see Style Gallery in SKILL.md) or null

preferred_aspect: null    # landscape|portrait|square|null  (custom W:H also accepted)



language: null            # zh|en|ja|ko|null (null = auto-detect from source)



preferred_image_backend: auto   # auto|ask|<backend-id>



custom_styles:            # extra style definitions merged with the 21 built-ins

  - name: my-brand

    description: "Short description shown in Step 3 recommendations"

    prompt_fragment: "Style traits to inject into Step 5 prompt"

---

Field Reference#

Field	Type	Default	Description
version	int	1	Schema version
preferred_layout	string|null	null	Pre-selected layout — surfaces as the top recommendation in Step 3
preferred_style	string|null	null	Pre-selected style — surfaces as the top recommendation in Step 3
preferred_aspect	string|null	null	Default aspect for Step 4 (named preset or W:H string)
language	string|null	null	Output language (null = auto-detect from source content)
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.
custom_styles	array	[]	Additional styles available alongside the 21 built-ins

Backend resolution logic is documented in the ## Image Generation Tools section of SKILL.md. This doc only defines the field.

All fields in this schema are defaults only — they shape Step-3 recommendations and Step-4 defaults but never bypass Step 4 confirmation (see the ## Confirmation Policy section in SKILL.md).

Example backend ids:

Value	Meaning
codex-imagegen	Codex built-in imagegen tool
baoyu-image-gen	baoyu-image-gen skill / script backend
image_generate	Generic runtime image tool such as Hermes

Layout Options#

See the Layout Gallery (21) table in SKILL.md for the canonical list. Common picks:

Value	Best For
bento-grid	General default — overview, multiple topics
linear-progression	Timelines, processes, tutorials
dense-modules	High-density modules, data-rich guides
hub-spoke	Central concept with related items
dashboard	Metrics, KPIs

Style Options#

See the Style Gallery (21) table in SKILL.md for the canonical list. Common picks:

Value	Description
craft-handmade	Hand-drawn, paper craft (default)
corporate-memphis	Flat vector, vibrant
morandi-journal	Hand-drawn doodle, warm Morandi tones
pop-laboratory	Blueprint grid, lab precision
retro-pop-grid	1970s retro pop art, Swiss grid

Aspect Options#

Value	Ratio	Notes
landscape	16:9	Slides, blog headers, web banners
portrait	9:16	Mobile, social, dense modules (default for dense-modules)
square	1:1	Social posts, thumbnails
Custom W:H	e.g. 3:4, 4:3, 2.35:1	Pass through verbatim to the prompt

Custom Style Fields#

Field	Required	Description
name	Yes	Unique style identifier (kebab-case)
description	Yes	One-line description shown in Step 3 recommendations
prompt_fragment	Yes	Style traits appended into the Step 5 prompt body

Example: Minimal Preferences#

---

version: 1

preferred_layout: bento-grid

preferred_style: craft-handmade

language: zh

---

preferred_image_backend is omitted above; absence is treated as auto.

Example: Full Preferences#

---

version: 1



preferred_layout: dense-modules

preferred_style: morandi-journal

preferred_aspect: portrait



language: zh



preferred_image_backend: codex-imagegen



custom_styles:

  - name: my-brand

    description: "Brand-aligned warm pastel infographic"

    prompt_fragment: "Use brand pastel palette (#F2C7B6, #B6D7E8, #C8E0B4); rounded rectangles; warm hand-drawn outlines; ample whitespace."

---