Agent skill

Omapilot Desktop

by spencerbull in spencerbull/omarchy-omapilot

Control installed apps, Hyprland windows, workspaces, monitors, and window sizing through OmaPilot's structured desktop tools.

MITAuto-check passed

Install Omapilot Desktop

skills CLI
$ npx skills add spencerbull/omarchy-omapilot --skill omapilot-desktop -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install spencerbull/omarchy-omapilot omapilot-desktop --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/spencerbull/omarchy-omapilot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/omapilot-desktop .claude/skills/omapilot-desktop && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
omapilot-desktop
GitHub stars
127
Token cost
~966 tokens
SKILL.md length
541 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

Control installed apps, Hyprland windows, workspaces, monitors, and window sizing through OmaPilot's structured desktop tools.

  • Works in 4 steps: Search with app_catalog, or omit its… → If several results plausibly match, ask… → Call app_open with the exact result and… → …
  • Focus and for exact desktop arrangement requests
  • SKILL.md covers Apps, Omarchy CLI discovery, Web research handoff and Windows and workspaces
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Omapilot Desktop is an agent skill from spencerbull/omarchy-omapilot. Control installed apps, Hyprland windows, workspaces, monitors, and window sizing through OmaPilot's structured desktop tools. Use for app launching or focus and for exact desktop arrangement requests.

Its SKILL.md is about 970 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: OmaPilot - the native AI starting point for Omarchy Quattro. The licence is MIT.

When your agent uses it

  • Focus and for exact desktop arrangement requests

Example prompts

  • “/omapilot-desktop”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Search with app_catalog, or omit its query to browse installed apps.
  2. If several results plausibly match, ask the user to choose.
  3. Call app_open with the exact result and the narrowest mode
  4. Treat the app_open receipt as the verification. On verified: true, do

What it can do on your machine

Read from SKILL.md and the folder at commit 30474c9. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Omapilot Desktop loads about 966 tokens when it runs. Until then it costs about 55 tokens; SKILL.md has 541 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~55
When it runs · the whole SKILL.md, loaded when a task matches
~966

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from spencerbull/omarchy-omapilot at commit 30474c9, republished under its MIT licence (© spencerbull). 541 words, ~966 tokens.

