← Back to Skills Marketplace
gedigi

Peekaboox

by Gerardo Di Giacomo · GitHub ↗ · v1.0.0
linux ⚠ suspicious
711
Downloads
2
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install peekaboox
Description
Control and automate the Linux desktop GUI on X11. Use this skill to take screenshots, find and click UI elements, type text, send keyboard shortcuts, scroll...
Usage Guidance
This skill appears coherent and implements X11 desktop automation using standard tools. Before installing: (1) be aware it can capture screenshots and simulate clicks/typing — do not run it in sessions with sensitive content unless you trust the skill and agent. (2) install.sh uses sudo to add system packages; review it if you need to limit package installs. (3) Test in a non-sensitive environment first (or in a VM/container). (4) Note it only supports X11 (not Wayland). If you need stricter controls, run the scripts locally yourself and avoid granting the agent autonomous access to call them against a live desktop with sensitive data.
Capability Analysis
Type: OpenClaw Skill Name: peekaboox Version: 1.0.0 The skill provides extensive Linux X11 GUI automation capabilities, which are inherently powerful and carry a high risk of misuse, even if the code itself is not intentionally malicious. The `install.sh` script requires `sudo` to install system-wide packages (`xdotool`, `wmctrl`, `scrot`, `imagemagick`, etc.), granting broad permissions. While these tools are legitimate for GUI automation, their ability to simulate user input, take screenshots of the entire desktop, and manage windows could be leveraged by a malicious actor or a compromised agent to perform unauthorized actions or exfiltrate sensitive on-screen data. There is no direct evidence of malicious intent within the provided scripts or prompt instructions, but the capabilities themselves are significant security considerations.
Capability Assessment
Purpose & Capability
Name/description (X11 desktop automation) matches what the files do: scripts call xdotool, wmctrl, scrot, xprop, import, etc. Required binaries (xdotool, wmctrl, scrot) and DISPLAY are appropriate and expected.
Instruction Scope
SKILL.md and scripts instruct only X11-focused actions (screenshots, window listing, clicking, typing, hotkeys, scrolling, window management). There are no instructions to read unrelated files, collect unrelated env vars, or post data to external endpoints. The guidance to set DISPLAY or use Xvfb is reasonable.
Install Mechanism
install.sh uses system package managers (apt/dnf/pacman) to install well-known packages; no arbitrary URL downloads or archives. The script requires sudo for package installation which is expected for system-level binaries.
Credentials
The only declared env var is DISPLAY, which is appropriate. However, the skill inherently has high-impact capabilities (captures screenshots, sends keystrokes, clicks, window control) and therefore can access sensitive on-screen data (passwords, messages). This capability is proportional to the purpose but carries user-risk if used in an untrusted environment.
Persistence & Privilege
No always:true, no modifications to other skills or global agent config. The skill is user-invocable and can be invoked autonomously per platform default, which is expected for skills of this type.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install peekaboox
  3. After installation, invoke the skill by name or use /peekaboox
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial publish of Linux desktop automation skill
Metadata
Slug peekaboox
Version 1.0.0
License
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is Peekaboox?

Control and automate the Linux desktop GUI on X11. Use this skill to take screenshots, find and click UI elements, type text, send keyboard shortcuts, scroll... It is an AI Agent Skill for Claude Code / OpenClaw, with 711 downloads so far.

How do I install Peekaboox?

Run "/install peekaboox" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Peekaboox free?

Yes, Peekaboox is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Peekaboox support?

Peekaboox is cross-platform and runs anywhere OpenClaw / Claude Code is available (linux).

Who created Peekaboox?

It is built and maintained by Gerardo Di Giacomo (@gedigi); the current version is v1.0.0.

💬 Comments