yomado
Prepare and manage yomado virtual work screens on macOS using existing computer-use tools. Use when an agent needs to create or name a work screen, move authorized app windows into it, verify visual access, or return those windows after a task.
chekusu · Static checks on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add chekusu/yomado --skill yomadoAbout this skill
name: yomado description: "Prepare and manage yomado virtual work screens on macOS using existing computer-use tools. Use when an agent needs to create or name a work screen, move authorized app windows into it, verify visual access, or return those windows after a task."
yomado
Let the agent prepare its own work screen; the user does not need to create it manually. Operate the installed yomado app through the agent's existing computer-use tools. This skill supplies the workflow, not a separate screenshot/input tool or management API.
Before changing anything
- Confirm yomado is installed and the agent has tools for reading the actual native UI, screenshots and input. Use the available tool's documentation for its calls; do not invent an API. If the app is missing, use the official download within the user's installation authority.
- Check that the capture tool supports selecting a non-primary display or its target window before creating a screen or moving apps. If it is known to capture only the primary display, stop before moving windows; a new screen will not fix that limitation.
- The macOS desktop must be logged in and unlocked. The user handles first-time macOS permission grants and any authentication. yomado needs window-control permission; the agent's tools need their own capture/input permissions.
- Identify the task's apps and windows from the user's request. Inspect the current screen layout, physical main display, virtual display names/IDs, bounds and scale, plus the original bounds of the windows that may move. Keep this recovery record local; do not publish window titles, screenshots or machine identifiers.
- Reuse a suitable screen belonging to this task when possible. A familiar name does not prove ownership: do not reuse, rename or close another task's screen without authority. Coordinate with any existing desktop owner before GUI operations.
- Virtual screens share the login session, focus, keyboard and pointer. They do not provide independent agent input. Follow Share the mouse and keyboard below before any input.
Prepare the screen
- Open yomado's control panel from its menu-bar item or by opening the installed app. Opening an existing instance brings back its panel; do not quit or restart it to find the panel.
- Inspect the live UI. In v0.3.3, the menu-bar accessibility label is
yomado · 夜窗and its panel item is打开控制面板. Labels may change in later versions; use current observations, not fixed coordinates. - If the live panel has
+ 新建屏幕, open it, enter a task-owned name such asCodex · Blender, choose resolution and HiDPI, then select创建并启动. For a saved task-owned screen, use启动in the未启动的虚拟屏section; use编辑to change its stopped configuration without starting it. Running screens can be renamed from…→重命名…. Older releases may still use the header+menu and saved-screen submenus: follow the controls actually observed, never fixed coordinates or assumed labels. - Record the new screen's actual ID/bounds/scale. A renamed running screen can retain its old name in macOS until restarted; do not restart merely to synchronize the name.
- Compare the display arrangement and main display with the checkpoint before moving apps. Adding or removing displays can rearrange the desktop in released versions. If an existing screen moved, stop and report the discrepancy; do not continue moving user windows or silently change the main display. Resolve layout only within the user's authority.
Keep physical outputs enabled and a physical display as main during ordinary setup. Do not change power, lock, login or display settings just because the task needs a work screen. Resolution/HiDPI controls apply to a stopped screen; do not stop an occupied screen to change them.
Move only the task's windows
Choose the narrowest supported operation after inspecting its scope:
| Control | Windows it selects |
|---|---|
| Drag an app icon from one screen tile to another | That app's ordinary windows on the source screen |
Target screen + → App · 实体屏 | That app's ordinary windows across all physical screens |
Target screen + → App · <virtual screen> | That app's ordinary windows on the named virtual source |
Drop a running .app bundle from Finder | That app's ordinary windows across screens |
An icon is an app/window group, not a single-window or process selector. If the selected group includes personal or other-task windows, do not use that group operation. Use a verified per-window move supported by the existing computer-use tool, if available and authorized; otherwise obtain a narrower selection from the user. Do not collect all windows to make capture easier.
Drag into the target screen tile, or use its + chooser only when the chooser's full scope is authorized. Check fresh window bounds and the screen's app inventory after the move. An icon/count describes detected visible windows, not GPU activity or proof of agent access. Some apps refuse Accessibility positioning.
If the header shows a lock icon, window movement needs permission. The icon opens the relevant macOS settings page; let the user grant access. Opening settings is not authorization. Do not reset permissions or keep retrying the same failed move.
Verify before working
- Select the actual target display/window in the agent's capture tool. The tool may list the virtual screen under a generic name (such as
display 7) rather than its yomado name; match it by display ID or bounds. Acquire a fresh target-app screenshot and current window bounds, pixel dimensions and scale; discard pre-move coordinates. A correct, fresh target screenshot is required before any test input. - Perform one authorized, reversible operation in the real target app, such as opening and dismissing a menu or changing and restoring a view. Confirm the change in a new screenshot before claiming visual operation works.
- If targeting fails only