URL to Markdown

Fetches any URL via

baoyu-fetch

User Input Tools

When this skill prompts the user, follow this tool-selection rule (priority order):

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.
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.
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.

Concrete

AskUserQuestion

CLI Setup

Important: The CLI is provided by the npm package dependency

baoyu-fetch

Agent Execution Instructions:

1. Determine this SKILL.md file's directory path as

   {baseDir}

2. Resolve

   ${BUN}

   runtime: if

   bun

   installed →

   bun

   ; else suggest installing Bun
3. If

   {baseDir}/scripts/node_modules/.bin/baoyu-fetch

   does not exist, run

   ${BUN} install --cwd {baseDir}/scripts

4. ${READER}

   =

   {baseDir}/scripts/node_modules/.bin/baoyu-fetch

5. Replace all

   ${READER}

   in this document with the resolved value

Preferences (EXTEND.md)

Check EXTEND.md in priority order — the first one found wins:

.baoyu-skills/baoyu-url-to-markdown/EXTEND.md

${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-url-to-markdown/EXTEND.md

$HOME/.baoyu-skills/baoyu-url-to-markdown/EXTEND.md

EXTEND.md supports: download media by default, default output directory.

First-Time Setup ⛔ BLOCKING

When EXTEND.md is not found, you MUST use

AskUserQuestion

• Q1 — Media (header "Media"): "How to handle images and videos in pages?"
  • "Ask each time (Recommended)" — Prompt after each save
  • "Always download" — Download to local

    imgs/

    and

    videos/

  • "Never download" — Keep remote URLs
• Q2 — Output (header "Output"): "Default output directory?"
  • "url-to-markdown (Recommended)" — Save to

    ./url-to-markdown/{domain}/{slug}.md

  • User may pick "Other" and type a custom path
• Q3 — Save (header "Save"): "Where to save preferences?"
  • "User (Recommended)" —

    ~/.baoyu-skills/

    (all projects)
  • "Project" —

    .baoyu-skills/

    (this project only)

After answers, write EXTEND.md, confirm "Preferences saved to [path]", then continue.

Full template: references/config/first-time-setup.md.

Supported Keys

download_media

ask

ask

1

0

ask

1

0

default_output_dir

./url-to-markdown/

EXTEND.md → CLI mapping:

download_media: 1

--download-media

--output

default_output_dir: ./posts/

--output ./posts/{domain}/{slug}.md

Value priority: CLI arguments → EXTEND.md → skill defaults.

Usage

# Default: headless capture, markdown to stdout
${READER} <url>

# Save to file
${READER} <url> --output article.md

# Save with media download
${READER} <url> --output article.md --download-media

# Wait for interaction (login/CAPTCHA) — auto-detect and continue
${READER} <url> --wait-for interaction --output article.md

# Wait for interaction — manual control (Enter to continue)
${READER} <url> --wait-for force --output article.md

# JSON output
${READER} <url> --format json --output article.json

# Force specific adapter
${READER} <url> --adapter youtube --output transcript.md

Options

<url>

--output <path>

--format <type>

markdown

json

--json

--format json

--adapter <name>

x

youtube

hn

generic

--headless

--wait-for <mode>

none

interaction

force

--wait-for-interaction

--wait-for interaction

--wait-for-login

--wait-for interaction

--timeout <ms>

--interaction-timeout <ms>

--interaction-poll-interval <ms>

--download-media

imgs/

videos/

--output

--media-dir <dir>

--output

--cdp-url <url>

--browser-path <path>

--chrome-profile-dir <path>

BAOYU_CHROME_PROFILE_DIR

./baoyu-skills/chrome-profile

--debug-dir <dir>

Agent Quality Gate

CRITICAL: treat default headless capture as provisional. Some sites render differently in headless mode and can silently return low-quality content without failing the CLI.

After every headless run, inspect the saved markdown. See references/quality-gate.md for the full checklist, recovery workflow, and capture-mode table. Read it whenever a run looks suspicious or the user asks about login/CAPTCHA handling.

Output Path Generation

The agent must construct the output file path —

baoyu-fetch

Algorithm:

1. Determine base directory from EXTEND.md

   default_output_dir

   or default

   ./url-to-markdown/

2. Extract domain from URL (e.g.,

   example.com

   )
3. Generate slug from URL path or page title (kebab-case, 2-6 words)
4. Construct:

   {base_dir}/{domain}/{slug}/{slug}.md

   — each URL gets its own directory so media files stay isolated
5. Conflict resolution: append timestamp

   {slug}-YYYYMMDD-HHMMSS/{slug}-YYYYMMDD-HHMMSS.md

Pass the constructed path to

--output

--download-media

Adapters & Media

See references/adapters.md for the adapter catalog (X, YouTube, Hacker News, generic), per-adapter notes, the media download flow (

ask

Environment Variables

BAOYU_CHROME_PROFILE_DIR

--chrome-profile-dir

Troubleshooting: Chrome not found → use

--browser-path

--timeout

--wait-for interaction

--debug-dir

Extension Support

Custom configurations via EXTEND.md. See Preferences section above for paths and supported keys.