1---
2name: first-time-setup
3description: First-time setup flow for baoyu-cover-image 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 reference images
14- Ask about content/article
15- Ask about dimensions (type, palette, rendering)
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 AskUserQuestion with ALL questions in ONE call:
45 
46### Question 1: Watermark
47 
48```yaml
49header: "Watermark"
50question: "Watermark text for generated cover images?"
51options:
52  - label: "No watermark (Recommended)"
53    description: "Clean covers, can enable later in EXTEND.md"
54```
55 
56### Question 2: Preferred Type
57 
58```yaml
59header: "Type"
60question: "Default cover type preference?"
61options:
62  - label: "Auto-select (Recommended)"
63    description: "Choose based on content analysis each time"
64  - label: "hero"
65    description: "Large visual impact - product launch, announcements"
66  - label: "conceptual"
67    description: "Concept visualization - technical, architecture"
68```
69 
70### Question 3: Preferred Palette
71 
72```yaml
73header: "Palette"
74question: "Default color palette preference?"
75options:
76  - label: "Auto-select (Recommended)"
77    description: "Choose based on content analysis each time"
78  - label: "elegant"
79    description: "Sophisticated - soft coral, muted teal, dusty rose"
80  - label: "warm"
81    description: "Friendly - orange, golden yellow, terracotta"
82  - label: "cool"
83    description: "Technical - engineering blue, navy, cyan"
84```
85 
86### Question 4: Preferred Rendering
87 
88```yaml
89header: "Rendering"
90question: "Default rendering style preference?"
91options:
92  - label: "Auto-select (Recommended)"
93    description: "Choose based on content analysis each time"
94  - label: "hand-drawn"
95    description: "Sketchy organic illustration with personal touch"
96  - label: "flat-vector"
97    description: "Clean modern vector with geometric shapes"
98  - label: "digital"
99    description: "Polished precise digital illustration"
100```
101 
102### Question 5: Default Aspect Ratio
103 
104```yaml
105header: "Aspect"
106question: "Default aspect ratio for cover images?"
107options:
108  - label: "16:9 (Recommended)"
109    description: "Standard widescreen - YouTube, presentations, versatile"
110  - label: "2.35:1"
111    description: "Cinematic widescreen - article headers, blog posts"
112  - label: "1:1"
113    description: "Square - Instagram, WeChat, social cards"
114  - label: "3:4"
115    description: "Portrait - Xiaohongshu, Pinterest, mobile content"
116```
117 
118Note: More ratios (4:3, 3:2) available during generation. This sets the default recommendation.
119 
120### Question 6: Default Output Directory
121 
122```yaml
123header: "Output"
124question: "Default output directory for cover images?"
125options:
126  - label: "Independent (Recommended)"
127    description: "cover-image/{topic-slug}/ - separate from article"
128  - label: "Same directory"
129    description: "{article-dir}/ - alongside the article file"
130  - label: "imgs subdirectory"
131    description: "{article-dir}/imgs/ - images folder near article"
132```
133 
134### Question 7: Quick Mode
135 
136```yaml
137header: "Quick"
138question: "Enable quick mode by default?"
139options:
140  - label: "No (Recommended)"
141    description: "Confirm dimension choices each time"
142  - label: "Yes"
143    description: "Skip confirmation, use auto-selection"
144```
145 
146### Question 8: Save Location
147 
148```yaml
149header: "Save"
150question: "Where to save preferences?"
151options:
152  - label: "Project (Recommended)"
153    description: ".baoyu-skills/ (this project only)"
154  - label: "User"
155    description: "~/.baoyu-skills/ (all projects)"
156```
157 
158## Save Locations
159 
160| Choice | Path | Scope |
161|--------|------|-------|
162| Project | `.baoyu-skills/baoyu-cover-image/EXTEND.md` | Current project |
163| User | `~/.baoyu-skills/baoyu-cover-image/EXTEND.md` | All projects |
164 
165## After Setup
166 
1671. Create directory if needed
1682. Write EXTEND.md with frontmatter
1693. Confirm: "Preferences saved to [path]"
1704. Continue to Step 1
171 
172## EXTEND.md Template
173 
174```yaml
175---
176version: 3
177watermark:
178  enabled: [true/false]
179  content: "[user input or empty]"
180  position: bottom-right
181  opacity: 0.7
182preferred_type: [selected type or null]
183preferred_palette: [selected palette or null]
184preferred_rendering: [selected rendering or null]
185preferred_text: title-only
186preferred_mood: balanced
187default_aspect: [16:9/2.35:1/1:1/3:4]
188default_output_dir: [independent/same-dir/imgs-subdir]
189quick_mode: [true/false]
190language: null
191preferred_image_backend: auto
192custom_palettes: []
193---
194```
195 
196`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.
197 
198## Modifying Preferences Later
199 
200See 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`.
201 
202**EXTEND.md Supports**: Watermark | Preferred type | Preferred palette | Preferred rendering | Preferred text | Preferred mood | Default aspect ratio | Default output directory | Quick mode | Image backend preference | Custom palette definitions | Language preference
203