1---
2name: first-time-setup
3description: First-time setup flow for baoyu-article-illustrator 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 type or style 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 illustrations? 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 illustration style preference? Or type another style name or your custom style"
63options:
64  - label: "sketch-notes (Recommended)"
65    description: "Warm cream paper, black hand-drawn lines, soft pastel blocks — educational infographic feel. Great default for most articles."
66  - label: "None"
67    description: "Auto-select based on content analysis (falls back to sketch-notes when no strong signal)"
68  - label: "notion"
69    description: "Minimalist hand-drawn line art"
70  - label: "warm"
71    description: "Friendly, approachable, personal"
72```
73 
74### Question 3: Output Directory
75 
76```
77header: "Output Directory"
78question: "Where to save generated illustrations when illustrating a file?"
79options:
80  - label: "imgs-subdir (Recommended)"
81    description: "{article-dir}/imgs/ — images in a subdirectory next to the article"
82  - label: "same-dir"
83    description: "{article-dir}/ — images alongside the article file"
84  - label: "illustrations-subdir"
85    description: "{article-dir}/illustrations/ — separate illustrations subdirectory"
86  - label: "independent"
87    description: "illustrations/{topic-slug}/ — standalone directory in cwd"
88```
89 
90### Question 4: Save Location
91 
92```
93header: "Save"
94question: "Where to save preferences?"
95options:
96  - label: "Project"
97    description: ".baoyu-skills/ (this project only)"
98  - label: "User"
99    description: "~/.baoyu-skills/ (all projects)"
100```
101 
102## Save Locations
103 
104| Choice | Path | Scope |
105|--------|------|-------|
106| Project | `.baoyu-skills/baoyu-article-illustrator/EXTEND.md` | Current project |
107| User | `~/.baoyu-skills/baoyu-article-illustrator/EXTEND.md` | All projects |
108 
109## After Setup
110 
1111. Create directory if needed
1122. Write EXTEND.md with frontmatter
1133. Confirm: "Preferences saved to [path]"
1144. Continue to Step 1
115 
116## EXTEND.md Template
117 
118```yaml
119---
120version: 1
121watermark:
122  enabled: [true/false]
123  content: "[user input or empty]"
124  position: bottom-right
125  opacity: 0.7
126preferred_style:
127  name: [selected style or null]
128  description: ""
129default_output_dir: imgs-subdir  # same-dir | imgs-subdir | illustrations-subdir | independent
130language: null
131preferred_image_backend: auto
132custom_styles: []
133---
134```
135 
136`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.
137 
138## Modifying Preferences Later
139 
140See 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`.
141