screenshot

Capture macOS screenshots of screens, displays, regions, or windows using the built-in screencapture command.

18|3|Updated May 10, 2026
One-click install
npx skills add https://github.com/fltman/claude-code-skill-screenshot --skill screenshot-fltman
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: screenshot
Source: https://github.com/fltman/claude-code-skill-screenshot
Command: npx skills add https://github.com/fltman/claude-code-skill-screenshot --skill screenshot-fltman

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Debugging UI issues or understanding visual problems often requires the user to manually take a screenshot and attach it. This Skill lets Claude capture macOS screenshots itself and read the resulting image, so it can see exactly what is on the user's screen without manual steps. ## Core Features & Use Cases - Multiple capture modes: full screen, a specific display, an exact coordinate region, an interactively dragged rectangle, a clicked window, a window by ID, or the frontmost window of a named app. - Window and display discovery: helper scripts list visible windows with their CGWindowIDs and active displays with resolutions, enabling precise non-interactive captures. - Multimodal readback: captures are saved as timestamped PNGs to /tmp/claude-screenshots/ and the path is returned so Claude can read the image directly. - Use Case: While debugging a rendering bug, ask Claude to screenshot Safari; it captures the frontmost Safari window and describes the visual issue it sees. ## Quick Start Ask Claude to take a screenshot of the whole screen and describe what is on it.

Frequently Asked Questions about screenshot

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

FAQPage Schema
How do I take a screenshot from the command line on macOS?▼

Use the built-in screencapture command, for example screencapture -x output.png for a full-screen capture. This Skill wraps it in scripts/capture.sh with modes like full, display, region, select, and window, saving timestamped PNGs to /tmp/claude-screenshots/.

How to capture a specific application window on macOS?▼

Run scripts/capture.sh app followed by the app name, such as scripts/capture.sh app Safari, to capture its frontmost window. Alternatively, list windows with scripts/list_windows.sh to find a CGWindowID, then pass it to scripts/capture.sh window <id>.

Why are my macOS screenshots coming out black?▼

Black screenshots mean the terminal app running the capture lacks Screen Recording permission. Grant it in System Settings → Privacy & Security → Screen Recording, then fully quit and restart the terminal app, since macOS only re-checks permission at launch.

Does this screenshot tool work on Windows or Linux?▼

No, it is macOS-only because it relies on the built-in /usr/sbin/screencapture command and CoreGraphics APIs via Swift. It also requires Xcode Command Line Tools for the window and display listing scripts.

How do I change where screenshots are saved?▼

Set the CLAUDE_SCREENSHOT_DIR environment variable to override the default /tmp/claude-screenshots directory. For example, prefix the capture command with CLAUDE_SCREENSHOT_DIR=~/Pictures/claude to store PNGs in a permanent location.