1---
2name: first-time-setup
3description: First-time setup flow for baoyu-comic 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/source material
14- Ask about art style or tone
15- Ask about layout preferences
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 preferred language for all questions. Do not always use English.
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 comic pages? 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 Art Style
59 
60```
61header: "Art"
62question: "Default art style preference? Or type another style name"
63options:
64  - label: "Auto-select (Recommended)"
65    description: "Auto-select based on content analysis"
66  - label: "ligne-claire"
67    description: "Uniform lines, flat colors, European comic (Tintin style)"
68  - label: "manga"
69    description: "Japanese manga style, expressive eyes and emotions"
70  - label: "realistic"
71    description: "Digital painting, sophisticated and professional"
72```
73 
74### Question 3: Preferred Tone
75 
76```
77header: "Tone"
78question: "Default tone/mood preference?"
79options:
80  - label: "Auto-select (Recommended)"
81    description: "Auto-select based on content signals"
82  - label: "neutral"
83    description: "Balanced, rational, educational"
84  - label: "warm"
85    description: "Nostalgic, personal, comforting"
86  - label: "dramatic"
87    description: "High contrast, intense, powerful"
88```
89 
90### Question 4: Language
91 
92```
93header: "Language"
94question: "Output language for comic text?"
95options:
96  - label: "Auto-detect (Recommended)"
97    description: "Match source content language"
98  - label: "zh"
99    description: "Chinese (中文)"
100  - label: "en"
101    description: "English"
102```
103 
104### Question 5: Save Location
105 
106```
107header: "Save"
108question: "Where to save preferences?"
109options:
110  - label: "Project"
111    description: ".baoyu-skills/ (this project only)"
112  - label: "User"
113    description: "~/.baoyu-skills/ (all projects)"
114```
115 
116## Save Locations
117 
118| Choice | Path | Scope |
119|--------|------|-------|
120| Project | `.baoyu-skills/baoyu-comic/EXTEND.md` | Current project |
121| User | `~/.baoyu-skills/baoyu-comic/EXTEND.md` | All projects |
122 
123## After Setup
124 
1251. Create directory if needed
1262. Write EXTEND.md with frontmatter
1273. Confirm: "Preferences saved to [path]"
1284. Continue to Step 1
129 
130## EXTEND.md Template
131 
132```yaml
133---
134version: 2
135watermark:
136  enabled: [true/false]
137  content: "[user input or empty]"
138  position: bottom-right
139  opacity: 0.5
140preferred_art: [selected art style or null]
141preferred_tone: [selected tone or null]
142preferred_layout: null
143preferred_aspect: null
144language: [selected or null]
145preferred_image_backend: auto
146character_presets: []
147---
148```
149 
150`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.
151 
152## Modifying Preferences Later
153 
154See the `## Changing Preferences` section in `SKILL.md` for the canonical list of common edits (pin backend, change defaults, retrigger setup). Full schema: `config/preferences-schema.md`.
155