| name | description |
|---|---|
browser-screenshot |
This skill should be used when users need to capture screenshots of web pages. It supports full-page screenshots, viewport-specific captures, responsive screenshots across multiple device sizes, and element-specific screenshots. Use this skill for visual testing, documentation, design reviews, or any task requiring automated browser screenshots. |
Capture screenshots of web pages using Playwright with support for full-page capture, custom viewport sizes, responsive testing across multiple devices, and element-specific screenshots.
Use this skill when users request:
- Screenshots of web pages or URLs
- Visual testing across different screen sizes (mobile, tablet, desktop)
- Full-page captures including content below the fold
- Screenshots of specific page elements
- Documentation requiring webpage visuals
- Automated screenshot generation for reporting or testing
Before using this skill, ensure Playwright is installed:
pip install playwright
playwright install chromiumFor other browsers (optional):
playwright install firefox
playwright install webkitTo capture a standard screenshot of a webpage:
python scripts/screenshot.py <URL> <output-path>Example:
python scripts/screenshot.py https://example.com screenshot.pngThis captures a viewport screenshot at the default size (1920x1080) with network idle waiting enabled.
To capture the entire scrollable page content:
python scripts/screenshot.py <URL> <output-path> --full-pageExample:
python scripts/screenshot.py https://example.com/blog/post full-page.png --full-pageThis is particularly useful for:
- Long articles or blog posts
- Landing pages with multiple sections
- Documentation pages
- Any page where content extends beyond the initial viewport
To capture screenshots at specific dimensions:
python scripts/screenshot.py <URL> <output-path> --width <WIDTH> --height <HEIGHT>Example:
python scripts/screenshot.py https://example.com mobile-view.png --width 375 --height 667Use custom viewports for:
- Testing specific device dimensions
- Matching design mockup sizes
- Custom resolution requirements
To capture the same page across multiple viewport sizes in a single command:
python scripts/screenshot.py <URL> <output-directory> --responsive <viewport1> <viewport2> ...Available viewport presets:
mobile- 375x667 (iPhone SE)mobile-large- 414x896 (iPhone 11)tablet- 768x1024 (iPad)desktop-small- 1366x768 (720p)desktop- 1920x1080 (1080p)
Example:
python scripts/screenshot.py https://example.com screenshots/ --responsive mobile tablet desktopThis creates three files in the screenshots/ directory:
mobile.pngtablet.pngdesktop.png
Custom viewports can also be used with the WIDTHxHEIGHT format:
python scripts/screenshot.py https://example.com screenshots/ --responsive 1024x768 1440x900 mobileTo capture only a specific element on the page:
python scripts/screenshot.py <URL> <output-path> --element "<CSS-selector>"Example:
python scripts/screenshot.py https://example.com header.png --element "header.main-header"
python scripts/screenshot.py https://example.com chart.png --element "#sales-chart"Use element screenshots for:
- Isolating specific UI components
- Capturing charts or graphs
- Documenting individual page sections
Control when the screenshot is captured using various wait conditions:
Wait for Network Idle (default):
python scripts/screenshot.py https://example.com output.pngDisable network idle waiting (faster, but may miss dynamic content):
python scripts/screenshot.py https://example.com output.png --no-wait-network-idleWait for a specific element to appear:
python scripts/screenshot.py https://example.com output.png --wait-for-selector ".content-loaded"Add a custom delay:
python scripts/screenshot.py https://example.com output.png --delay 2000These options can be combined:
python scripts/screenshot.py https://example.com output.png --wait-for-selector ".main-content" --delay 1000By default, Chromium is used. To use a different browser:
python scripts/screenshot.py <URL> <output-path> --browser firefox
python scripts/screenshot.py <URL> <output-path> --browser webkitCapture screenshots across multiple viewports for comparison:
python scripts/screenshot.py https://staging.example.com screenshots/staging/ --responsive mobile tablet desktop --full-page
python scripts/screenshot.py https://prod.example.com screenshots/prod/ --responsive mobile tablet desktop --full-pageCapture specific UI components for documentation:
python scripts/screenshot.py https://app.example.com login-form.png --element "form.login"
python scripts/screenshot.py https://app.example.com dashboard.png --element "#dashboard-container"Capture full pages with wait conditions for dynamic content:
python scripts/screenshot.py https://example.com design-review.png --full-page --wait-for-selector ".hero-animation-complete" --delay 500Test a new landing page across all common devices:
python scripts/screenshot.py https://example.com/new-landing responsive-test/ --responsive mobile mobile-large tablet desktop-small desktop --full-pageCommand structure:
python scripts/screenshot.py <URL> <output> [options]Common options:
-f, --full-page- Capture entire scrollable page-w, --width- Viewport width in pixels-h, --height- Viewport height in pixels-r, --responsive- Multiple viewport captures-e, --element- Screenshot specific element--wait-for-selector- Wait for CSS selector-d, --delay- Delay in milliseconds-b, --browser- Browser choice (chromium/firefox/webkit)--no-wait-network-idle- Skip network idle wait
Get full help:
python scripts/screenshot.py --helpWhen users request screenshots:
- Determine the screenshot type needed (viewport, full-page, responsive, or element-specific)
- Identify any wait conditions required (network idle, specific selectors, delays)
- Select appropriate viewport size(s) or use responsive mode for multiple sizes
- Construct the command with appropriate options
- Execute the script using the Bash tool
- Verify the output file(s) were created successfully
- Inform the user of the screenshot location(s)
For complex scenarios involving multiple pages or repeated screenshots, consider creating a wrapper script that calls screenshot.py multiple times with different parameters.
Common issues:
- "Playwright not found": Run
pip install playwright && playwright install chromium - Element not found: Verify the CSS selector is correct; use
--wait-for-selectorif the element loads dynamically - Blank screenshots: Increase
--delayor ensure--wait-for-network-idle(default) is enabled - Timeout errors: The page may be taking too long to load; try
--no-wait-network-idleor increase timeout in the script if needed - Browser not found: Run
playwright install <browser-name>for the desired browser
The main screenshot tool that handles all screenshot operations using Playwright. The script can be executed directly without loading into context, though reading it may be helpful for understanding capabilities or making environment-specific adjustments.