Document browser runtime dependency for auto/browser modes

Author: firede

README.md

@@ -24,6 +24,14 @@ If you use tools like Codex or Claude Code, note that they may already include b
 - `raw`: send `Accept: text/markdown`, then print that single HTTP response body as-is (no fallback/conversion)
 - `--meta` (default `true`): control whether non-`raw` outputs include front matter (`title`/`description`). For `auto`/`static` direct markdown responses, it may do one extra HTML request to collect metadata.
 
+## Runtime dependency
+
+`browser` mode requires a Chrome/Chromium browser available on the host.
+
+`auto` mode may fall back to browser rendering, so it can also require Chrome/Chromium on some pages.
+
+Use `--mode static` or `--mode raw` to avoid browser dependency.
+
 ## Install (with Go)
 
 If Go is already installed locally:

README.zh.md

@@ -24,6 +24,14 @@
 - `raw`：带 `Accept: text/markdown` 发起一次 HTTP 请求，并将该响应体原样输出（不做回退/转换）
 - `--meta`（默认 `true`）：控制非 `raw` 输出是否附带 front matter（`title`/`description`）。对于 `auto`/`static` 的直返 markdown，可能会额外发起一次 HTML 请求用于补齐元信息。
 
+## 运行时依赖
+
+`browser` 模式要求宿主机可用 Chrome/Chromium 浏览器。
+
+`auto` 模式可能回退到浏览器渲染，因此在部分页面上也会依赖 Chrome/Chromium。
+
+如需避免浏览器依赖，请使用 `--mode static` 或 `--mode raw`。
+
 ## 安装（使用 Go）
 
 如果本地已经安装 Go，可直接执行：

skills/agent-fetch/SKILL.md

@@ -43,6 +43,12 @@ agent-fetch --help
 
 ## Fetch workflow
 
+Browser runtime requirement:
+
+- `--mode browser` requires Chrome/Chromium available on the host.
+- `--mode auto` may fall back to browser rendering on some pages.
+- Use `--mode static` or `--mode raw` when browser runtime is unavailable.
+
 1. Start with `auto` mode for general pages.
 2. Use `browser` mode for JavaScript-heavy pages.
 3. Add `--wait-selector` in `browser` mode when content appears late.