diegosouzapw Screenshot Skill
Capture screenshots of macOS application windows using ScreenCaptureKit.
Usage
shotty <command> [options]
Commands
| Command | Description |
|---|---|
capture <app|pid> [output.png] |
Screenshot an app's window(s) |
list |
List all capturable windows |
list-apps |
List running applications |
Options
| Flag | Description |
|---|---|
--all |
Capture all windows (not just first) |
--json |
Output as JSON |
--no-frame |
Exclude window frame/shadow |
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
- If user doesn't specify an app, use
list-appsto find the right target - Run
capturewith the app name or PID - Use the
Readtool to view the resulting PNG and verify the capture - 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.pngin current directory - Use
--no-framefor cleaner captures without window shadow