agentleFS
Sign inStart free
uvwtuvwt/agentdock-skills/skills/desktop/SKILL.md

desktop

Skill6 starsChanged 2 months agoApache-2.0View on GitHub

macOS desktop automation as an AgentDock Skill workflow.

9 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use cli and testing.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • tieroSkill

    cli

    Also in 4 projects that use this

  • NVIDIASkill

    testing

    Run Python and Rust tests for physicsnemo-curator using uv + pytest with coverage reporting via pytest-cov, and cargo-nextest for Rust tests. Includes benchmark workflows with pytest-benchmark and criterion.

    Also in 3 projects that use this

The file

Create a free account to mount
Files
SKILL.md

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：读写剪贴板。

数据目录

截图原始文件写入 SKILL_DATA_DIR/artifacts；AgentDock managed 运行时由宿主注入私有 SKILL_DATA_DIR，其他宿主使用 XDG 状态目录作为 fallback。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 对象。写操作仍按本文档中的确认规则执行。

动作用途
statusRun a desktop preflight check and report desktop automation readiness.
observeUnified macOS desktop observation action: preflight, list_apps, app_state, window_list, snapshot, or snapshot_app.
actUnified macOS desktop action: focus, move, click, double_click, scroll, drag, type, set_value, secondary_action, hotkey, or wait.
clipboard-readRead macOS clipboard text.
clipboard-writeWrite macOS clipboard text and optionally verify by reading it back.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free