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.

Quality

85%

Does it follow best practices?

Impact

—

No eval scenarios have been run

Securityby

Advisory

Suggest reviewing before use

Quality

Content

85%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-structured, highly actionable skill that provides clear CLI usage, concrete examples, and good progressive disclosure to reference files. The workflow is well-sequenced with explicit validation (quality gate) and blocking steps (first-time setup). Minor verbosity in the User Input Tools preamble and some redundancy in the Extension Support section prevent a perfect conciseness score.

Suggestions

Remove the 'Extension Support' section at the bottom — it's entirely redundant with the Preferences section and adds no new information.

Trim the 'User Input Tools' section to 2-3 lines; Claude doesn't need detailed fallback logic for tool selection explained at this length.

Dimension	Reasoning	Score
Conciseness	The skill is reasonably efficient but includes some redundancy — the 'Extension Support' section at the end is entirely redundant with the Preferences section, the User Input Tools section is verbose for something Claude can infer, and the EXTEND.md first-time setup flow is quite detailed. The options table is comprehensive but borderline excessive given Claude could infer many defaults.	2 / 3
Actionability	The skill provides fully executable CLI commands with concrete examples, a clear setup sequence, specific flag documentation, and a well-defined output path generation algorithm. The usage examples are copy-paste ready and cover common scenarios.	3 / 3
Workflow Clarity	The multi-step workflows are clearly sequenced: CLI setup has numbered steps with dependency checks, first-time setup is explicitly marked as BLOCKING with clear question flow, and the quality gate provides a validation checkpoint after every headless run with references to a recovery workflow. The output path generation algorithm is step-by-step with conflict resolution.	3 / 3
Progressive Disclosure	Content is well-structured with a clear overview in SKILL.md and appropriate references to separate files: references/quality-gate.md for the quality checklist, references/adapters.md for adapter details, and references/config/first-time-setup.md for the setup template. All references are one level deep and clearly signaled with context about when to consult them.	3 / 3
	Total	11 / 12 Passed

Description

85%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a strong description that clearly identifies the tool, its capabilities, and specific supported platforms. The main weakness is the trigger term coverage—the 'Use when' clause is somewhat narrow and misses common user phrasings like 'scrape', 'download', or 'read website'. The specificity and distinctiveness are excellent, making it easy to differentiate from other skills.

Suggestions

Broaden the 'Use when' clause to include more natural trigger terms users might say, such as 'scrape a website', 'download page content', 'read a URL', 'get article text', or 'extract web content'.

Dimension	Reasoning	Score
Specificity	Lists multiple specific concrete actions: fetch URLs, convert to markdown, handle login/CAPTCHA, and names specific adapters for X/Twitter, YouTube transcripts, Hacker News threads. Also mentions the specific tool (baoyu-fetch CLI) and underlying technology (Chrome CDP).	3 / 3
Completeness	Clearly answers both 'what' (fetch URLs, convert to markdown, handle login/CAPTCHA, site-specific adapters) and 'when' ('Use when user wants to save a webpage as markdown'). The 'Use when' clause is present and explicit, though it could be broader.	3 / 3
Trigger Term Quality	Includes some good natural terms like 'URL', 'markdown', 'webpage', 'X/Twitter', 'YouTube transcripts', 'Hacker News'. However, it's missing common user variations like 'scrape', 'download page', 'read website', 'web content', 'fetch article', or 'save page'. The 'Use when' clause is narrow ('save a webpage as markdown') and doesn't cover the breadth of how users might request this.	2 / 3
Distinctiveness Conflict Risk	Very distinct niche: fetching URLs and converting to markdown via a specific CLI tool with named site-specific adapters. The combination of web fetching, markdown conversion, and specific platform support (X/Twitter, YouTube, Hacker News) makes it clearly distinguishable from other skills.	3 / 3
	Total	11 / 12 Passed

Validation

72%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 8 / 11 Passed

Validation for skill structure

Criteria	Description	Result
metadata_version	'metadata.version' is missing	Warning
metadata_field	'metadata' should map string keys to string values	Warning
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	8 / 11 Passed

Repository: jimliu/baoyu-skills
Commit: ce84174

Reviewed: 4 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.