baoyu-skills/skills/baoyu-xhs-images/references/first-time-setup.md

name, description

name	description
first-time-setup	First-time setup flow for baoyu-xhs-images preferences

First-Time Setup

Overview

When no EXTEND.md is found, guide user through preference setup.

Setup Flow

No EXTEND.md found
        │
        ▼
┌─────────────────────┐
│ AskUserQuestion     │
│ (all questions)     │
└─────────────────────┘
        │
        ▼
┌─────────────────────┐
│ Create EXTEND.md    │
└─────────────────────┘
        │
        ▼
    Continue to Step 1

Questions

Use single AskUserQuestion with multiple questions (AskUserQuestion auto-adds "Other" option):

Question 1: Watermark

header: "Watermark"
question: "Enable watermark on generated images?"
options:
  - label: "Enabled"
    description: "Add watermark to all images"
  - label: "Disabled"
    description: "No watermark (can enable later)"

Question 2: Watermark Content (if enabled)

header: "Content"
question: "What text for your watermark?"
options:
  - label: "@username"
    description: "Your XHS handle (replace 'username')"
  - label: "Custom text"
    description: "Enter your own text"

Question 3: Watermark Position (if enabled)

header: "Position"
question: "Where to place watermark?"
options:
  - label: "bottom-right"
    description: "Lower right corner (most common)"
  - label: "bottom-left"
    description: "Lower left corner"
  - label: "bottom-center"
    description: "Bottom center"
  - label: "top-right"
    description: "Upper right corner"

Question 4: Preferred Style

header: "Style"
question: "Default visual style preference?"
options:
  - label: "cute"
    description: "Sweet, adorable - classic XHS aesthetic"
  - label: "notion"
    description: "Minimalist hand-drawn, intellectual"
  - label: "None"
    description: "Auto-select based on content"

Question 5: Save Location

header: "Save"
question: "Where to save preferences?"
options:
  - label: "Project"
    description: ".baoyu-skills/ (this project only)"
  - label: "User"
    description: "~/.baoyu-skills/ (all projects)"

Save Locations

Choice	Path	Scope
Project	.baoyu-skills/baoyu-xhs-images/EXTEND.md	Current project
User	~/.baoyu-skills/baoyu-xhs-images/EXTEND.md	All projects

After Setup

1. Create directory if needed
2. Write EXTEND.md with frontmatter
3. Confirm: "Preferences saved to [path]"
4. Continue to Step 1

EXTEND.md Template

---
version: 1
watermark:
  enabled: [true/false]
  content: "[user input]"
  position: [selected position]
  opacity: 0.7
preferred_style:
  name: [selected style or null]
  description: ""
preferred_layout: null
language: null
custom_styles: []
---

Modifying Preferences Later

Users can edit EXTEND.md directly or run setup again:

• Delete EXTEND.md to trigger setup
• Edit YAML frontmatter for quick changes
• Full schema: references/preferences-schema.md