Download SKILL.mdSave it as .claude/skills/omapilot-desktop/SKILL.md (or your agent's skills folder).
name
omapilot-desktop
description
Control installed apps, Hyprland windows, workspaces, monitors, and window sizing through OmaPilot's structured desktop tools. Use for app launching or focus and for exact desktop arrangement requests.

OmaPilot desktop control

Use the structured desktop tools when they cover the request. They validate exact targets, preserve the approval boundary, and return verified action receipts.

Apps

Desktop context lists currently open apps; it is not an inventory of installed software. Browse or search with app_catalog; do not guess an app ID or conclude that an app is missing because it is not open.

  1. Search with app_catalog, or omit its query to browse installed apps.
  2. If several results plausibly match, ask the user to choose.
  3. Call app_open with the exact result and the narrowest mode:
    • focus_or_launch for the normal personal-assistant behavior;
    • focus_existing when launching a copy would be wrong; or
    • new_window only when the user asked for another window.
  4. Treat the app_open receipt as the verification. On verified: true, do not call desktop_state just to recheck it. On failure, do not launch again through bash, close or relaunch a window, or otherwise compensate with a second mutation.

Use open_url for a URL. Use bash and its normal approval flow when a CLI request needs arguments or shell composition; app_open launches only an exact catalog entry.

Omarchy CLI discovery

Use omarchy_commands to search the installed, documented Omarchy command catalog by task or exact group. It is read-only and does not run the returned route. Prefer an existing structured tool for the action when one covers it; otherwise execute only the exact needed command through the normal approval flow. Do not guess subcommands from memory.

Web research handoff

Use web_handoff when the user needs current external information and no native search tool can return it inside OmaPilot. It opens the exact question in the search provider selected under Settings → Desktop → Search provider. Google and DuckDuckGo receive a search query; ChatGPT Search, Claude, and Grok also receive a paste-ready prompt on the clipboard in case their web composer does not prefill it.

This is an interactive browser handoff, not a search result. Report only that the provider was opened. Never claim to have read, synthesized, or verified the browser's answer. Use open_url instead when the user supplied a specific URL.

Show full SKILL.md (190 more words)Show less

Windows and workspaces

  1. Read desktop_state immediately before choosing a target. Window titles are private by default; request them only when class and workspace are insufficient to identify the user's intended window.
  2. Use the exact window address and PID, workspace number, or monitor name returned by that state. Never carry an address across turns or guess one from prior context.
  3. Perform one window_action or workspace_action. The tool re-reads pre-state after approval and verifies post-state itself.
  4. Report completion only when the returned receipt has verified: true; do not perform a redundant verification read. If the target disappeared, became ambiguous, or verification failed, say the action did not complete. Do not close, relaunch, or mutate a different window to compensate.

Prefer desired-state operations such as set_floating over toggles. Do not use raw hyprctl dispatch through bash for focus, workspace movement, resizing, floating state, or close actions that the structured tools support.

The current structured surface does not control fullscreen, maximized, grouping, pinning, scratchpads, or arbitrary layout messages. Explain that limitation instead of bypassing the structured boundary unless the user explicitly asks for an advanced raw command and approves it.

© spencerbull, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/omapilot-desktop of spencerbull/omarchy-omapilot.

Open the folder on GitHubat commit 30474c9

Compare with similar skills

Omapilot Desktop next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Omapilot Desktop compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Omapilot Desktop this skillspencerbull/omarchy-omapilot127—~966Automated safety check: PassMIT
Fedora Hyprland Installersickn33/agentic-awesome-skills47k1 repos~1.8kAutomated safety check: NotesMIT
Generating Python Installeraffaan-m/ECC277k1 repos~6.1kAutomated safety check: PassMIT
Qdrant Monitoringgithub/awesome-copilot40k1 repos~276Automated safety check: PassMIT
Windows Desktop E2Eaffaan-m/ECC277k1 repos~7.6kAutomated safety check: PassMIT
Windows Desktop E2Eaffaan-m/ECC276k—~5.5kAutomated safety check: PassMIT

Similar skills

  • Fedora Hyprland Installer

    sickn33/agentic-awesome-skills

    Install, configure, verify, repair, update, and uninstall Hyprland on Fedora Linux with GPU-aware detection (NVIDIA/AMD/Intel).

    47k GitHub starsUsed in 1 repo~1.8k tokens
    Auto-check: notes
  • Commercial-grade Python installer expert for Windows: Nuitka extreme compilation, dist slimming, DLL footprint analysis, and Inno Setup packaging to ship the smallest, fastest installers.

    277k GitHub starsUsed in 1 repo~6.1k tokens
    Testing & QAAuto-check passed
  • Qdrant Monitoring

    github/awesome-copilot

    Official

    Guides Qdrant monitoring and observability setup. An agent skill from github/awesome-copilot.

    40k GitHub starsUsed in 1 repo~276 tokens
    DevOps & CloudAuto-check passed
  • E2E testing for Windows native desktop apps (WPF, WinForms, Win32/MFC, Qt) using pywinauto and Windows UI Automation.

    277k GitHub starsUsed in 1 repo~7.6k tokens
    Testing & QAAuto-check passed
  • E2E testing for Windows native desktop apps (WPF, WinForms, Win32/MFC, Qt) using pywinauto and Windows UI Automation.

    276k GitHub stars~5.5k tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Official

    Guide for using the Grafana MCP to monitor and diagnose the capture service (rust/capture) in production.

    40k GitHub stars~5k tokensUpdated yesterday
    DevOps & CloudAuto-check passed

More from spencerbull/omarchy-omapilot

  • Omapilot Calendar

    spencerbull/omarchy-omapilot

    Review HEY calendars, events, and personal to-dos through OmaPilot's typed tools.

    127 GitHub stars~224 tokensUpdated 1 mo ago
    Auto-check passed
  • Omapilot Email

    spencerbull/omarchy-omapilot

    Search, read, send, or reply to personal email through OmaPilot's typed HEY tools.

    127 GitHub stars~250 tokensUpdated 1 mo ago
    Auto-check passed
  • Omapilot Files

    spencerbull/omarchy-omapilot

    List, search, read, or open files inside the single folder selected in OmaPilot Settings.

    127 GitHub stars~239 tokensUpdated 1 mo ago
    Auto-check passed
  • Omapilot Projects

    spencerbull/omarchy-omapilot

    Search and update Basecamp projects through OmaPilot's typed tools.

    127 GitHub stars~230 tokensUpdated 1 mo ago
    Auto-check passed
  • Omapilot Meetings

    spencerbull/omarchy-omapilot

    Open an exact Zoom meeting through OmaPilot and the configured Omarchy browser handler.

    127 GitHub stars~171 tokensUpdated 1 mo ago
    Auto-check passed
  • Omapilot Messages

    spencerbull/omarchy-omapilot

    Send Signal messages through OmaPilot's private loopback bridge.

    127 GitHub stars~179 tokensUpdated 1 mo ago
    Auto-check passed

Questions about Omapilot Desktop

What does Omapilot Desktop do?

Control installed apps, Hyprland windows, workspaces, monitors, and window sizing through OmaPilot's structured desktop tools. Omapilot Desktop is an agent skill from spencerbull/omarchy-omapilot. Control installed apps, Hyprland windows, workspaces, monitors, and window sizing through OmaPilot's structured desktop tools.

When should I use Omapilot Desktop?

Omapilot Desktop fits situations like: focus and for exact desktop arrangement requests.

How do I install Omapilot Desktop in Claude Code?

Run `npx skills add spencerbull/omarchy-omapilot --skill omapilot-desktop -a claude-code`. Or copy the skill folder (skills/omapilot-desktop in spencerbull/omarchy-omapilot) into .claude/skills/omapilot-desktop in your project. Claude Code loads it when a task matches its description.

How do I install Omapilot Desktop in Codex?

Run `npx skills add spencerbull/omarchy-omapilot --skill omapilot-desktop -a codex`. Or copy the skill folder (skills/omapilot-desktop in spencerbull/omarchy-omapilot) into .agents/skills/omapilot-desktop in your project. Codex loads it when a task matches its description.

Can I use Omapilot Desktop in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add spencerbull/omarchy-omapilot --skill omapilot-desktop -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/omapilot-desktop, .gemini/skills/omapilot-desktop, .github/skills/omapilot-desktop and .opencode/skills/omapilot-desktop in your project.

What does Omapilot Desktop need to run?

SKILL.md names no scripts, command-line tools or credentials: Omapilot Desktop is instructions for the agent only.

Does Omapilot Desktop access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Omapilot Desktop safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Omapilot Desktop use?

Omapilot Desktop is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Omapilot Desktop use?

About 966 tokens (SKILL.md is roughly 3.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Omapilot Desktop?

Skills that share tags, products or a category with Omapilot Desktop: Fedora Hyprland Installer (sickn33/agentic-awesome-skills, 47k stars), Generating Python Installer (affaan-m/ECC, 277k stars), Qdrant Monitoring (github/awesome-copilot, 40k stars) and Windows Desktop E2E (affaan-m/ECC, 277k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Omapilot Desktop?

spencerbull (a GitHub user) maintains it in spencerbull/omarchy-omapilot, which has 127 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on August 29, 2026.

Source: spencerbull/omarchy-omapilot on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.