headless-gui-desktop SKILL.md skillA
headless-gui-desktop from black-yt/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add black-yt/skills/headless-gui-desktop@git:20261105.29d28c5Pins git:20261105.29d28c5 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- black-yt/skills
- Path
headless-gui-desktop/SKILL.md- Versions recorded
- 2
- Latest version
- git:20261105.29d28c5, committed Nov 5, 2026
- First version recorded
- Nov 5, 2026
- Size
- 7,910 bytes
- Repository stars
- 16
- License
- none declared
为 CUA（Computer Use Agent）和桌面自动化部署可截图、可用 PyAutoGUI 操控的无头 GUI 桌面；覆盖 Linux 容器、CPU rjob、低存储缓存、文件隔离、干净基线重建、产物导出，以及按用户要求接入现有 agent。.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# 面向 CUA 的无头 GUI 桌面 ## 默认方案与边界 - **适用范围：** 为 CUA / Computer Use Agent 提供通用软件桌面、截图和键鼠操作。目标应用可以是浏览器、编辑器、办公工具或其他 GUI 软件；按应用的系统、显示协议和渲染需求选择承载方式。 - **Linux 起点：** Ubuntu 22.04 + Xvfb + Openbox + Mesa llvmpipe + PyAutoGUI。优先使用官方二进制包；基础 GUI 可使用 CPU，应用明确要求 GPU 时另行评估。 - **隔离：** 这是容器内虚拟桌面，共享宿主机内核。用户确实需要独立内核、其他操作系统或更强隔离时，再选择具备 KVM 的 VM；不能把容器称为硬件虚拟机。Linux rjob 不适合运行 macOS。 - **文件边界：** 共享目录可用于部署和导出；独立 HOME、普通 UID 或新容器本身不保证 agent 无法写入可写挂载。按用户要求确认 agent 可访问的路径、挂载和权限，复原/导出验收见 [05](references/05_isolation_reset_and_export.md)。 - **执行位置：** 开发机只做编辑、轻量检查、提交和监控。apt、应用解压、GUI 和录屏放在获准的独立容器/worker/job；不修改开发机、共享 conda、shell 启动文件或公共软件目录。 - **资源起点：** 按目标应用实测 CPU、内存、分辨率和交互延迟。现有参考样例在 2 CPU / 8000 MiB / 0 GPU、1440×900 下通过测试，不将单个应用的结果外推为所有软件的资源保证。 - **存储：** 软件包缓存一份、会话临时解压、退出清理；录屏默认关闭。设置运行时间和视频体积上限，保留必要证据，避免每次任务永久复制应用和缓存。 - **控制范围：** 默认只提供截图、键鼠和可选录屏。用户要求接入已有 agent 时，按 [06](references/06_existing_agent_integration.md) 复用其模型循环；模型服务、凭据和执行任务由用户指定，不能因“computer use”自动加入自主任务或另写 agent loop。 ## 工作流 1. **判断环境：** 检查 CPU 配额、内存、架构、共享存储、容器权限及实际显示设备。没有 `/dev/kvm`、`/dev/dri` 或 NVIDIA 设备不妨碍 Xvfb + CPU OpenGL。 2. **准备软件：** 核对用户指定应用的官方版本、安装方式、运行依赖和校验值；缓存应用安装包及固定 Python 依赖。慢下载先确认真实文件接口和 Range 行为，不能只增加连接数。 …
Read the whole file at its exact version.
How to install
mdr add black-yt/skills/headless-gui-desktop@sha256:44eb4e13b0001481The line at the top of this page pins the label git:20261105.29d28c5, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_75y7ioj7s6wne4jj)
0 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 2 versions of this file, all committed on Nov 5, 2026.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261105.29d28c5 latest | 2026-11-05 | 29d28c5 | 7,910 B | A | view · diff |
| git:20261105.32b170b | 2026-11-05 | 32b170b | 5,832 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (7910 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
black-yt/skills · 16 stars · license none declared · pushed 2026-11-05 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_75y7ioj7s6wne4jj GET https://markdownregistry.com/api/v1/resolve?ref=black-yt/skills/headless-gui-desktop GET https://markdownregistry.com/api/v1/blob/44eb4e13b0001481c6b655bf7cb01a0d5f8cf535e4ec91439365f7793255b149
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.