Provides macOS screen capture and UI automation capabilities for desktop applications.

Install

mkdir -p .claude/skills/peekaboo-steipete && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/16004" && unzip -o skill.zip -d .claude/skills/peekaboo-steipete && rm skill.zip

Installs to .claude/skills/peekaboo-steipete

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

macOS screenshots, UI inspect, clicks, typing, app/window automation.
69 charsno explicit “when” trigger
Intermediate

Key capabilities

  • →Capture macOS screenshots.
  • →Inspect UI elements on macOS.
  • →Automate clicks on the macOS GUI.
  • →Automate typing on the macOS GUI.
  • →Control macOS applications and windows.
  • →Check permissions for screen recording and accessibility.

How it works

The skill uses the `peekaboo` binary to interact with the macOS GUI, performing actions like screen capture, UI inspection, and input automation.

Inputs & outputs

You give it
A command to capture the screen, e.g., `"$PB" image --mode screen --screen-index 0 --path /tmp/screen.png --json --no-remote`
You get back
A screenshot image file at the specified path, e.g., `/tmp/screen.png`

When to use peekaboo

  • →Taking automated screenshots
  • →Interacting with desktop GUI elements
  • →Automating app clicks and typing

About peekaboo

Controls macOS desktop applications through UI inspection, screen capture, and input automation (clicks/typing). Manages bridge connectivity for GUI automation.

macOS screenshots, UI inspect, clicks, typing, app/window automation.

When not to use it

  • →When the task is not related to macOS automation.
  • →When the task does not involve GUI interaction or screen capture.
  • →When the target system is not macOS.

Limitations

  • →The skill is specific to macOS.
  • →Screenshot functionality may be blocked by missing Screen Recording permissions on remote Macs.
  • →Clicks/typing/window control require Accessibility permissions.

How it compares

This workflow provides programmatic control over macOS GUI elements, enabling automated tasks that would otherwise require manual user interaction.

Compared to similar skills

peekaboo side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
peekaboo (this skill)03moReviewIntermediate
session-status18moReviewBeginner
it-operations19moNo flagsAdvanced
customerio-cost-tuning02moReviewIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

More by steipete

View all by steipete →

markdown-converter

steipete

Convert documents and files to Markdown using markitdown. Use when converting PDF, Word (.docx), PowerPoint (.pptx), Excel (.xlsx, .xls), HTML, CSV, JSON, XML, images (with EXIF/OCR), audio (with transcription), ZIP archives, YouTube URLs, or EPubs to Markdown format for LLM processing or text analysis.

530

video-transcript-downloader

steipete

Download videos, audio, subtitles, and clean paragraph-style transcripts from YouTube and any other yt-dlp supported site. Use when asked to “download this video”, “save this clip”, “rip audio”, “get subtitles”, “get transcript”, or to troubleshoot yt-dlp/ffmpeg and formats/playlists.

417

instruments-profiling

steipete

Use when profiling native macOS or iOS apps with Instruments/xctrace. Covers correct binary selection, CLI arguments, exports, and common gotchas.

327

domain-dns-ops

steipete

Domain/DNS ops across Cloudflare, DNSimple, Namecheap for Peter. Use for onboarding zones to Cloudflare, flipping nameservers, setting redirects (Page Rules/Rulesets/Workers), updating redirect-worker mappings, and verifying DNS/HTTP. Source of truth: ~/Projects/manager.

27

create-cli

steipete

Design command-line interface parameters and UX: arguments, flags, subcommands, help text, output formats, error messages, exit codes, prompts, config/env precedence, and safe/dry-run behavior. Use when you’re designing a CLI spec (before implementation) or refactoring an existing CLI’s surface area for consistency, composability, and discoverability.

15

swiftui-performance-audit

steipete

Audit and improve SwiftUI runtime performance from code review and architecture. Use for requests to diagnose slow rendering, janky scrolling, high CPU/memory usage, excessive view updates, or layout thrash in SwiftUI apps, and to provide guidance for user-run Instruments profiling when code review alone is insufficient.

12

Search skills

Search the agent skills registry