baoyu-url-to-markdown

Name: baoyu-url-to-markdown
Author: JimLiu

28kinstalls2.7kforks

How to install baoyu-url-to-markdown?

jimliu/baoyu-skills/baoyu-url-to-markdown

$npx -y skills add jimliu/baoyu-skills --skill baoyu-url-to-markdown

Installs into the current project.

Summary

Fetch any URL and convert to markdown using baoyu-fetch CLI (Chrome CDP with site-specific adapters). Built-in adapters for X/Twitter, YouTube transcripts, Hacker News threads, and generic pages via Defuddle. Handles login/CAPTCHA via interaction wait modes. Use when user wants t

Files · 1

View on GitHub

SKILL.md

1	# URL to Markdown
2
3	Fetches any URL via `baoyu-fetch` CLI (Chrome CDP + site-specific adapters) and converts it to clean markdown.
4
5	## User Input Tools
6
7	When this skill prompts the user, follow this tool-selection rule (priority order):
8
9	1. Prefer built-in user-input tools exposed by the current agent runtime — e.g., `AskUserQuestion`, `request_user_input`, `clarify`, `ask_user`, or any equivalent.
10	2. Fallback: if no such tool exists, emit a numbered plain-text message and ask the user to reply with the chosen number/answer for each question.
11	3. Batching: if the tool supports multiple questions per call, combine all applicable questions into a single call; if only single-question, ask them one at a time in priority order.
12
13	Concrete `AskUserQuestion` references below are examples — substitute the local equivalent in other runtimes.
14
15	## CLI Setup
16
17	Important: The CLI source is vendored in `{baseDir}/scripts/lib`. `scripts/package.json` installs only third-party runtime dependencies.
18
19	Agent Execution Instructions:
20	1. Determine this SKILL.md file's directory path as `{baseDir}`
21	2. Resolve `${BUN}` runtime: if `bun` installed → `bun`; else suggest installing Bun
22	3. If `{baseDir}/scripts/node_modules` does not exist, run `${BUN} install --cwd {baseDir}/scripts`
23	4. `${READER}` = `{baseDir}/scripts/baoyu-fetch`
24	5. Replace all `${READER}` in this document with the resolved value
25
26	## Preferences (EXTEND.md)
27
28	Check EXTEND.md in priority order — the first one found wins:
29
30	\| Priority \| Path \| Scope \|
31	\|----------\|------\|-------\|
32	\| 1 \| `.baoyu-skills/baoyu-url-to-markdown/EXTEND.md` \| Project \|
33	\| 2 \| `${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-url-to-markdown/EXTEND.md` \| XDG \|
34	\| 3 \| `$HOME/.baoyu-skills/baoyu-url-to-markdown/EXTEND.md` \| User home \|
35
36	\| Result \| Action \|
37	\|--------\|--------\|
38	\| Found \| Read, parse, apply settings \|
39	\| Not found \| MUST run first-time setup (see below) — do NOT silently create defaults \|
40
41	EXTEND.md supports: download media by default, default output directory.
42
43	### First-Time Setup ⛔ BLOCKING
44
45	When EXTEND.md is not found, you MUST use `AskUserQuestion` to gather preferences before creating EXTEND.md. NEVER create EXTEND.md with silent defaults. Generation is BLOCKED until setup completes. Batch all three questions into a single call:
46
47	- Q1 — Media (header "Media"): "How to handle images and videos in pages?"
48	- "Ask each time (Recommended)" — Prompt after each save
49	- "Always download" — Download to local `imgs/` and `videos/`
50	- "Never download" — Keep remote URLs
51	- Q2 — Output (header "Output"): "Default output directory?"
52	- "url-to-markdown (Recommended)" — Save to `./url-to-markdown/{domain}/{slug}.md`
53	- User may pick "Other" and type a custom path
54	- Q3 — Save (header "Save"): "Where to save preferences?"
55	- "User (Recommended)" — `~/.baoyu-skills/` (all projects)
56	- "Project" — `.baoyu-skills/` (this project only)
57
58	After answers, write EXTEND.md, confirm "Preferences saved to [path]", then continue.
59
60	Full template: [references/config/first-time-setup.md](references/config/first-time-setup.md).
61
62	### Supported Keys
63
64	\| Key \| Default \| Values \| Description \|
65	\|-----\|---------\|--------\|-------------\|
66	\| `download_media` \| `ask` \| `ask` / `1` / `0` \| `ask` = prompt each time, `1` = always, `0` = never \|
67	\| `default_output_dir` \| empty \| path or empty \| Default output directory (empty = `./url-to-markdown/`) \|
68
69	EXTEND.md → CLI mapping:
70
71	\| EXTEND.md key \| CLI argument \| Notes \|
72	\|---------------\|-------------\|-------\|
73	\| `download_media: 1` \| `--download-media` \| Requires `--output` to be set \|
74	\| `default_output_dir: ./posts/` \| Agent constructs `--output ./posts/{domain}/{slug}.md` \| Agent generates path, not a direct flag \|
75
76	Value priority: CLI arguments → EXTEND.md → skill defaults.
77
78	## Usage
79
80	```bash
81	# Default: headless capture, markdown to stdout
82	${READER} <url>
83
84	# Save to file
85	${READER} <url> --output article.md
86
87	# Save with media download
88	${READER} <url> --output article.md --download-media
89
90	# Wait for interaction (login/CAPTCHA) — auto-detect and continue
91	${READER} <url> --wait-for interaction --output article.md
92
93	# Wait for interaction — manual control (Enter to continue)
94	${READER} <url> --wait-for force --output article.md
95
96	# JSON output
97	${READER} <url> --format json --output article.json
98
99	# Force specific adapter
100	${READER} <url> --adapter youtube --output transcript.md
101	```
102
103	## Options
104
105	\| Option \| Description \|
106	\|-

