1---
2name: first-time-setup
3description: First-time setup flow for baoyu-xhs-images preferences
4---
5 
6# First-Time Setup
7 
8## Overview
9 
10When no EXTEND.md is found, guide user through preference setup.
11 
12**⛔ BLOCKING OPERATION**: This setup MUST complete before ANY other workflow steps. Do NOT:
13- Ask about content/article
14- Ask about style or layout
15- Ask about target audience
16- Proceed to content analysis
17 
18ONLY ask the questions in this setup flow, save EXTEND.md, then continue.
19 
20## Setup Flow
21 
22```
23No EXTEND.md found
24        │
25        ▼
26┌─────────────────────┐
27│ AskUserQuestion     │
28│ (all questions)     │
29└─────────────────────┘
30        │
31        ▼
32┌─────────────────────┐
33│ Create EXTEND.md    │
34└─────────────────────┘
35        │
36        ▼
37    Continue to Step 1
38```
39 
40## Questions
41 
42**Language**: Use user's input language or saved language preference.
43 
44Use single AskUserQuestion with multiple questions (AskUserQuestion auto-adds "Other" option):
45 
46### Question 1: Watermark
47 
48```
49header: "Watermark"
50question: "Watermark text for generated images? Type your watermark content (e.g., name, @handle)"
51options:
52  - label: "No watermark (Recommended)"
53    description: "No watermark, can enable later in EXTEND.md"
54```
55 
56Position defaults to bottom-right.
57 
58### Question 2: Preferred Style
59 
60```
61header: "Style"
62question: "Default visual style preference? Or type another style name or your custom style"
63options:
64  - label: "None (Recommended)"
65    description: "Auto-select based on content analysis"
66  - label: "cute"
67    description: "Sweet, adorable - classic XHS aesthetic"
68  - label: "notion"
69    description: "Minimalist hand-drawn, intellectual"
70```
71 
72### Question 3: Save Location
73 
74```
75header: "Save"
76question: "Where to save preferences?"
77options:
78  - label: "Project"
79    description: ".baoyu-skills/ (this project only)"
80  - label: "User"
81    description: "~/.baoyu-skills/ (all projects)"
82```
83 
84## Save Locations
85 
86| Choice | Path | Scope |
87|--------|------|-------|
88| Project | `.baoyu-skills/baoyu-xhs-images/EXTEND.md` | Current project |
89| User | `~/.baoyu-skills/baoyu-xhs-images/EXTEND.md` | All projects |
90 
91## After Setup
92 
931. Create directory if needed
942. Write EXTEND.md with frontmatter
953. Confirm: "Preferences saved to [path]"
964. Continue to Step 1
97 
98## EXTEND.md Template
99 
100```yaml
101---
102version: 1
103watermark:
104  enabled: [true/false]
105  content: "[user input or empty]"
106  position: bottom-right
107  opacity: 0.7
108preferred_style:
109  name: [selected style or null]
110  description: ""
111preferred_layout: null
112language: null
113preferred_image_backend: auto
114custom_styles: []
115---
116```
117 
118`preferred_image_backend: auto` is the baked-in default — first-time setup does not ask about it. The `## Image Generation Tools` rule in SKILL.md then picks the runtime-native tool (Codex `imagegen`, Hermes `image_generate`, etc.) when available, and falls back to installed backends.
119 
120## Modifying Preferences Later
121 
122See the `## Changing Preferences` section in `SKILL.md` for the canonical list of common edits (pin backend, change defaults, retrigger setup). Full schema: `preferences-schema.md`.
123