screenshot

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

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/BoraPerusic/agents --skill screenshot-boraperusic
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: screenshot
Source: https://github.com/BoraPerusic/agents/tree/main/skills/to%20try/screenshot
Command: npx skills add https://github.com/BoraPerusic/agents --skill screenshot-boraperusic

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This tool enables reliable desktop screenshot capture across macOS, Linux, and Windows for full-screen, region, and window-specific captures, with consistent output handling and permission considerations.

Core Features & Use Cases

  • Cross-platform screenshot support with macOS-specific window/region options
  • Region, active window, or specific window capture with robust output path resolution
  • macOS preflight permission helper and multi-display support for multiple outputs
  • Fallback OS commands and scripts (Python, PowerShell, Bash) to cover automation in diverse environments
  • Test mode and deterministic behavior for development and CI workflows

Quick Start

Take a full-screen screenshot of the active desktop and save it to the default OS screenshots location.

Frequently Asked Questions about screenshot

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

FAQPage Schema
How do I automate desktop screenshot capture across macOS, Linux, and Windows?

Automate desktop screenshot capture across macOS, Linux, and Windows using a Python-based cross-platform core with shell and PowerShell helpers. It handles full-screen, region, and window-specific captures with sensible defaults and robust output path resolution for diverse environments.

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

Yes, you can capture a specific window or screen region instead of the full desktop. The tool supports region-based captures, active window targeting, and app/window targeting on macOS, along with a list-windows option to retrieve window IDs for precise automation.

Does macOS screenshot automation require special permission preflight checks?

macOS screenshot automation requires special permission preflight checks to ensure screen recording access. The tool includes a macOS preflight permission helper to verify necessary system permissions before attempting to capture desktop screenshots, preventing silent failures.

What is the best way to test screenshot automation in CI workflows without saving files?

The best way to test screenshot automation in CI workflows without saving files is using the built-in test mode. It provides deterministic behavior for safe development and testing, ensuring your capture scripts run reliably without modifying the file system.

How do I handle multiple display outputs when taking desktop screenshots?

Handle multiple display outputs when taking desktop screenshots using the tool's multi-display support. It robustly resolves output paths and manages multiple outputs across different displays, ensuring captures from various screens are saved correctly.

Are there fallback commands for desktop screenshot capture if the primary script fails?

Yes, there are fallback OS commands for desktop screenshot capture if the primary script fails. The tool includes scripts in Python, PowerShell, and Bash to provide cross-platform fallbacks and ensure reliable automation in diverse environments.