Desktop
macOS desktop automation as an AgentDock Skill workflow.
Install
$ agentstack add skill-uvwt-agentdock-desktop ✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
Verified badge
Passed review? Show it. Paste this badge into your README, it links to the public security report.
Links to your public security report.[](https://agentstack.voostack.com/security/report/skill-uvwt-agentdock-desktop) Reliability & compatibility
Declared compatibility
Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.
We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.
How agent discovery & health will work →About
macOS Desktop Skill
AgentDock 的 macOS 桌面自动化能力已经从 core 工具拆分为此 Skill 工作流。
调用入口
skill_action=observe：action=preflight | list_apps | app_state | window_list | snapshot | snapshot_app。skill_action=act：action=focus | move | click | double_click | scroll | drag | type | set_value | secondary_action | hotkey | wait。skill_action=clipboard-read/skill_action=clipboard-write：读写剪贴板。
数据目录
截图原始文件写入 AGENTDOCK_HOME/skill-data/desktop/artifacts；snapshot / snapshot_app 同时发布到 AGENTDOCK_HOME/public-artifacts，并返回包含 artifact_id 的轻量 screenshot 引用。配置 AGENTDOCK_SERVER_URL 时额外返回带过期时间的签名 screenshot.url。需要模型查看图片时，再调用 AgentDock view_image(artifact_id=...)；Desktop Skill 不直接返回 Base64。历史截图已统一迁入同一私有数据目录。
- 动作参数不支持别名：
skill_action=act必须使用action枚举值；secondary_action的辅助动作名必须放在ax_action；wait使用ms。
辅助脚本执行
Skill 本体是本说明文档。确需调用包内辅助脚本时，在 Skill 包根目录使用相对路径执行；运行宿主负责切换到包根目录并把所需变量注入当前子进程。
printf '%s' '{"skill_action":""}' | python3 run.py输入必须是 JSON 对象。写操作仍按本文档中的确认规则执行。
| 动作 | 用途 | |---|---| | status | Run a desktop preflight check and report desktop automation readiness. | | observe | Unified macOS desktop observation action: preflight, listapps, appstate, windowlist, snapshot, or snapshotapp. | | act | Unified macOS desktop action: focus, move, click, doubleclick, scroll, drag, type, setvalue, secondary_action, hotkey, or wait. | | clipboard-read | Read macOS clipboard text. | | clipboard-write | Write macOS clipboard text and optionally verify by reading it back. |
Source & license
This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.
- Author: uvwt
- Source: uvwt/agentdock
- License: Apache-2.0
- Homepage: https://uvwt.github.io/agentdock-docs/
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet, be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.