Screenshot

What This Skill Does

The Screenshot skill is a versatile, cross-platform utility designed to handle image capture across macOS, Linux, Windows, and web environments. It abstracts the complexity of OS-specific CLI tools—such as screencapture for macOS, scrot or grim for Linux, and nircmd for Windows—into a unified interface. Beyond simple capture, the skill facilitates programmatic workflows, allowing you to capture specific windows via PIDs, define exact pixel regions, and generate full-page renders of web content using headless browsers like Playwright. It is optimized for automation, supporting timestamped file naming, automated compression via pngquant or jpegoptim, and intelligent handling of dynamic web content with network-idle detection.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/ivangdavila/screenshot

Ensure that you have the necessary system dependencies installed for your OS, such as Playwright for web captures or the relevant screenshot tool (e.g., grim for Wayland) for your Linux distribution.

Use Cases

• Automated Regression Testing: Capture UI states across different resolutions to identify visual regressions.
• CI/CD Reporting: Generate snapshot artifacts from headless environments for post-build analysis.
• Content Scraping: Capture full-page screenshots of documentation or dynamic web dashboards that require JavaScript rendering.
• Batch Processing: Use automated naming conventions to log activity during long-running system scripts.
• Cross-Platform Development: Standardize screenshot workflows across developer machines regardless of the underlying OS.

Example Prompts

1. "Capture a full-page screenshot of https://openclaw.ai and save it as dashboard_capture.png after ensuring the network is idle."
2. "Take a screenshot of the active window on my macOS desktop and label it with the current timestamp."
3. "Grab a 500x500 pixel region starting from coordinate 100,100 on my main screen and compress it as a high-quality JPEG."

Tips & Limitations

• Web Content: Always use network idle settings (like --wait-for-timeout) when capturing web pages to avoid incomplete renderings.
• Linux Environments: Be aware that Wayland sessions often break legacy X11 tools; switch to grim and slurp for modern Wayland support.
• File Formats: Use PNG for text-heavy UI elements to maintain lossless quality, and use WebP or JPEG for photographs to significantly reduce file sizes.
• Resolution: Retina displays on macOS may default to 2x scale; specify exact pixel regions when precision is required to avoid scaling artifacts.