baoyu-url-to-markdown

Installation
Summary

Fetch any URL and convert to clean markdown using Chrome CDP with intelligent fallback conversion.

  • Supports two capture modes: auto-capture on page load or wait-for-user-signal for login-required and lazy-loading pages
  • Saves rendered HTML snapshot alongside markdown output with YAML front matter including metadata, URL, title, and capture timestamp
  • Upgraded Defuddle-based conversion pipeline with automatic fallback to legacy HTML-to-Markdown extractor; falls back to hosted defuddle.md API if local browser capture fails entirely
  • Handles web components via shadow DOM materialization and extracts YouTube transcripts when available
  • Optional media download: automatically saves images and videos to local directories and rewrites markdown links to relative paths
SKILL.md

URL to Markdown

Fetches any URL via baoyu-fetch CLI (Chrome CDP + site-specific adapters) and converts it to clean markdown.

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 references below are examples — substitute the local equivalent in other runtimes.

CLI Setup

Important: The CLI source is vendored in {baseDir}/scripts/lib. scripts/package.json installs only third-party runtime dependencies.

Agent Execution Instructions:

Related skills

More from jimliu/baoyu-skills

Installs
19.8K
GitHub Stars
18.1K
First Seen
Jan 22, 2026