screenshot

Capture macOS application window screenshots to PNG files via command line.

9|1|Updated Jan 15, 2026
One-click install
npx skills add https://github.com/kxzk/shotty --skill screenshot-kxzk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: screenshot
Source: https://github.com/kxzk/shotty/tree/main
Command: npx skills add https://github.com/kxzk/shotty --skill screenshot-kxzk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When you need a visual record of what a macOS app is showing, taking precise window screenshots manually can be slow and error-prone.

Core Features & Use Cases

  • Window capture from the terminal: Capture a targeted application window by app name or process ID.
  • Multi-window support: Capture all windows for an application when needed (not just the first match).
  • Usable outputs for documentation: Save screenshots to a specified PNG path and optionally emit JSON output for window discovery.

Quick Start

Tell the skill to capture the Safari window and save it to a specific PNG file path, then share the resulting image with the user.

Frequently Asked Questions about screenshot

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

FAQPage Schema
How do I capture a macOS application window screenshot from the command line?

You can capture a macOS application window screenshot from the command line by targeting an app name or process ID, saving the output directly to a specified PNG file path.

Can I capture multiple windows for a single macOS app at once?

Yes, you can capture multiple windows for a single macOS app. The tool supports multi-window capture, allowing you to grab all windows for an application rather than just the first match.

Do I need special permissions to take screen captures on macOS using this method?

Yes, you need macOS Screen Recording permission. The screenshot capture relies on ScreenCaptureKit, which requires this system-level permission to function properly.

How do I list capturable windows and output the details as JSON?

You can list capturable windows and emit JSON output by using the supported JSON output flag. This helps with window discovery before capturing specific app windows to PNG files.

What is the best way to automate visual documentation of macOS app windows?

Automating visual documentation of macOS app windows is best done via command line screen capture. It allows targeting apps by PID or name and saving consistent PNG outputs for verification.

Are there limitations when capturing macOS windows with frame exclusion?

When capturing macOS windows, you can apply frame exclusion flags. However, the output is limited to PNG files and requires ScreenCaptureKit-backed permissions to execute successfully.