How do I install the Peekaboo skill?

Run npx skillmds@latest add claude-world/peekaboo in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Peekaboo safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Peekaboo?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Peekaboo free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Peekaboo?

claude-world (@claude-world) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Peekaboo by claude-world — Agent Skill

Name: Peekaboo
Author: claude-world

Peekaboo

Capture and automate macOS UI with the Peekaboo CLI. Screenshots, element inspection, click automation, and accessibility tree reading. Use when user says "screenshot this app", "click on button", "automate UI", "what's on screen".

claude-world 3badaaa 1.6 KB Updated Sep 17, 2026

File contents

Peekaboo — macOS UI Automation

Capture and control macOS UI elements via the Peekaboo CLI.

Prerequisites

brew install steipete/tap/peekaboo

Requires macOS Accessibility permissions (System Settings → Privacy & Security → Accessibility).

Commands

Command	Purpose
`peekaboo screenshot`	Capture full screen
`peekaboo screenshot --app "Safari"`	Capture specific app
`peekaboo screenshot --window-id N`	Capture specific window
`peekaboo inspect --app "Finder"`	List UI elements (accessibility tree)
`peekaboo click --app "App" --element "Button Name"`	Click element
`peekaboo type --app "App" --element "TextField" --text "hello"`	Type text
`peekaboo list-windows`	List all open windows
`peekaboo list-apps`	List running applications

Usage Examples

/peekaboo screenshot Safari — capture Safari window
/peekaboo inspect Finder — show all UI elements in Finder
/peekaboo click "System Settings" "Wi-Fi" — click Wi-Fi in Settings

Rules

Check if peekaboo is installed: which peekaboo
If not installed: brew install steipete/tap/peekaboo
macOS only — inform Linux/Windows users this skill is unavailable
Screenshots saved to workspace/screenshot-<app>-<timestamp>.png
Always verify accessibility permissions if commands fail

Frequently asked questions