verified-screenshot

Capture macOS window screenshots with automated verification and retry logic.

3|1|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/smykla-skalski/sai --skill verified-screenshot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: verified-screenshot
Source: https://github.com/smykla-skalski/sai/tree/main/verified-screenshot/skills/verified-screenshot
Command: npx skills add https://github.com/smykla-skalski/sai --skill verified-screenshot

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyobjc-framework-Quartz, pyobjc-framework-ScreenCaptureKit, psutil, pillow, imagehash, pytesseract, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill ensures you capture exactly what you intend by automatically verifying screenshots of macOS windows, preventing wasted effort on incorrect or incomplete captures.

Core Features & Use Cases

  • Reliable Screenshot Capture: Captures specific macOS windows with options for verification.
  • Automated Verification: Checks for file existence, dimensions, content, and optionally text via OCR.
  • Retry Logic: Automatically retries captures if verification fails, ensuring success.
  • Use Case: When documenting UI changes or verifying application state, this skill guarantees the captured image is accurate and complete, even across different macOS versions and capture methods.

Quick Start

Use the verified-screenshot skill to capture a screenshot of the GoLand application window and verify its content.

Frequently Asked Questions about verified-screenshot

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

FAQPage Schema
How do I automate macOS screenshot capture and verify the image content?

Automated macOS screenshot capture and verification uses ScreenCaptureKit to grab specific windows and checks file existence, dimensions, content, and optional text via OCR to ensure image accuracy.

Why does my automated UI screenshot return incomplete or blank captures?

Incomplete or blank UI screenshots are resolved by automated retry logic that re-attempts captures if initial verification checks fail, ensuring accurate and complete image retrieval.

Can I capture macOS window screenshots across different spaces?

Yes, capturing macOS window screenshots across different spaces is supported by the ScreenCaptureKit backend. It integrates with window-controller for window discovery to ensure correct captures.

Does this screenshot verification tool support OCR text extraction?

Yes, screenshot verification supports OCR text extraction using pytesseract to optionally verify text content within the captured image alongside standard checks for file existence and dimensions.

What is the best way to verify UI state changes in macOS automation?

Verifying UI state changes in macOS automation is best done by capturing screenshots with automated verification of image integrity, dimensions, and text, guaranteeing accurate application state documentation.

Do I need Pillow and imagehash to verify captured macOS screenshots?

Pillow and imagehash are required dependencies for verifying captured macOS screenshots. They process image data and perform perceptual hashing to validate content integrity during automated capture and retry logic.