Back to Skills

Desktop Control

Control mouse, keyboard, and screen for desktop automation tasks

2starsUpdated 5/9/2026

Security Assessment

Safe(100/100)
Security Score100/100

About Desktop Control

The Desktop Control skill enables comprehensive automation of desktop environments by providing programmatic access to mouse, keyboard, and screen operations. It addresses the challenge of repetitive or complex manual tasks by allowing AI agents to interact with applications and the operating system directly. By using this skill, users can streamline workflows, automate testing, and perform tasks that would otherwise require constant human input, improving both efficiency and accuracy in desktop operations.

This skill leverages PyAutoGUI to offer precise control over cursor movements, mouse clicks, keyboard input, screenshot capture, and screen analysis. Key features include mouse manipulation such as moving, clicking, dragging, and scrolling, as well as keyboard operations including typing text, executing hotkeys, and holding or releasing keys. It also supports screen-related commands like taking full or region-specific screenshots, locating images or text on the screen, and querying pixel information. Additionally, the skill includes message dialogs and application control capabilities, enabling interactions with user interfaces and the management of open windows.

Typical use cases include automating repetitive tasks like data entry, testing UI elements, capturing and analyzing screen content, and controlling multiple applications programmatically. This skill is particularly useful for software testers, workflow automation specialists, AI researchers, and developers looking to integrate desktop automation into larger AI systems. By providing a unified command interface through the `uvx desktop-agent` CLI, it caters to both technical and non-technical users seeking to optimize desktop interactions without manual intervention.

FAQ

How do I execute a mouse click at a specific location?

You can use the command `uvx desktop-agent mouse click <x> <y>` and optionally specify the button type and number of clicks using the options `--button` and `--clicks`.

Can this skill type text automatically with delays between characters?

Yes, the keyboard write command supports an optional `--interval` parameter to control the delay between each character typed.

Is this skill compatible with all operating systems?

The skill relies on PyAutoGUI, which supports Windows, macOS, and Linux. Some functionality may vary depending on the operating system and window manager.

Can I capture only a portion of the screen?

Yes, the screen screenshot command allows specifying a region with coordinates and dimensions using the `--region` option.

Are there any limitations when locating images or text on the screen?

Image and text recognition rely on visual matching and OCR, so accuracy can be affected by screen resolution, scaling, window overlays, and image clarity. Confidence levels can be adjusted for image detection using the `--confidence` option.

All Files

43 files
commands/mouse.py3.8 KB
View
openspec/changes/rename-to-desktop-agent/design.md4.5 KB
View
.gitignore0.1 KB
View
openspec/changes/rename-to-desktop-agent/tasks.md1.5 KB
View
.opencode/command/openspec-apply.md1.4 KB
View
desktop_agent/commands/__init__.py0.0 KB
View
scripts/__init__.py0.0 KB
View
.opencode/command/openspec-archive.md1.9 KB
View
uv.lock442.7 KB
View
.opencode/command/openspec-proposal.md2.5 KB
View
scripts/install.py3.3 KB
View
.python-version0.0 KB
View
desktop_agent/commands/keyboard.py3.0 KB
View
desktop_agent/commands/screen.py12.7 KB
View
AGENTS.md0.6 KB
View
desktop_agent/commands/message.py3.3 KB
View
desktop_agent/specs/__init__.py0.3 KB
View
commands/screen.py3.1 KB
View
openspec/changes/rename-to-desktop-agent/proposal.md2.7 KB
View
README.md5.3 KB
View
desktop_agent/commands/mouse.py5.3 KB
View
desktop_agent/utils/response.py2.7 KB
View
SKILL.md20.1 KB
View
desktop_agent/commands/app.py8.4 KB
View
commands/keyboard.py1.7 KB
View
main.py0.2 KB
View
commands/message.py2.0 KB
View
openspec/AGENTS.md14.4 KB
View
.agent/workflows/openspec-apply.md1.2 KB
View
.agent/workflows/openspec-archive.md1.9 KB
View
.agent/workflows/openspec-proposal.md2.4 KB
View
.github/workflows/release.yml1.8 KB
View
commands/__init__.py0.0 KB
View
desktop_agent/__init__.py0.7 KB
View
desktop_agent/__main__.py0.2 KB
View
desktop_agent/specs/v1/schema.json3.1 KB
View
desktop_agent/utils/__init__.py0.1 KB
View
desktop_agent/utils/errors.py1.5 KB
View
examples/automation_examples.md5.4 KB
View
pyproject.toml0.9 KB
View
openspec/changes/rename-to-desktop-agent/specs/cli-naming/spec.md1.4 KB
View
openspec/changes/rename-to-desktop-agent/specs/package-distribution/spec.md2.6 KB
View
openspec/project.md1.7 KB
View

Install Desktop Control

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill