screenshot

Capture full-screen, region, or window screenshots across macOS, Linux, and Windows.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Kevin-Mok/ai-cli-dotfiles --skill screenshot-kevin-mok
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: screenshot
Source: https://github.com/Kevin-Mok/ai-cli-dotfiles/tree/main/dot_agents/skills/screenshot
Command: npx skills add https://github.com/Kevin-Mok/ai-cli-dotfiles --skill screenshot-kevin-mok

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Capture desktop and window screenshots across macOS, Linux, and Windows when tool-specific capture is unavailable or when a full desktop image is needed for UI verification, documentation, or testing.

Core Features & Use Cases

  • Cross-platform screenshot capture supporting full screen, region, active window, and window-id based captures.
  • Multi-display aware output handling with default and temporary save locations.
  • macOS permissions preflight and a set of bundled scripts to streamline captures and integration with automation.

Quick Start

Run the script to capture a screenshot, optionally specifying a path, region, or app/window filters, and use the produced path to view the result.

Frequently Asked Questions about screenshot

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate cross-platform screenshot capture on macOS, Linux, and Windows?

Automate cross-platform screenshot capture by running bundled scripts that utilize OS-level tools like screencapture on macOS, scrot or gnome-screenshot on Linux, and PowerShell on Windows. The scripts manage permissions and produce output file paths for immediate use in automation workflows.

Can I capture a specific window or screen region instead of the full desktop?

Yes, you can capture a specific window or screen region. The scripts support flexible capture modes including whole-screen, custom region, active window, and specific window-id based captures, allowing precise targeting of individual application windows or desktop areas.

Does screenshot automation work with multi-display setups?

Yes, screenshot automation works with multi-display setups. The scripts are multi-display aware and provide output handling that accommodates default and temporary save locations, ensuring correct capture and file path generation across multiple connected monitors.

What do I need to capture desktop screenshots on macOS without permission errors?

To capture desktop screenshots on macOS without permission errors, the scripts include a macOS permissions preflight check. This verifies that the necessary screen recording permissions are granted to the terminal or automation tool before attempting to execute the screencapture command.

What's the best way to capture desktop screenshots for UI verification and testing?

The best way to capture desktop screenshots for UI verification is to use automated scripts that support region and window-specific captures. This approach generates reliable file paths to the saved images, integrating seamlessly into testing pipelines and documentation workflows.