Files
baoyu-skills/skills/baoyu-slide-deck/references/config/preferences-schema.md
T
Jim Liu 宝玉 c3cbce9ce3 feat\!: rename baoyu-imagine→baoyu-image-gen, baoyu-image-cards→baoyu-xhs-images (v2.0.0)
BREAKING CHANGE: removed `baoyu-imagine` and `baoyu-image-cards`. All
functionality now lives under `baoyu-image-gen` and `baoyu-xhs-images`
respectively. Cross-skill `## Image Generation Tools` examples updated
across baoyu-article-illustrator, baoyu-comic, baoyu-cover-image,
baoyu-infographic, and baoyu-slide-deck.

Migration: existing `~/.baoyu-skills/baoyu-imagine/EXTEND.md` configs are
auto-renamed to `…/baoyu-image-gen/EXTEND.md` on first run via the
legacy-path resolver in `scripts/main.ts`.
2026-05-24 18:35:05 -05:00

3.9 KiB

EXTEND.md Schema

Structure for user preferences in .baoyu-skills/baoyu-slide-deck/EXTEND.md.

Full Schema

# Slide Deck Preferences

## Defaults
style: blueprint              # Preset name OR "custom"
audience: general             # beginners | intermediate | experts | executives | general
language: auto                # auto | en | zh | ja | etc.
review: true                  # true = review outline before generation
preferred_image_backend: auto # auto | ask | <backend-id>
generation_batch_size: 4      # 1-8, used when backend/runtime supports batch or parallel slide generation

## Custom Dimensions (only when style: custom)
dimensions:
  texture: clean              # clean | grid | organic | pixel | paper
  mood: professional          # professional | warm | cool | vibrant | dark | neutral
  typography: geometric       # geometric | humanist | handwritten | editorial | technical
  density: balanced           # minimal | balanced | dense

## Custom Styles (optional)
custom_styles:
  my-style:
    texture: organic
    mood: warm
    typography: humanist
    density: minimal
    description: "My custom warm and friendly style"

Field Descriptions

Defaults

Field Type Default Description
style string blueprint Preset name, custom, or custom style name
audience string general Default target audience
language string auto Output language (auto = detect from input)
review boolean true Show outline review before generation
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.
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.

Custom Dimensions

Only used when style: custom. Defines dimension values directly.

Field Options Default
texture clean, grid, organic, pixel, paper clean
mood professional, warm, cool, vibrant, dark, neutral professional
typography geometric, humanist, handwritten, editorial, technical geometric
density minimal, balanced, dense balanced

Custom Styles

Define reusable custom dimension combinations.

custom_styles:
  style-name:
    texture: <texture>
    mood: <mood>
    typography: <typography>
    density: <density>
    description: "Optional description"

Then use with: /baoyu-slide-deck content.md --style style-name

Minimal Examples

Just change default style

style: sketch-notes

Prefer no reviews

review: false

Custom default dimensions

style: custom
dimensions:
  texture: organic
  mood: professional
  typography: humanist
  density: minimal

Define reusable custom style

custom_styles:
  brand-style:
    texture: clean
    mood: vibrant
    typography: editorial
    density: balanced
    description: "Company brand style"

File Locations

Priority order (first found wins):

  1. .baoyu-skills/baoyu-slide-deck/EXTEND.md (project)
  2. $HOME/.baoyu-skills/baoyu-slide-deck/EXTEND.md (user)

First-Time Setup

When no EXTEND.md exists, the skill prompts for initial preferences:

  1. Preferred style (preset or custom)
  2. Default audience
  3. Language preference
  4. Review preference
  5. Save location (project or user)

Creates EXTEND.md at chosen location.