People who liked this also viewed

6 picks

Type

baoyu-url-to-markdown

28kinstalls2.7kforks

View on GitHub

How to install baoyu-url-to-markdown?

jimliu/baoyu-skills/baoyu-url-to-markdown

$npx -y skills add jimliu/baoyu-skills --skill baoyu-url-to-markdown

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# URL to Markdown
2
3	Fetches any URL via `baoyu-fetch` CLI (Chrome CDP + site-specific adapters) and converts it to clean markdown.
4
5	## User Input Tools
6
7	When this skill prompts the user, follow this tool-selection rule (priority order):
8
9	1. Prefer built-in user-input tools exposed by the current agent runtime — e.g., `AskUserQuestion`, `request_user_input`, `clarify`, `ask_user`, or any equivalent.
10	2. Fallback: if no such tool exists, emit a numbered plain-text message and ask the user to reply with the chosen number/answer for each question.
11	3. Batching: if the tool supports multiple questions per call, combine all applicable questions into a single call; if only single-question, ask them one at a time in priority order.
12
13	Concrete `AskUserQuestion` references below are examples — substitute the local equivalent in other runtimes.
14
15	## CLI Setup
16
17	Important: The CLI source is vendored in `{baseDir}/scripts/lib`. `scripts/package.json` installs only third-party runtime dependencies.
18
19	Agent Execution Instructions:
20	1. Determine this SKILL.md file's directory path as `{baseDir}`
21	2. Resolve `${BUN}` runtime: if `bun` installed → `bun`; else suggest installing Bun
22	3. If `{baseDir}/scripts/node_modules` does not exist, run `${BUN} install --cwd {baseDir}/scripts`
23	4. `${READER}` = `{baseDir}/scripts/baoyu-fetch`
24	5. Replace all `${READER}` in this document with the resolved value
25
26	## Preferences (EXTEND.md)
27
28	Check EXTEND.md in priority order — the first one found wins:
29
30	\| Priority \| Path \| Scope \|
31	\|----------\|------\|-------\|
32	\| 1 \| `.baoyu-skills/baoyu-url-to-markdown/EXTEND.md` \| Project \|
33	\| 2 \| `${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-url-to-markdown/EXTEND.md` \| XDG \|
34	\| 3 \| `$HOME/.baoyu-skills/baoyu-url-to-markdown/EXTEND.md` \| User home \|
35
36	\| Result \| Action \|
37	\|--------\|--------\|
38	\| Found \| Read, parse, apply settings \|
39	\| Not found \| MUST run first-time setup (see below) — do NOT silently create defaults \|
40
41	EXTEND.md supports: download media by default, default output directory.
42
43	### First-Time Setup ⛔ BLOCKING
44
45	When EXTEND.md is not found, you MUST use `AskUserQuestion` to gather preferences before creating EXTEND.md. NEVER create EXTEND.md with silent defaults. Generation is BLOCKED until setup completes. Batch all three questions into a single call:
46
47	- Q1 — Media (header "Media"): "How to handle images and videos in pages?"
48	- "Ask each time (Recommended)" — Prompt after each save
49	- "Always download" — Download to local `imgs/` and `videos/`
50	- "Never download" — Keep remote URLs
51	- Q2 — Output (header "Output"): "Default output directory?"
52	- "url-to-markdown (Recommended)" — Save to `./url-to-markdown/{domain}/{slug}.md`
53	- User may pick "Other" and type a custom path
54	- Q3 — Save (header "Save"): "Where to save preferences?"
55	- "User (Recommended)" — `~/.baoyu-skills/` (all projects)
56	- "Project" — `.baoyu-skills/` (this project only)
57
58	After answers, write EXTEND.md, confirm "Preferences saved to [path]", then continue.
59
60	Full template: [references/config/first-time-setup.md](references/config/first-time-setup.md).
61
62	### Supported Keys
63
64	\| Key \| Default \| Values \| Description \|
65	\|-----\|---------\|--------\|-------------\|
66	\| `download_media` \| `ask` \| `ask` / `1` / `0` \| `ask` = prompt each time, `1` = always, `0` = never \|
67	\| `default_output_dir` \| empty \| path or empty \| Default output directory (empty = `./url-to-markdown/`) \|
68
69	EXTEND.md → CLI mapping:
70
71	\| EXTEND.md key \| CLI argument \| Notes \|
72	\|---------------\|-------------\|-------\|
73	\| `download_media: 1` \| `--download-media` \| Requires `--output` to be set \|
74	\| `default_output_dir: ./posts/` \| Agent constructs `--output ./posts/{domain}/{slug}.md` \| Agent generates path, not a direct flag \|
75
76	Value priority: CLI arguments → EXTEND.md → skill defaults.
77
78	## Usage
79
80	```bash
81	# Default: headless capture, markdown to stdout
82	${READER} <url>
83
84	# Save to file
85	${READER} <url> --output article.md
86
87	# Save with media download
88	${READER} <url> --output article.md --download-media
89
90	# Wait for interaction (login/CAPTCHA) — auto-detect and continue
91	${READER} <url> --wait-for interaction --output article.md
92
93	# Wait for interaction — manual control (Enter to continue)
94	${READER} <url> --wait-for force --output article.md
95
96	# JSON output
97	${READER} <url> --format json --output article.json
98
99	# Force specific adapter
100	${READER} <url> --adapter youtube --output transcript.md
101	```
102
103	## Options
104
105	\| Option \| Description \|
106	\|-

People who liked this also viewed

6 picks

Type