Awesome-omni-skill screenshot

Capture screenshots of application windows

install
source · Clone the upstream repo
git clone https://github.com/diegosouzapw/awesome-omni-skill
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/diegosouzapw/awesome-omni-skill "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/development/screenshot" ~/.claude/skills/diegosouzapw-awesome-omni-skill-screenshot && rm -rf "$T"
manifest: skills/development/screenshot/SKILL.md
source content

Screenshot Skill

Capture screenshots of macOS application windows using ScreenCaptureKit.

Usage

shotty <command> [options]

Commands

CommandDescription
capture <app|pid> [output.png]
Screenshot an app's window(s)
list
List all capturable windows
list-apps
List running applications

Options

FlagDescription
--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

  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