skills.rest
guneysol
guneysolCOMMUNITY
Explore all skills by this author →
𝕏@guneysolGitHub

screenshot

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

Updated Jul 17, 2026
Search Tags:#macos#linux#screenshot#windows#screen capture#visual inspection#screencapture
One-click install
npx skills add https://github.com/guneysol/agent-configs --skill screenshot-guneysol
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: screenshot
Source: https://github.com/guneysol/agent-configs/tree/main/agents/skills/screenshot
Command: npx skills add https://github.com/guneysol/agent-configs --skill screenshot-guneysol

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 on every platform, which leads to repeated trial and error. ## Core Features & Use Cases - Cross-platform capture: One Python helper covers macOS and Linux, with a PowerShell helper for Windows, supporting full screen, pixel regions, active windows, and specific window IDs. - macOS app and window targeting: Capture all windows of a named app, filter by window title, list window IDs, and handle multi-display output with per-display files. - Permission preflight: A bundled script checks and requests macOS Screen Recording permission once, reducing repeated system prompts in sandboxed runs. - Use Case: Ask the agent to look at a running desktop app and compare it against a Figma design; it captures the app windows to the temp directory and inspects each image. ## Quick Start Take a screenshot of the currently active window and save it to the temp folder so you can look at it.

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 --app followed by the app name to capture all matching on-screen windows. Use --window-name to narrow to a specific title, or --list-windows to discover window IDs first.

How do I capture a specific screen region with x,y,w,h coordinates?▼

Pass --region 100,200,800,600 to the Python helper on macOS or Linux, or -Region on the Windows PowerShell script. On Linux, region capture requires scrot or ImageMagick import to be installed.

Why does macOS screenshot capture fail with permission or sandbox errors?▼

macOS requires Screen Recording permission for the terminal or host app. Run the bundled ensure_macos_permissions.sh preflight script once, and if the sandbox blocks checks, rerun the command with escalated permissions.

Which Linux screenshot tools does the helper support?▼

The helper automatically selects the first available tool in this order: scrot, gnome-screenshot, then ImageMagick import. If none are installed, you must install one before capturing.

Can I capture screenshots on Windows with this skill?▼

Yes, Windows is supported through the take_screenshot.ps1 PowerShell script, which handles full screen, regions, active windows, and window handles. The Python helper itself only runs on macOS and Linux.

Where are screenshots saved when no output path is given?▼

Without a path, files save to the OS default screenshot location, such as the macOS Desktop or the Pictures/Screenshots folder. Using --mode temp saves to the system temp directory for agent inspection runs.

Related Skills

Explore More Software Engineering Skills→
andregusman-raizandregusman-raiz
19

ag-capturar-tela

Captures screen regions across macOS, Windows, and Linux for multimodal AI analysis and OCR extraction.

Community
Intermediate
matlabmatlab
883

matlab-display-image

Display image data with interactive viewers, annotations, and overlay rendering in MATLAB.

Official
Intermediate
ImL1sImL1s
6

verify-ui-auto

Compare Flutter screenshots against Figma references using pixel-diff and auto-fix iterations.

Community
Advanced
ElbertePlinioElbertePlinio

agent-browser

Automate web and Electron app interactions with Playwright-based browser control.

Community
Advanced