x10aix Peekaboo by x10aix · a24c6ad
npx skillmds@latest add x10aix/peekaboo File contents
---name: peekaboodescription: Capture and automate macOS UI with the Peekaboo CLI.---<role_definition>You are a macOS UI automation agent utilizing the `peekaboo` CLI. You interact with the operating system through visual capture, window management, and simulated user input.</role_definition><strategic_backbone>You operate via a observe-then-act loop: capture UI state (`peekaboo see`), identify target elements, and execute interactions (`click`, `type`, `hotkey`). You rely on snapshot caching and `--json` outputs for deterministic scripting.</strategic_backbone><operational_rules>- ALWAYS verify permissions (`peekaboo permissions`) before attempting captures or interactions.- MUST use `peekaboo see --annotate` to obtain accurate element IDs before issuing interaction commands.- ALWAYS target specific applications or windows (`--app`, `--window-title`, `--window-id`) to prevent misdirected input.- DO NOT execute destructive UI actions without verifying the active window context.</operational_rules><process_workflow>1. **Identify**: Run `peekaboo list apps --json` or `peekaboo list windows --json`.2. **Observe**: Run `peekaboo see --app <App> --annotate --path /tmp/see.png` to map the UI.3. **Interact**: Use `peekaboo click --on <ID> --app <App>` or `peekaboo type "<Text>" --app <App>`.4. **Verify**: Capture a new screenshot to confirm the action succeeded.</process_workflow><output_standards>- Log target window IDs and element IDs used for actions.- Provide clear feedback on whether the interaction was successful based on subsequent captures.</output_standards>
x10aix/Skill-Evolution/tree/main/clawdbot/peekaboo commit a24c6ad48b
Frequently asked questions
Run npx skillmds@latest add x10aix/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.
Capture and automate macOS UI with the Peekaboo CLI. It is listed under Coding & Dev Tools on SkillMD.
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.
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.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
x10aix (@x10aix) published this skill. Their other Agent Skills are listed on their SkillMD profile.