agentleFS
Sign inStart free
yourkenikeyourkenike/ciana-parrot/skills/peekaboo/SKILL.md

peekaboo

Skill1 starsChanged 9 months agoMITView on GitHub

macOS UI automation: capture screenshots, click elements, type text, manage apps/windows/menus. Full desktop control via peekaboo CLI.

  • Installs packages

37 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use taskflow-inbox-triage, BlueBubbles and 7 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • AtomicBot-aiSkill

    taskflow-inbox-triage

    Also in 6 projects that use this

  • jiulingyunSkill

    BlueBubbles

    为Clawdbot构建或更新BlueBubbles外部通道插件（扩展包，REST发送/探测，webhook入站）。

    Also in 16 projects that use this

  • hkyutongSkill

    openclaw-release-maintainer

    Maintainer workflow for OpenClaw releases, prereleases, changelog release notes, and publish validation. Use when Codex needs to prepare or verify stable or beta release steps, align version naming, assemble release notes, check release auth requirements, or validate publish-time commands and artifacts.

    Also in 4 projects that use this

  • seedprodSkill

    session-logs

    Search and analyze your own session logs (older/parent conversations) using jq.

    Also in 16 projects that use this

  • seedprodSkill

    voice-call

    Start voice calls via the OpenClaw voice-call plugin.

    Also in 15 projects that use this

  • AtomicBot-aiSkill

    taskflow

    Also in 6 projects that use this

  • +2 more from seedprod

The file

We split this skill into the rules it gives an agent

2 rules. 0 are common, 0 are distinctive, and 2 are very specific to this project.

  • 0

    Common

    Most of the 36 edited versions we read keep these.

  • 0

    Distinctive

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Use the peekaboo bridge for full macOS UI automation: screenshots, clicks, typing, app/window management.

    line 9
  2. Very specific:

    All commands run via host_execute(bridge="peekaboo", command="...").

    line 25

“Common” is measured: kept by at least 6 in 10 of the 36 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Peekaboo (macOS UI Automation)

Use the peekaboo bridge for full macOS UI automation: screenshots, clicks, typing, app/window management.

When to Use

  • User asks to interact with a macOS app (click, type, screenshot)
  • Capturing what's on screen
  • Automating UI workflows
  • Managing windows, menus, Dock

When NOT to Use

  • Tasks that can be done via API/CLI -> prefer the specific bridge/skill
  • Bulk automation -> consider AppleScript or Shortcuts instead

Commands

All commands run via host_execute(bridge="peekaboo", command="...").

See & Capture

peekaboo permissions                                          # Check permissions
peekaboo see --annotate --path /tmp/peekaboo-see.png          # Annotated screenshot
peekaboo image --mode screen --path /tmp/screen.png           # Full screenshot
peekaboo image --app Safari --analyze "Summarize the page"    # Screenshot + analysis
peekaboo list apps --json                                     # List running apps
peekaboo list windows --app Safari --json                     # List windows

Interact

peekaboo click --on B1                                        # Click element by ID
peekaboo click --coords 500,300                               # Click by coordinates
peekaboo type "Hello" --return                                # Type text + Enter
peekaboo hotkey --keys "cmd,shift,t"                          # Keyboard shortcut
peekaboo scroll --direction down --amount 5                   # Scroll

App Management

peekaboo app launch "Safari" --open https://example.com
peekaboo app quit --app Safari
peekaboo window focus --app Safari
peekaboo menu click --app Safari --item "New Window"

Workflow: See -> Click -> Type

peekaboo see --app Safari --annotate --path /tmp/see.png      # 1. See what's on screen
peekaboo click --on B3 --app Safari                           # 2. Click target element
peekaboo type "search query" --app Safari --return            # 3. Type and submit

Setup (on host)

  • Install: brew install steipete/tap/peekaboo
  • Grant Screen Recording + Accessibility permissions in System Settings
  • Uncomment peekaboo bridge in config.yaml, restart gateway

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free