skills.rest
productengineered
productengineeredCOMMUNITY
Explore all skills by this author →
GitHub

peekaboo

Automate macOS UI testing and visual QA via the Peekaboo MCP server.

Updated Apr 9, 2026
Search Tags:#qa#macos#screenshot#visual-qa#peekaboo#ui-automation#automation-tools
One-click install
npx skills add https://github.com/productengineered/parsely --skill peekaboo-productengineered
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: peekaboo
Source: https://github.com/productengineered/parsely/tree/main/.claude/skills/tooling/peekaboo
Command: npx skills add https://github.com/productengineered/parsely --skill peekaboo-productengineered

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Peekaboo MCP server enables macOS UI automation and visual QA by providing a comprehensive toolkit for screenshots, element interaction, dialog handling, and evidence capture, reducing manual tooling overhead in GUI validation.

Core Features & Use Cases

  • Screenshot and element map capture with IDs for UI verification and element discovery
  • Click, type, hotkey, scroll, drag, move, and other interactions to drive user journeys
  • Dialog handling and system interactions to recover from blocking prompts during automation
  • Visual QA workflows for screenshot capture, analysis, and validation of UI states
  • App/window management and per-space coordination to support multi-application workflows

Quick Start

Install and run the Peekaboo MCP server, ensure Screen Recording and Accessibility permissions are granted, and then execute a task using the peekaboo tools.

Frequently Asked Questions about peekaboo

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

FAQPage Schema
How do I automate macOS UI testing for visual QA workflows?▼

macOS UI testing and visual QA are automated by coordinating screen capture, element interaction, and dialog recovery through a comprehensive suite of 22 tools. This handles user journeys across apps and collects evidence for QA reviews.

What macOS permissions do I need for UI automation and screenshot capture?▼

UI automation and screenshot capture require Screen Recording and Accessibility permissions to be granted to the MCP server. These prerequisites allow the 22 tools to interact with UI elements and capture screens effectively.

Can I handle blocking system dialogs during macOS UI automation?▼

Blocking system dialogs are managed and recovered during macOS UI automation using specific dialog handling tools. This ensures automated user journeys continue running without manual intervention for prompts.

How do I capture UI elements and screenshots for QA evidence on macOS?▼

UI elements and screenshots are captured with element IDs for verification and discovery during macOS visual QA. This evidence collection supports QA reviews by validating UI states across multi-application workflows.

Does macOS UI automation support multi-application workflows and window management?▼

Multi-application workflows are supported through app/window management and per-space coordination. This allows UI automation to drive user journeys across different applications and manage windows effectively.

What interactions can I automate for macOS UI journeys beyond clicking?▼

Interactions for macOS UI journeys include click, type, hotkey, scroll, drag, and move commands. These tools drive comprehensive user journeys and interact with elements discovered via screenshots.

Related Skills

Explore More Software Engineering Skills→
X-School-AcademyX-School-Academy
9

dev-swarm-use-computer

Automate GUI interactions and screen capture for UI testing.

Official
Intermediate
jc180105jc180105

Evidence Collector

Generate Playwright screenshots and analyze visual evidence against specifications.

Community
Advanced
jamesrochabrunjamesrochabrun
194

qa-test-planner

Generate QA test plans, manual cases, regression suites, and bug reports.

Community
Advanced
huidgehuidge
2

findmy

Locate Apple devices and AirTags on macOS via Find My automation.

Community
Intermediate