web-to-markdown · softaworks — скилл для Claude Code: что делает и как установить
Скилл web-to-markdown для Claude Code преобразует веб-страницы с JavaScript в чистый Markdown через локальный браузер. Сохраняет статьи и документацию без лишней разметки.
MIT 796 установок ★ 2 707 обновлён 2026-03-05
npx skills add softaworks/agent-toolkit --skill web-to-markdown -a claude-codeЧто делает web-to-markdown
Скилл парсит веб-страницы через локальную утилиту web2md. Внутри связка Puppeteer и puppeteer-core запускает установленный браузер семейства Chromium (Chrome, Chromium, Brave или Edge), библиотека Readability вычищает разметку и выделяет основной текст, а Turndown собирает итоговый Markdown с очищенными ссылками.
Главное ограничение — строгий триггер запуска. Агент проигнорирует задачу, если в запросе нет фразы use the skill web-to-markdown или use a skill web-to-markdown.
Для работы в системе должна стоять утилита web2md, иначе конвертация завершится ошибкой проверки command -v web2md. Есть интерактивный режим --interactive с профилем --user-data-dir, чтобы пройти авторизацию или проверку вручную перед чтением разметки.
Какие задачи решает
- сохранить статью с динамическим рендерингом в чистый Markdown
- обойти экран входа или капчу в интерактивном окне браузера
- вычистить навигацию и баннеры со страницы с помощью Readability
- собрать несколько страниц в файлы с автоматическими именами
Примеры запросов агенту
- use the skill web-to-markdown: сохрани страницу в файл ./page.md
- use the skill web-to-markdown: выведи содержимое страницы в stdout
- use the skill web-to-markdown: открой интерактивный режим с сессией в ./tmp/web2md-profile и сохрани страницу в ./out/
Как установить web-to-markdown
1Через Skills CLI (Vercel)
npx skills add softaworks/agent-toolkit --skill web-to-markdown -a claude-code2Вручную: положить файлы
~/.claude/skills/web-to-markdown/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/web-to-markdown/
1Через Skills CLI (Vercel)
npx skills add softaworks/agent-toolkit --skill web-to-markdown -a codex2Вручную: положить файлы
.agents/skills/web-to-markdown/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add softaworks/agent-toolkit --skill web-to-markdown -a cursor2Вручную: положить файлы
.cursor/skills/web-to-markdown/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install softaworks/agent-toolkit skills/web-to-markdown2Вручную: положить файлы
.github/skills/web-to-markdown/SKILL.md1Через Skills CLI (Vercel)
npx skills add softaworks/agent-toolkit --skill web-to-markdown -a gemini-cli2Командой платформы
gemini skills install https://github.com/softaworks/agent-toolkit --path skills/web-to-markdownВручную: положить файлы
.devin/skills/web-to-markdown/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add softaworks/agent-toolkit --skill web-to-markdown -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о web-to-markdown
Как установить web-to-markdown в Claude Code?
Выполните команду npx skills add softaworks/agent-toolkit --skill web-to-markdown -a claude-code в терминале.
Что делает скилл web-to-markdown?
Он вызывает консольную утилиту web2md, открывает страницу в Chromium через Puppeteer, извлекает полезный контент через Readability и формирует Markdown.
Почему скилл не запускается обычной просьбой?
В инструкциях заложен жёсткий фильтр активации. Чтобы агент выполнил действие, сообщение обязано содержать точную фразу use the skill web-to-markdown.
Исходный текст
SKILL.md · MIT
---
name: web-to-markdown
description: "Use ONLY when the user explicitly says: 'use the skill web-to-markdown ...' (or 'use a skill web-to-markdown ...'). Converts webpage URLs to clean Markdown by calling the local web2md CLI (Puppeteer + Readability), suitable for JS-rendered pages."
metadata:
version: 0.1.0
---
# web-to-markdown
Convert web pages to clean Markdown by driving a locally installed browser (via `web2md`).
## Hard trigger gate (must enforce)
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`.
## What this skill does
- Handles JS-rendered pages (Puppeteer → user Chrome).
- Works best with Chromium-family browsers (Chrome/Chromium/Brave/Edge) via `puppeteer-core`.
- Extracts main content (Readability).
- Converts to Markdown (Turndown) with cleaned links and optional YAML frontmatter.
## Non-goals
- Do not use Playwright or other browser automation stacks; the mechanism is `web2md`.
## Inputs you should collect (ask only if missing)
- `url` (or a list of URLs)
- Output preference:
- Print to stdout (`--print`), OR
- Save to a file (`--out ./file.md`), OR
- Save to a directory (`--out ./some-dir/` to auto-name by page title)
- Optional rendering controls for tricky pages:
- `--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)
## Workflow
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).
## Defaults (recommended)
- For most pages: `--wait-until networkidle2`
- For heavy apps: start with `--wait-until domcontentloaded --wait-ms 2000`, then add `--wait-for 'main'` (or another stable selector) if needed.
© softaworks · MIT · softaworks/agent-toolkit
Похожие скиллы
Все скиллы по теме «Браузер и парсинг» →Сначала — web-to-markdown от других авторов.