screenshot-web

screenshot-web

Take screenshots of web pages using shot-scraper.

Plugin root: this SKILL.md is at skills/screenshot-web/SKILL.md inside the plugin. All paths below (setup.sh, .venv/) are relative to the plugin root (two directories up from this file). Resolve them from this file's location before running.

Setup

Run once before first use:

bash <plugin-root>/setup.sh

Usage

<plugin-root>/.venv/bin/shot-scraper <url> [options]

Key options

Option	Description
<url>	URL to screenshot (required)
-o FILE	Output file path (default: auto-named from URL)
-w WIDTH	Viewport width in pixels (default: 1280)
-h HEIGHT	Viewport height — omit for full-page capture
-s SELECTOR	CSS selector — capture only that element
--selector-all SEL	Capture all matching elements as separate files
-j JS	JavaScript to execute before screenshot
--wait MS	Milliseconds to wait after page load
--retina	2x pixel density (HiDPI)
--quality N	JPEG quality 0-100 (use with -o file.jpg)

Examples

<plugin-root>/.venv/bin/shot-scraper https://example.com -o example.png
<plugin-root>/.venv/bin/shot-scraper https://example.com -o mobile.png -w 390 -h 844
<plugin-root>/.venv/bin/shot-scraper https://example.com -o hero.png -s "#hero"
<plugin-root>/.venv/bin/shot-scraper https://example.com -o retina.png --retina
<plugin-root>/.venv/bin/shot-scraper https://example.com -o clean.png -j "document.querySelector('.cookie-banner')?.remove()"

Docker alternative

No Python/venv needed — just Docker:

bash <plugin-root>/run.sh https://example.com -o example.png

The run.sh wrapper auto-detects: uses Docker if available (builds image on first run), falls back to venv. You can also run Docker directly:

docker run --rm -v "$(pwd):/work" cliskills/screenshot-web https://example.com -o example.png

Build the image once with: docker build -t cliskills/screenshot-web <plugin-root>/

How Claude Code should use this skill

When the user asks to take a screenshot of a URL:

1. Determine PLUGIN_ROOT by resolving ../.. from this SKILL.md file's path
2. Preferred: use bash $PLUGIN_ROOT/run.sh <url> [options] — auto-detects Docker or venv
3. Fallback: ensure setup has been run (bash $PLUGIN_ROOT/setup.sh) and use $PLUGIN_ROOT/.venv/bin/shot-scraper directly
4. Determine output path (default to screenshot.png in cwd if not specified)
5. Run via Bash and report the saved file path

Device viewport mappings:

• mobile: -w 390 -h 844
• tablet: -w 768 -h 1024
• desktop: -w 1280 (omit -h for full page)

For retina/print quality, add --retina.