screenshot

Capture desktop screenshots across macOS, Linux, and Windows for UI verification.

1|Updated Dec 21, 2025
One-click install
npx skills add https://github.com/cdrguru/portable-agent-kit --skill screenshot-cdrguru
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: screenshot
Source: https://github.com/cdrguru/portable-agent-kit/tree/main/.codex/skills/screenshot
Command: npx skills add https://github.com/cdrguru/portable-agent-kit --skill screenshot-cdrguru

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Capture desktop screenshots across platforms to enable UI verification, automated testing, and debugging when tool-specific capture capabilities are unavailable or insufficient.

Core Features & Use Cases

  • Cross-platform screenshot support for macOS, Linux, and Windows.
  • Flexible capture modes including full screen, region (x,y,w,h), active window, specific window, and application-scoped captures.
  • Output control via default OS directories, temporary locations, or user-specified paths suitable for automation and CI workflows.
  • Scripted automation through a Python helper (take_screenshot.py) plus shell/PowerShell fallbacks for diverse environments.

Quick Start

Run the take_screenshot.py script with your preferred options to capture a screenshot on your system.

Frequently Asked Questions about screenshot

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

FAQPage Schema
How do I capture a desktop screenshot across macOS, Linux, and Windows for automated testing?▼

To capture a desktop screenshot across platforms, use a Python helper script with shell or PowerShell fallbacks to support UI verification and automated testing workflows. It handles full-screen, region, active-window, and specific-window captures across macOS, Linux, and Windows.

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

Yes, you can capture a specific screen region or active window instead of the full desktop. The tool supports flexible capture modes including region coordinates, active window, specific window, and application-scoped captures with input validation.

Does desktop screenshot capture work in CI workflows and automated environments?▼

Desktop screenshot capture works in CI workflows and automated environments by offering output control via default OS directories, temporary locations, or user-specified paths. This ensures safe default output handling suitable for scripted automation.

What is the best way to automate UI verification screenshots without built-in capture capabilities?▼

The best way to automate UI verification screenshots when built-in capabilities are unavailable is running a cross-platform Python script. It provides validation for capture modes and implements safe default output handling for debugging.

Are there limitations when taking screenshots on macOS regarding system permissions?▼

When taking screenshots on macOS, system permissions can limit capture functionality. The tool addresses this limitation by implementing a dedicated macOS permission script alongside its standard Python helper and shell fallbacks.

Do I need to install external dependencies to capture desktop screenshots across different operating systems?▼

You do not need to install external dependencies to capture desktop screenshots across different operating systems. The tool operates independently using a built-in Python script with shell and PowerShell fallbacks for diverse environments.