🧪 Peekaboo
Use when working with the Peekaboo CLI or MCP server to capture macOS screens, inspect UI elements, and automate GUI interactions (see/click/type/scroll/hotkey/window/menu/dock/space), or when troubleshooting Peekaboo permissions, snapshots, or focus issues.
npx playbooks add skill khoi/skills --skill peekaboo
About Peekaboo
The Peekaboo skill is used for testing and enables the capture of macOS screens, inspection of UI elements, and automation of GUI interactions such as clicking, typing, and scrolling, as well as handling hotkeys, windows, menus, and other interface elements. It connects to the Peekaboo CLI or MCP server, and developers would reach for it when working with these tools or troubleshooting issues related to permissions, snapshots, or focus. This skill is particularly useful when automating interactions with macOS graphical user interfaces or diagnosing problems with Peekaboo configurations.
This compact 31-word instruction set is purpose-built for testing & qa work in AI coding agents. Install with a single command.
Use Cases
- Writing unit, integration, and end-to-end tests
- Setting up test coverage and CI pipelines
- Refactoring legacy code with confidence using tests
- Creating test plans and QA checklists
Example Prompts
System Prompt (31 words)
Use when working with the Peekaboo CLI or MCP server to capture macOS screens, inspect UI elements, and automate GUI interactions (see/click/type/scroll/hotkey/window/menu/dock/space), or when troubleshooting Peekaboo permissions, snapshots, or focus issues.
Frequently Asked Questions
What is Peekaboo?
Peekaboo is a free testing & qa skill for AI coding agents. Use when working with the Peekaboo CLI or MCP server to capture macOS screens, inspect UI elements, and automate GUI interactions (see/click/type/scroll/hotkey/window/menu/dock/space), or when troubleshooting Peekaboo permissions, snapshots, or focus issues.. It provides a specialized system prompt that configures your agent with testing & qa expertise.
How do I use Peekaboo with Claude Code?
Run npx playbooks add skill khoi/skills --skill peekaboo in your terminal to install Peekaboo into your Claude Code session. It works immediately after installation.
Which AI coding agents work with Peekaboo?
Peekaboo is compatible with Claude Code, Cursor, GitHub Copilot, Windsurf, OpenClaw, Cline, and any AI agent that supports custom system prompts or .cursorrules files.
Is Peekaboo free to use?
Yes, Peekaboo is completely free and open source. The full source is available on GitHub at https://github.com/khoi/skills/tree/main/skills/peekaboo. You only need a subscription to the AI agent you use it with.
