---

name: capturing-screenshots description: Captures screenshots of macOS application windows using ScreenCaptureKit. Use when the user asks to screenshot, capture, or photograph windows, needs visual verification of UI changes, or wants to document application state. user-invocable: true

Screenshot Skill

Capture screenshots of macOS application windows using ScreenCaptureKit.

Usage

Copy# available globally

shotty <command> [options]

Commands

Options

When to Use

• User asks to "screenshot this conversation" or "capture this window"
• User wants visual verification of UI changes
• User needs to document current application state
• User asks to see what an app looks like

Examples

Screenshot the current terminal:

Copyshotty capture Ghostty /tmp/terminal.png

Screenshot a browser:

Copyshotty capture Safari ~/Desktop/browser.png

Screenshot by PID:

Copyshotty capture 12345 output.png

List available apps:

Copyshotty list-apps

Capture all windows of an app:

Copyshotty capture "VS Code" --all

Workflow

1. If user doesn't specify an app, use list-apps to find the right target
2. Run capture with the app name or PID
3. Use the Read tool to view the resulting PNG and verify the capture
4. Report the file path to the user

Notes

• Requires Screen Recording permission (System Settings → Privacy & Security → Screen Recording)
• App names are matched case-insensitively with substring support
• Default output is screenshot.png in current directory
• Use --no-frame for cleaner captures without window shadow