Converts specified webpage URLs into clean Markdown files by utilizing the local web2md CLI, which leverages Puppeteer and Readability to handle JavaScript-rendered content.
Say it in your own words; the assistant finds this recipe by itself. Examples:
Use this skill only when the user explicitly includes the phrase 'use the skill web-to-markdown' or 'use a skill web-to-markdown' in their request. It is designed for converting specific web pages, particularly those requiring JavaScript rendering, into structured Markdown format.
Convert web pages to clean Markdown by driving a locally installed browser (via web2md).
This skill MUST NOT be used unless the user explicitly wrote exactly a phrase like:
- use the skill web-to-markdown ...
- use a skill web-to-markdown ...
If the user did not explicitly request this skill by name, stop and ask them to re-issue the request including: use the skill web-to-markdown.
puppeteer-core.web2md.url (or a list of URLs)--print), OR--out ./file.md), OR--out ./some-dir/ to auto-name by page title)--chrome-path <path> (if Chrome auto-detection fails)--interactive (show Chrome and pause so the user can complete human checks/login, then press Enter)--wait-until load|domcontentloaded|networkidle0|networkidle2--wait-for '<css selector>'--wait-ms <milliseconds>--headful (debug)--no-sandbox (sometimes required in containers/CI)--user-data-dir <dir> (login/session; use a dedicated profile directory)1) Confirm the user explicitly invoked the skill (use the skill web-to-markdown).
2) Validate URL(s) start with http:// or https://.
3) Ensure web2md is installed:
- Run: command -v web2md
- If missing, instruct the user to install it (assume the project exists at ~/workspace/softaworks/projects/web2md):
- cd ~/workspace/softaworks/projects/web2md && npm install && npm run build && npm link
- Or: cd ~/workspace/softaworks/projects/web2md && npm install && npm run build && npm install -g .
4) Convert:
- Single URL → file:
- web2md '<url>' --out ./page.md
- Single URL → auto-named file in directory:
- mkdir -p ./out && web2md '<url>' --out ./out/
- Human verification / login walls (interactive):
- mkdir -p ./out && web2md '<url>' --interactive --user-data-dir ./tmp/web2md-profile --out ./out/
- Then: complete the check in the browser window and press Enter in the terminal to continue.
- Print to stdout:
- web2md '<url>' --print
- Multiple URLs (batch):
- Create output dir (e.g. ./out/) then run one web2md command per URL using --out ./out/
5) Validate output:
- If writing files, verify they exist and are non-empty (e.g. ls -la <path> and wc -c <path>).
6) Return:
- The saved file path(s), or the Markdown (stdout mode).
--wait-until networkidle2--wait-until domcontentloaded --wait-ms 2000, then add --wait-for 'main' (or another stable selector) if needed.LICENSEREADME.mdSKILL.mdVendored from softaworks/agent-toolkit, commit 3027f20f3181, path skills/web-to-markdown, licence MIT. The upstream licence file ships inside the skill.