Cross-Platform Screenshot Capture
Capture desktop screenshots by app, window, region, or display and save them predictably.
The scripts save captures to a user-specified path, an OS default location, or a temporary directory, and the macOS preflight explains and requests Screen Recording permission. However, screenshots may contain sensitive screen data, while Linux and Windows lack equivalent confirmation, sensitive-data guidance, scope disclosure, and rollback or cleanup guidance. System commands are also invoked, so points are deducted.
The Python helper includes mutually exclusive argument checks, platform branches, tool detection, and reasonably diagnosable failure messages; its embedded test mode provides limited reproducibility. However, the supplied material does not include the referenced macOS Swift files or the Windows PowerShell helper, and there is no committed comprehensive test suite or CI evidence. The score therefore remains conservative under the static cap.
The skill clearly targets desktop screenshots and documents application/window, region, platform, and tool-priority behavior. Non-fit boundaries, trigger semantics, Chinese-language guidance, and environment prerequisites are incomplete. Its core function is local OS capture and does not depend on overseas online services, so no additional mainland-network deduction is applied.
The documentation is readable and layered, with command examples, platform limitations, multi-display behavior, and error handling. However, the individual skill license is unknown, and versioning, changelog, explicit maintenance ownership, and update path are absent. The README also states that the repository is deprecated, so points are deducted.
The objective is concrete and common modes cover default, temporary, explicit-path, window, and region captures. Yet the supplied evidence omits key referenced helper files, dependency availability is uncertain, and representative outputs were not statically verified. Direct usability is therefore only partially supported.
The source, argument validation, platform-selection logic, and test mode are auditable primary evidence. There are no independent execution records, complete test suite, CI workflow, or third-party corroboration, so the score remains limited.
- The supplied material omits macos_permissions.swift, macos_window_info.swift, macos_display_info.swift, and the referenced Windows PowerShell helper; confirm they exist after installation.
- Screenshots may expose credentials, personal information, or internal data; confirm the capture scope and output location before use and avoid untrusted destinations.
- The README says the repository is deprecated; confirm that this revision is still the intended maintained source.
What it does & when to use it
This skill handles explicit requests for desktop or system screenshots and provides an OS-level fallback when specialized capture tools are unavailable. It supports full-screen, active-window, application, window, pixel-region, and display-oriented capture workflows. Bundled helpers cover macOS, Linux, and Windows, with separate rules for user-specified paths, default screenshot locations, and temporary inspection files. It is a practical fit for repeatable desktop capture, subject to platform permissions and locally available screenshot utilities.
Saves captures to a user-provided path, the operating system's default screenshot location, or a temporary directory; captures macOS applications, windows, window IDs, active windows, regions, or displays; selects scrot, gnome-screenshot, or ImageMagick import on Linux and supports Linux region and active-window capture; runs a PowerShell helper on Windows for full-screen, region, active-window, or window-handle capture; reports the resulting file path.
- A user documenting the complete desktop or multi-display state can take a full-screen capture.
- A user inspecting a desktop application's interface can capture an application or window by name on macOS.
- A user who needs only part of an interface can capture a pixel-defined region.
- A user asking the agent to inspect the current interface can save a temporary screenshot for visual review.
- A user working with a browser or Electron app without integrated capture can use OS-level capture.
Pros & cons
- Covers macOS, Linux, and Windows.
- Supports full-screen, application, window, active-window, window-handle, and pixel-region capture.
- Defines predictable save-location behavior for user requests and agent inspection.
- Includes macOS permission preflight and Linux tool-selection logic.
- macOS application and window capture requires Screen Recording permission.
- Linux requires scrot, gnome-screenshot, or ImageMagick import.
- The supplied material includes no test suite, version requirements, or platform validation record.
- The specific license terms for this skill cannot be confirmed because LICENSE.txt was not provided.
How to install
The skill is located at skills/.curated/screenshot/. The README says curated skills can be installed in Codex with $skill-installer screenshot, followed by a Codex restart. The source does not state a separate cost. It says an individual skill's license is in its directory's LICENSE.txt, but that file's contents are not included here.
How to use
Ask for a screenshot to use the default save location. For an explicit path, use: python3 <path-to-skill>/scripts/take_screenshot.py --path output/screen.png. For agent inspection, use: python3 <path-to-skill>/scripts/take_screenshot.py --mode temp. For a pixel region, use: python3 <path-to-skill>/scripts/take_screenshot.py --mode temp --region 100,200,800,600. macOS supports --app and --window-name; Linux supports --active-window; Windows uses the PowerShell helper. The installed skill directory path is environment-dependent.
Compared to similar skills
The skill explicitly prioritizes specialized capture capabilities such as a Figma MCP/skill or Playwright/agent-browser. It is intended for whole-system captures, explicit desktop-capture requests, or cases where those integrated tools cannot provide the needed image.