How do I install the Claw Mouse skill?

Run npx skillmds@latest add modbender/claw-mouse 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.

What does the Claw Mouse skill do?

Control a Linux X11 desktop by taking screenshots and moving/clicking/typing via xdotool + scrot. It is listed under Coding & Dev Tools on SkillMD.

Is Claw Mouse safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Claw Mouse?

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 Claw Mouse free to use?

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

Who published Claw Mouse?

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

Claw Mouse by modbender — Agent Skill

Name: Claw Mouse
Rating: 4.2 (5 reviews)
Author: modbender

File contents

claw-mouse

This skill provides a small, scriptable desktop GUI control helper for Linux X11.

It’s intended for “vision loop” automation:

take a screenshot
decide where to click
move/click/type
repeat

Under the hood it wraps:

scrot for screenshots
xdotool for mouse/keyboard/window control

Files

desktopctl.py — the CLI script

Requirements

Linux running X11 (not Wayland-only)
python3
xdotool
scrot

Ubuntu/Debian:

sudo apt-get update
sudo apt-get install -y xdotool scrot

Usage

From this skill directory:

python3 desktopctl.py screenshot
python3 desktopctl.py click 500 300
python3 desktopctl.py type "hello"
python3 desktopctl.py key ctrl+l
python3 desktopctl.py windows
python3 desktopctl.py activate "Chromium"

DISPLAY / XAUTHORITY

If you’re running from a daemon/headless shell where DISPLAY isn’t set:

DISPLAY=:0 XAUTHORITY=$HOME/.Xauthority python3 desktopctl.py screenshot

Or use flags:

python3 desktopctl.py --display :0 --xauthority $HOME/.Xauthority screenshot

Safety notes

This can click/type into your real desktop session. Use carefully.

Changelog

0.1.0: Initial published skill.

Frequently asked questions

Claw Mouse