mouse-keyboard

Control mouse and keyboard on Mac using cliclick. Use when you need to automate clicking, typing, or controlling the mouse cursor.

Security Scan

The skill is an instruction-only helper for using the macOS cliclick tool to automate mouse/keyboard actions; its requirements and instructions are consistent with that purpose and it does not request extra credentials or install code.

Purpose & Capability

Name and description match the SKILL.md: it documents how to run cliclick commands to control mouse and keyboard on macOS. No unrelated env vars, binaries, or config paths are requested.

Instruction Scope

Instructions are limited to running cliclick (and optionally osascript/sleep) via exec; they do not instruct reading files, exfiltrating data, or accessing unrelated system paths. Note: the skill tells the agent to execute system commands (exec), which is expected for this purpose but inherently powerful because it enables UI control.

Install Mechanism

No install spec or code is provided (instruction-only). That reduces disk-write risk. The skill assumes cliclick is available but does not attempt to download or install it.

Credentials

No environment variables, credentials, or config paths are requested — proportionate to the described single-purpose automation task.

Persistence & Privilege

always is false and the skill is user-invocable. However, the platform allows autonomous model invocation by default; since this skill performs UI control, allowing it to run autonomously increases potential for unwanted actions. The skill itself does not request persistent privileges or modify other skills.

Assessment

This skill is coherent and does what it says: it documents how to run cliclick to control the mouse and keyboard. Before installing, ensure you understand these points: (1) macOS requires granting Accessibility permissions to tools that control input — only grant those to trusted binaries and verify cliclick's origin. (2) The agent will use exec to run commands; avoid allowing autonomous invocation unless you trust the agent and the environment, because automated UI control can perform sensitive actions (clicking, typing passwords, approving dialogs). (3) Because the skill has no install step, make sure cliclick is installed from an official source (Homebrew or the project's release page). If you want additional safety, restrict the skill to manual (user-invoked) use and review any command strings before execution. If you see any later changes that add downloads, env vars, or always: true, re-evaluate — those would raise concerns.

Mouse & Keyboard Control

Use cliclick tool for mouse/keyboard automation on Mac.

Tools

exec

Use exec to run cliclick commands.

Available Commands

• c:X,Y - Click at coordinates X,Y
• c:~100,~200 - Click at relative position
• w:500 - Wait 500ms
• t:hello - Type "hello"
• kd:cmd - Key down command
• ku:cmd - Key up command
• p:return - Press return/enter
• p:space - Press space
• p:tab - Press tab
• m:X,Y - Move mouse to X,Y
• dp - Double click
• rc:X,Y - Right click at X,Y

Common Workflows

Click at position

cliclick c:500,300

Type text

cliclick t:Hello World

Click and type

cliclick c:500,300 && cliclick t:username

Keyboard shortcut

cliclick kd:cmd ku:cmd  # Press cmd

Move and click

cliclick m:100,100 && cliclick c:100,100

Getting Coordinates

Use cliclick p to print current mouse position, or use macOS screenshot tool (Shift+Cmd+4) to get coordinates.

Notes

• Coordinates are screen-based (0,0 is top-left)
• Use osascript for more complex keyboard operations
• Combine with sleep for timing