screenshot

Capture desktop, window, and region screenshots on macOS, Linux, and Windows.

1|Updated May 8, 2026
One-click install
npx skills add https://github.com/dicarsmtz/product-engineering-kit --skill screenshot-dicarsmtz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: screenshot
Source: https://github.com/dicarsmtz/product-engineering-kit/tree/main/plugins/product-engineering/skills/screenshot
Command: npx skills add https://github.com/dicarsmtz/product-engineering-kit --skill screenshot-dicarsmtz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Taking screenshots from an AI agent or terminal requires different OS-specific commands, permission handling, and output conventions. This Skill provides unified helper scripts that capture full screens, specific app windows, or pixel regions and save them to the right location without manual command lookup. ## Core Features & Use Cases - Cross-platform capture: Python helper for macOS and Linux, PowerShell helper for Windows, with direct OS command fallbacks. - Flexible targeting: Capture full screens (including multi-display setups), specific apps or window titles on macOS, active windows, window IDs, or pixel regions. - macOS permission preflight: A helper script checks and requests Screen Recording permission once, reducing repeated system prompts. - Use Case: When a Figma design does not match the implemented app, capture the running app's windows to a temp directory and compare the screenshots against the design export. ## Quick Start Ask the agent to take a screenshot of a specific app or your full screen and tell it where to save the file.

Frequently Asked Questions about screenshot

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

FAQPage Schema
How do I take a screenshot of a specific app window on macOS from the terminal?

Run the take_screenshot.py helper with the --app flag, for example: python3 take_screenshot.py --app "Codex". It captures all matching on-screen windows and prints one output path per window. Use --window-name to narrow to a specific window title.

How do I capture only a region of the screen?

Pass a pixel region as x,y,w,h, for example: python3 take_screenshot.py --region 100,200,800,600. On Linux, region capture requires scrot or ImageMagick import; on Windows use the -Region parameter of the PowerShell helper.

Why does macOS screenshot capture fail with permission errors?

macOS requires Screen Recording permission for the terminal or host app. Run scripts/ensure_macos_permissions.sh first to check and request permission in one place, then enable it under System Settings > Privacy & Security > Screen Recording if still blocked.

Does this screenshot tool work on Linux?

Yes, the Python helper supports Linux by automatically selecting scrot, gnome-screenshot, or ImageMagick import, whichever is installed. App and window-name capture are macOS-only; on Linux use --active-window or --window-id instead.

How are screenshots handled with multiple monitors?

On macOS, full-screen captures save one file per display with -d<display> suffixes. On Linux and Windows, full-screen captures produce a single virtual-desktop image, so use --region to isolate one display.

Where are screenshots saved by default?

With no path specified, files save to the OS default screenshot location, such as the macOS Desktop or the Pictures/Screenshots folder on Windows and Linux. Use --mode temp to save to the temp directory for agent inspection.