← Back to Skills Marketplace
desktop mouse
by
Oğuz Haşlak
· GitHub ↗
· v1.0.0
2544
Downloads
3
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install molt-mouse
Description
Local mouse control via ydotool wrapper
Usage Guidance
This skill appears to do exactly what it says: run a local 'molt-mouse' wrapper which uses ydotool to move/click the mouse. Before installing, verify where the 'molt-mouse' binary will come from (the package contains a shell implementation as molt-mouse.txt but does not install it automatically). Confirm you trust any agent that may invoke this skill autonomously (it can move and click your mouse). If you want tighter control, require explicit user invocation or disable model-driven invocation for this skill, and verify the molt-mouse/ydotool binaries on your system match the expected script and are not replaced by unexpected binaries.
Capability Analysis
Type: OpenClaw Skill
Name: molt-mouse
Version: 1.0.0
The skill provides direct control over the user's mouse via the `ydotool` utility, as implemented in `molt-mouse.txt`. While the `SKILL.md` instructions for the AI agent are well-constrained to only execute `molt-mouse` commands and the script itself appears robust against shell injection, the inherent capability to control a user's desktop input is a high-risk behavior. This capability, even when implemented without malicious intent, could lead to unintended actions if the agent's instructions or reasoning were compromised, making it suspicious.
Capability Assessment
Purpose & Capability
Name/description (local mouse control) matches what the skill requires and does: it invokes a local 'molt-mouse' wrapper which in turn calls ydotool/ydotoold to control the pointer. Requested binary and optional env settings (YDOTOOL_BIN, YDOTOOL_SOCKET, MOLT_MOUSE_*) are appropriate for this purpose.
Instruction Scope
SKILL.md limits runtime actions to exec calls on the gateway that begin with 'molt-mouse ...' and enumerates specific mouse commands (move/abs/click/hold/drag). The instructions do not ask the agent to read unrelated files, exfiltrate data, or call external network endpoints.
Install Mechanism
No install spec (instruction-only) and no remote downloads. The repository includes a shell script (molt-mouse.txt) that implements the wrapper, but the skill does not perform any installation itself — this is low-risk from an install perspective.
Credentials
The skill declares no required environment variables or credentials. The implementation uses standard optional env vars (YDTOOL_BIN, YDOTOOL_SOCKET, and MOLT_MOUSE_* tuning vars) which are reasonable for configuring a local input-control tool and do not expose secrets.
Persistence & Privilege
always:false (good). However user-invocable is false while model invocation is allowed (disable-model-invocation:false), meaning the agent can call this skill autonomously (but only the model, not the end user). Because the skill controls the local mouse, autonomous invocation could let the agent interact with the user environment/UI without explicit user action — this is an operational risk to consider, though not a sign of incoherence.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install molt-mouse - After installation, invoke the skill by name or use
/molt-mouse - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release: Enables local mouse control on Linux via molt-mouse.
- Supports mouse movement (relative and absolute) and mouse clicks (left, right, middle, button hold/release).
- Only executes secure commands prefixed with molt-mouse.
- Will prompt users for missing or unclear numerical coordinates.
- Not user-invocable directly; triggered by related skill requests.
Metadata
Frequently Asked Questions
What is desktop mouse?
Local mouse control via ydotool wrapper. It is an AI Agent Skill for Claude Code / OpenClaw, with 2544 downloads so far.
How do I install desktop mouse?
Run "/install molt-mouse" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is desktop mouse free?
Yes, desktop mouse is completely free (open-source). You can download, install and use it at no cost.
Which platforms does desktop mouse support?
desktop mouse is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created desktop mouse?
It is built and maintained by Oğuz Haşlak (@oguzhaslak); the current version is v1.0.0.
More Skills