- Home
- Skills
- Workflow Automation
- Mac ScreenDumps
More screenshots
Works with the AI Agents you already use
Mac ScreenDumps
Screenshot every virtual desktop on every Mac display in one run, named Screen 1 - Desktop 1 and so on.
$5
Mac ScreenDumps
Example session with this skill installed
I need to take a screenshot of every single Space and monitor I have open right now to document my workflow.
- Read your context and instructions
- Compiled the mac screendumps
Terminal output from a real run on a two-display Mac - a 3440x1440 ultrawide as the main display and a 1280x1024 secondary - with 16 virtual desktops on each:
Found 2 displays.
Capture method: screencapture -R
-- Screen 1 3440x1440 (main display) --
16 desktops according to the system
. Screen 1 - Desktop 1.png
. Screen 1 - Desktop 2.png
... through Desktop 16
-- Screen 2 1280x1024 --
16 desktops according to the system
. Screen 2 - Desktop 1.png
... through Desktop 16
-- Check --
Screen 1: 16 images of 16 known desktops ok
Screen 2: 16 images of 16 known desktops ok
Result: 32 PNG files plus _diagnostics.txt in ScreenDumps/2026-08-21 20.26.46/, about 60 MB, produced in just under two minutes. Both displays were returned to the desktop they started on.
Connects securely to your tools. The creator never sees your data.
About this skill
The problem
macOS prevents apps from capturing any virtual desktop (Space) that is not currently visible. Standard screenshot tools only grab the active screen, forcing you to switch to each desktop and snap it by hand, one at a time.
What it does
- Walks every Space on every connected display and captures each one as it becomes visible.
- Names files by position: Screen 1 - Desktop 1.png through Screen 2 - Desktop 16.png. Full-screen apps own their own Space and are numbered separately as Fullscreen 1, 2, matching how Mission Control treats them.
- Activates the correct display before each walk. The desktop-switch shortcut follows keyboard focus, not the pointer, which is why a naive script captures the second monitor's first desktop sixteen times.
- Tries five capture methods at startup, including CoreGraphics directly, and keeps whichever actually writes a file. The screencapture tool behaves differently across macOS versions and can report success while producing nothing.
- Hashes every image and signs every display with the window IDs on it. If neither changes, the desktop did not switch, so nothing is written and the display is reported as stuck instead of filling the folder with copies.
- Returns each display to the desktop it started on, where macOS reports that reliably.
What you get
A single double-clickable .command file with a documented settings block at the top - output folder, image format, delays, whether to include full-screen apps - plus a SKILL.md that tells your agent how to install, run and troubleshoot it, and a symptom-by-symptom troubleshooting reference. It installs nothing, downloads nothing, and uses only tools that ship with macOS. MIT licensed.
When something goes wrong
Every run ends with a per-display check - Screen 1: 16 images of 16 known desktops, ok - and writes a diagnostics log recording the macOS version, which capture method won, what the others reported, and how many Spaces each display claimed. That file usually names the cause outright.
Why this beats prompting it yourself
macOS provides no public API for switching Spaces, so the job has to be done by driving the keyboard and verifying the result afterwards. The hard part is not taking the screenshots. It is the permission requirements, the display focus logic, and knowing when a switch silently failed.
macOS only - it depends on Spaces, screencapture, and JXA.
Requires Screen Recording, Accessibility, and Automation permissions for the terminal app. macOS silently produces nothing without the first one, and ticking the box is not enough: Terminal must be quit completely with Command-Q and reopened before it takes effect.
The pointer and the active display move during the run, and one synthetic click lands on each display to move keyboard focus. The machine is not usable while it works - roughly a minute per display. Everything is put back afterwards.
If Stage Manager is on together with "Click wallpaper to reveal desktop", that focus click can hide your windows and the captured desktops come out bare. Turn that setting off, or disable CLICK_TO_FOCUS and accept that only the active display can be walked.
Some macOS versions capture rectangles at 1x rather than Retina resolution when the per-display capture flag is unavailable. The tool detects this and says so in its notes rather than silently producing smaller images.
Return to the starting desktop is best effort. On macOS versions where the system does not report each display's current Space live, a display may be left on the last desktop captured.
Desktops that are genuinely pixel-identical and whose window list cannot be read may be undercounted; raising MAX_DUPLICATES in the settings block handles this.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Money-back guarantee
Doesn't do what its page promises? You get your money back.
Trust & safety
Security scan
Security scan passed 2 months ago
Permissions
Terminal runs the bundled .command script. File read covers one system preference file (com.apple.spaces) to count how many virtual desktops each display has. File write covers the screenshots and a diagnostics log, both in a folder the user chooses. No network access of any kind - nothing is uploaded, downloaded, or transmitted. Separately, macOS itself asks for Screen Recording and Accessibility permission, which is what taking screenshots and switching desktops requires.