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.