screenshot

Capture desktop screenshots across macOS, Linux, and Windows platforms.

Updated Feb 5, 2026
One-click install
npx skills add https://github.com/syl2042/codex_skills --skill screenshot-syl2042
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: screenshot
Source: https://github.com/syl2042/codex_skills/tree/main/screenshot
Command: npx skills add https://github.com/syl2042/codex_skills --skill screenshot-syl2042

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Capture desktop screenshots across platforms to aid debugging, QA, and visual documentation when OS-level tools are needed or tool-specific capture is unavailable.

Core Features & Use Cases

  • Cross-platform screenshot support (macOS, Linux, Windows) with modular capture options.
  • Region-based captures, active-window captures, and specific window captures by id or name.
  • Automatic path handling with default destinations or explicit paths for easy integration into workflows.

Quick Start

Capture a screenshot of the active window and save it to the default desktop directory.

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 from the command line on macOS, Linux, and Windows?

This screenshot utility captures desktop regions and active windows across macOS, Linux, and Windows. It routes requests to native system tools like screencapture, scrot, and gnome-screenshot, saving the output to a user-specified path or the temp directory.

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

Yes, you can capture specific windows or screen regions by specifying a window ID or application name. This allows targeted region-based captures and active-window captures instead of full desktop screenshots.

Do I need to install extra dependencies to capture screenshots on macOS?

No extra dependencies are required. The Skill relies on built-in system capture tools like macOS screencapture, Linux scrot, and gnome-screenshot, including helper scripts to manage macOS permissions and cross-platform path resolution.

How do I specify the output path when taking a screenshot?

You can specify an explicit output path for your screenshot, or let the tool default to the temp directory. Automatic path handling ensures easy integration into automated workflows and visual inspection pipelines.

Why are my macOS screenshots failing during automated capture?

macOS screenshots often fail during automated capture due to missing screen recording permissions. The Skill includes helper scripts specifically designed to manage macOS permissions and ensure the screencapture tool functions correctly in automated workflows.