1---
2name: first-time-setup
3description: First-time setup flow for baoyu-url-to-markdown 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- Start converting URLs
14- Ask about URLs or output paths
15- Proceed to any conversion
16 
17ONLY ask the questions in this setup flow, save EXTEND.md, then continue.
18 
19## Setup Flow
20 
21```
22No EXTEND.md found
23        |
24        v
25+---------------------+
26| AskUserQuestion     |
27| (all questions)     |
28+---------------------+
29        |
30        v
31+---------------------+
32| Create EXTEND.md    |
33+---------------------+
34        |
35        v
36    Continue conversion
37```
38 
39## Questions
40 
41**Language**: Use user's input language or saved language preference.
42 
43Use AskUserQuestion with ALL questions in ONE call:
44 
45### Question 1: Download Media
46 
47```yaml
48header: "Media"
49question: "How to handle images and videos in pages?"
50options:
51  - label: "Ask each time (Recommended)"
52    description: "After saving markdown, ask whether to download media"
53  - label: "Always download"
54    description: "Always download media to local imgs/ and videos/ directories"
55  - label: "Never download"
56    description: "Keep original remote URLs in markdown"
57```
58 
59### Question 2: Default Output Directory
60 
61```yaml
62header: "Output"
63question: "Default output directory?"
64options:
65  - label: "url-to-markdown (Recommended)"
66    description: "Save to ./url-to-markdown/{domain}/{slug}.md"
67```
68 
69Note: User will likely choose "Other" to type a custom path.
70 
71### Question 3: Save Location
72 
73```yaml
74header: "Save"
75question: "Where to save preferences?"
76options:
77  - label: "User (Recommended)"
78    description: "~/.baoyu-skills/ (all projects)"
79  - label: "Project"
80    description: ".baoyu-skills/ (this project only)"
81```
82 
83## Save Locations
84 
85| Choice | Path | Scope |
86|--------|------|-------|
87| User | `~/.baoyu-skills/baoyu-url-to-markdown/EXTEND.md` | All projects |
88| Project | `.baoyu-skills/baoyu-url-to-markdown/EXTEND.md` | Current project |
89 
90## After Setup
91 
921. Create directory if needed
932. Write EXTEND.md
943. Confirm: "Preferences saved to [path]"
954. Continue with conversion using saved preferences
96 
97## EXTEND.md Template
98 
99```md
100download_media: [ask/1/0]
101default_output_dir: [path or empty]
102```
103 
104## Modifying Preferences Later
105 
106Users can edit EXTEND.md directly or delete it to trigger setup again.
107