Readable mdn
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.From its SKILL.md
npx -y skills add yamadashy/agent-readable --skill readable-mdnAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
3 things 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.
- runs commandsInstructs the agent to run 3 commands, including `curl -s -o /tmp/mdn.md "https://raw.githubusercontent.com/mdn/content/main/files/en-us/{path}/index.md"` and 2 more.
- fetches URLsInstructs the agent to fetch 2 URLs, including https://raw.githubusercontent.com/mdn/content/main/files/en-us/{path}/index.md and 1 more.
SKILL.md
2.2 KB, 499 tokens by cl100k_base, 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
What ships with it
Read from the repository
Just SKILL.md. No reference files, no scripts.