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):
- Prefer built-in user-input tools exposed by the current agent runtime — e.g.,
AskUserQuestion,request_user_input,clarify,ask_user, or any equivalent. - 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.
- 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.