CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

96%Weight 40%Scale 1-5

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

A well-organized, highly actionable skill body: executable commands with defaults, a clearly sequenced workflow with an explicit quality-gate validation checkpoint, and clean progressive disclosure into real one-level-deep reference files. The only weakness is mild verbosity in the runtime user-input abstraction section.

DimensionReasoningScore

Conciseness

The body is dense — option tables with defaults, terse numbered setup steps, and no explanations of concepts Claude already knows. Minor trimmable spots remain: the "User Input Tools" section spends ~9 lines on runtime tool abstraction, including "Concrete `AskUserQuestion` references below are examples" even though no such concrete references appear below. Anchor 4 ('efficient; minor instances of over-explanation') fits better than 5, and far better than 3.

4 / 5

Actionability

Quotes: "${READER} <url> --output article.md --download-media", "${BUN} install --cwd {baseDir}/scripts", the full options table with defaults (e.g. "--interaction-timeout <ms> ... default: 600000"), and numbered output-path construction ("Path: {base_dir}/{domain}/{slug}/{slug}.md"). Commands are copy-paste ready once ${READER} is defined by an explicit setup step, and the usage examples cover the common cases (stdout, save+media, login/CAPTCHA, JSON, forced adapter) — matching anchor 5, not anchor 4 which expects minor gaps.

5 / 5

Workflow Clarity

The flow is well sequenced: CLI setup steps 1-4, preference resolution with an explicit priority table and a BLOCKING first-time setup gate, then fetch, then "Inspect the saved markdown after every headless run" with recovery steps and capture modes deferred to quality-gate.md — an explicit validation checkpoint with a feedback loop. Anchor 5 fits; anchor 4's 'minor validation gaps' understates the presence of an explicit gate plus recovery reference, and the operation is non-destructive so no cap applies.

5 / 5

Progressive Disclosure

The ~105-line body is an overview, with details correctly split into real, substantive, one-level-deep references: adapters.md (adapter catalog, media flow, JSON schema), quality-gate.md (checklist and recovery), and config/first-time-setup.md (blocking setup questions), each clearly signaled with a link and purpose statement ("Read it for adapter-specific questions or media prompts"). Vendored CLI code lives in scripts/lib outside the instruction path. Anchor 5 fits; anchor 4's 'minor organization gaps' has no support here.

5 / 5

Total

19

/

20

Passed

Description

83%Weight 40%Scale 1-5

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

A strong description with concrete, specific capabilities and a named tool, plus an explicit 'Use when' trigger. Its two weaker points are the narrow trigger framing ('save a webpage as markdown' covers only one of several natural intents) and modest synonym coverage for natural user phrasing.

Suggestions

Broaden the when-clause to cover related natural intents, e.g. "Use when the user wants to save, read, or convert a webpage/URL to markdown".

Add common user phrasings as trigger synonyms, such as "web page", "article", or "convert this page/link to markdown".

DimensionReasoningScore

Specificity

Quotes: "Fetch any URL and convert to markdown", "Built-in adapters for X/Twitter, YouTube transcripts, Hacker News threads, and generic pages via Defuddle", "Handles login/CAPTCHA via interaction wait modes" — multiple concrete actions covering fetch, conversion, adapter-specific extraction, and auth handling with no real coverage gaps, matching the 'comprehensive coverage' anchor rather than the 4 anchor's 'minor gaps'.

5 / 5

Completeness

Quotes: "Fetch any URL and convert to markdown using baoyu-fetch CLI" (clear what) and "Use when user wants to save a webpage as markdown" (explicit when). Both are present, but the when-clause is narrow — users wanting to read or convert a page without saving it wouldn't obviously match — so it fits anchor 4 ('when could be more explicit or specific') rather than anchor 5's comprehensive concrete triggers, and clearly exceeds anchor 3 where when is missing or only implied.

4 / 5

Trigger Term Quality

Quotes: "URL", "markdown", "webpage", "save a webpage as markdown", "X/Twitter", "Hacker News" — good natural keyword coverage, but misses common synonyms like "web page", "article", or "convert this page to markdown". It exceeds anchor 3 ('some relevant keywords') but falls short of anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

Quotes: "convert to markdown using baoyu-fetch CLI", "site-specific adapters", "X/Twitter, YouTube transcripts, Hacker News threads" — a clear niche with named tooling and site-specific triggers, minimal conflict risk with generic file or document skills. Anchor 5 fits; anchor 4's 'minor overlap risk with closely related skills' is not warranted since the niche and triggers are distinct.

5 / 5

Total

18

/

20

Passed

Validation

68%

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

Validation — 11 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

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

relative_links

Relative link issues: 1 deeper-than-1-level

Warning

referenced_paths_exist

Referenced path issues: 2 deeper-than-1-level

Warning

Total

11

/

16

Passed

Repository

JimLiu/baoyu-skills

Path

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

Reviewed

Table of Contents

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.