What permissions are required for this skill to work?

You must grant Screen Recording permissions for window discovery and capture, and Accessibility permissions if you wish to use AppleScript-based window activation.

How does the skill ensure a screenshot isn't blank or stale?

It uses perceptual hashing via the imagehash library to compare the captured image against blank templates and previous captures, ensuring the content is unique and meaningful.

Does it support capturing specific JetBrains or IDE sandbox windows?

Yes, it includes specialized support for sandbox IDEs (like those run via Gradle) by filtering via process arguments and handling non-activatable window states.

Can it capture windows located on different macOS Spaces?

Yes, by using the ScreenCaptureKit backend (available on macOS 12.3+), the skill can capture windows across any Space without requiring a visible switch.

macOS Verified Screenshots

Name: macOS Verified Screenshots
Author: smykla-skalski

bysmykla-skalski

0•

Seguridad y Pruebas

Captures and validates macOS window screenshots using advanced verification logic and automated retries to ensure visual accuracy.

The macOS Verified Screenshot skill provides Claude with a reliable way to capture and audit desktop application windows. Unlike standard screen capture tools, it implements a sophisticated verification pipeline that checks for valid image dimensions, meaningful content via perceptual hashing, and specific on-screen text using OCR. It intelligently handles complex macOS environments by supporting both modern ScreenCaptureKit for cross-Space captures and legacy Quartz backends, ensuring that UI automation and documentation tasks are performed with high fidelity and automatic error recovery.

Características Principales

010 GitHub stars

02Intelligent window discovery by application name, PID, title regex, or CLI arguments

03Configurable retry logic with exponential backoff and window reactivation strategies

04Support for ScreenCaptureKit to capture occluded windows or windows on different Spaces

05Multi-strategy verification including dimensions, perceptual hashing, and OCR text matching

06Automated artifact management with standardized timestamped output paths

Casos de Uso

01Automated visual regression testing and UI state verification

02Generating high-quality documentation for desktop software and IDE plugins

03Debugging rendering issues in sandbox environments or background applications

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add smykla-skalski/research verified-screenshot

For use in Claude.ai and ChatGPT

Download Skill