Readable mdn

Skill yamadashy/agent-readable/skills/readable-mdn

Agent Skills for reading hard-to-access content

Install

npx -y skills add yamadashy/agent-readable --skill readable-mdn

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Fetches MDN Web Docs as raw Markdown by mapping the developer.mozilla.org URL to its source file in mdn/content (en-US) or mdn/translated-content (other locales) on GitHub and curl-ing the raw blob. Cleaner and more compact than rendering the SPA page; falls back to WebFetch on the original URL when the path mapping 404s. Use when the URL is on developer.mozilla.org.

SKILL.md

2.2 KB, as published. Nobody here has run it

MDN Web Docs Reader

MDN content lives on GitHub as Markdown. Fetching the raw Markdown is more compact than rendering the SPA page.

English (en-US): https://github.com/mdn/content
Other locales (ja, fr, zh-CN, ...): https://github.com/mdn/translated-content

Steps

1. Map the URL to a content path

From https://developer.mozilla.org/{locale}/docs/{path}:

# en-US
https://raw.githubusercontent.com/mdn/content/main/files/en-us/{path-lowercased}/index.md

# Other locales
https://raw.githubusercontent.com/mdn/translated-content/main/files/{locale-lowercased}/{path-lowercased}/index.md

Examples:

MDN URL	Source path
`developer.mozilla.org/en-US/docs/Web/API/Fetch_API/Using_Fetch`	`mdn/content` → `files/en-us/web/api/fetch_api/using_fetch/index.md`
`developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/Array`	`mdn/translated-content` → `files/ja/web/javascript/reference/global_objects/array/index.md`

If the original MDN URL redirects (visible by following with curl -IL), resolve it before mapping.

2. Fetch the Markdown

# en-US
curl -s -o /tmp/mdn.md \
  "https://raw.githubusercontent.com/mdn/content/main/files/en-us/{path}/index.md"

# Translated
curl -s -o /tmp/mdn.md \
  "https://raw.githubusercontent.com/mdn/translated-content/main/files/{locale}/{path}/index.md"

3. Read the file

Read /tmp/mdn.md

If the path is wrong (404), fall back to WebFetch on the original developer.mozilla.org URL.

License / attribution

MDN content is dual-licensed (CC BY-SA 2.5 for prose, CC0 for code samples). When quoting, link back to the MDN page.

Reference

MDN content repo (en-US): https://github.com/mdn/content
Translated content: https://github.com/mdn/translated-content
License: https://github.com/mdn/content/blob/main/LICENSE.md