screenshot

name: screenshot description: Capture screenshots of application windows user-invocable: true

Screenshot Skill

Capture screenshots of macOS application windows using ScreenCaptureKit.

Usage

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:

shotty capture Ghostty /tmp/terminal.png

Screenshot a browser:

shotty capture Safari ~/Desktop/browser.png

Screenshot by PID:

shotty capture 12345 output.png

List available apps:

shotty list-apps

Capture all windows of an app:

shotty 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