Agent skill · writing content · jimliu
baoyu-url-to-markdown
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 to save a webpage as markdown.
Why this skill is useful
Adds a CLI tool for converting web pages to markdown with specific site adapters and user interaction handling that the AI wouldn't generate on its own.
What it needs
Requires bun installed locally. About 5k tokens when loaded. Last updated 2026-07-04. 24,677 stars on the source repository.
What this skill does
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, requestuserinput, clarify, askuser, 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: 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/nodemodules does not exist, run ${BUN} install --cwd {baseDir}/scripts 4. ${READER} = {baseDir}/scripts/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: Priority Path Scope ---------- ------ ------- 1 .baoyu-skills/baoyu-url-to-markdown/EXTEND.md Project 2 ${XDGCONFIGHOME:-$HOME/.config}/baoyu-skills/baoyu-url-to-markdown/EXTEND.md XDG 3 $HOME/.baoyu-skills/baoyu-url-to-markdown/EXTEND.md User home Result Action -------- -------- Found Read, parse, apply settings Not found MUST run first-time setup (see below) — do NOT silently create defaults EXTEND.md supports: download media by default, default output directory. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jimliu/baoyu-url-to-markdown