# Send omarchy to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "omarchy",
    "name": "omarchy",
    "source": "tencent",
    "type": "skill",
    "category": "安全合规",
    "sourceUrl": "https://clawhub.ai/AchalS-iglu/omarchy",
    "canonicalUrl": "https://clawhub.ai/AchalS-iglu/omarchy",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/omarchy",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=omarchy",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "omarchy",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-29T20:00:44.656Z",
      "expiresAt": "2026-05-06T20:00:44.656Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=omarchy",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=omarchy",
        "contentDisposition": "attachment; filename=\"omarchy-0.1.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "omarchy"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/omarchy"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/omarchy",
    "downloadUrl": "https://openagent3.xyz/downloads/omarchy",
    "agentUrl": "https://openagent3.xyz/skills/omarchy/agent",
    "manifestUrl": "https://openagent3.xyz/skills/omarchy/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/omarchy/agent.md"
  }
}
```
## Documentation

### Omarchy Skill

Treat this skill as an Omarchy operating mode, not just a command catalog. When working on an Omarchy system, prefer Omarchy-native wrappers and workflows over generic Linux one-liners that may bypass expected state handling. Use local script docs and names to choose the correct path. Each script has documentation at the top describing its purpose. DO NOT RUN A SCRIPT UNTIL YOU ARE SURE OF ITS PURPOSE.

### Operating rules

Start with command name matching and in-file comments under /home/achals/.local/share/omarchy/bin.
Prefer read-only/status commands first (*list*, *status*, *current*, *available*, *version*).
Ask before broad or high-impact actions (*install*, *remove*, *reinstall*, *update*, *pkg*, *setup*, *set*).
Avoid bulk discovery execution. Do static inspection first.
Never assume omarchy-* scripts support standard CLI flags or parameters (including --help). Treat each script as custom; inspect its file/header comments first.

### Worked examples (good vs bad)

Use these patterns whenever you operate on Omarchy. The goal is not "run an omarchy command at all costs"; the goal is to avoid bypassing Omarchy’s intended state-management flows.

### 1) Restarting Waybar

User intent: "Waybar is broken, restart it."

Bad (generic shortcut):

pkill waybar && waybar


Good (Omarchy-native):

omarchy-restart-waybar


Why: Omarchy wrappers usually handle environment/session assumptions better than raw kill-and-relaunch one-liners.

### 2) Applying config/UI refresh after edits

User intent: "I changed config, apply it."

Bad:

restarting random processes manually until things look fixed


Good:

use targeted refresh script first, e.g. omarchy-refresh-waybar, omarchy-refresh-hyprland, omarchy-refresh-config (pick by component)


Why: refresh scripts are explicit and reversible; manual shotgun restarts are noisy and risky.

### 3) Package management task

User intent: "Install/remove package X."

Bad:

using raw pacman/yay first without checking Omarchy wrappers


Good:

inspect and prefer omarchy-pkg-* flow (...-present, ...-missing, then ...-install/...-remove)


Why: wrapper flow keeps behavior consistent with Omarchy expectations.

### 4) Theme change request

User intent: "Switch theme / sync theme to apps."

Bad:

editing dotfiles manually first and restarting random apps


Good:

omarchy-theme-list -> omarchy-theme-set -> app-specific follow-ups if needed (omarchy-theme-set-vscode, ...-browser, ...-obsidian)


Why: Omarchy theme pipeline may include extra integration steps beyond plain config edits.

### 5) Audio/Bluetooth/Wi‑Fi issue

User intent: "Audio/Bluetooth/Wi‑Fi stopped behaving."

Bad:

broad process killing (killall pipewire, random daemon restarts)


Good:

use targeted wrapper restarts such as omarchy-restart-pipewire, omarchy-restart-bluetooth, omarchy-restart-wifi


Why: targeted wrappers reduce collateral damage and match Omarchy’s service model.

### 6) "What command should I run?" discovery flow

User intent: ambiguous request like "fix my display stack".

Bad:

execute many commands to discover options (for c in omarchy-*; do $c --help; done)


Good:

Statically inspect names in /home/achals/.local/share/omarchy/bin
Read top-of-file script comments for likely candidates
Start with read-only/status scripts
Propose 1-3 likely commands and ask before high-impact actions


Why: static inspection is safer, faster, and follows no-bulk-probing policy.

### 7) Update workflow

User intent: "Update system."

Bad:

directly running full update steps without checking availability/state


Good:

check first: omarchy-update-available (and related status)
then execute appropriate Omarchy update path with confirmation for impactful steps


Why: staged update flow reduces surprise breakage.

### Decision template (apply every time)

For any Omarchy task, follow this mini-checklist:

Identify component (UI, package, theme, network, update, device, etc.)
Find matching omarchy-* family by name and script header comments
Prefer read-only/status command first
Use targeted omarchy-refresh-*/omarchy-restart-* over raw kill/relaunch
Ask before high-impact actions (install/remove/reinstall/update/setup/set)

### Omarchy command catalog (static, local)

Total commands: 161

### battery (2)

omarchy-battery-monitor
omarchy-battery-remaining

### branch (1)

omarchy-branch-set

### channel (1)

omarchy-channel-set

### cmd (12)

omarchy-cmd-apple-display-brightness
omarchy-cmd-audio-switch
omarchy-cmd-first-run
omarchy-cmd-missing
omarchy-cmd-present
omarchy-cmd-reboot
omarchy-cmd-screenrecord
omarchy-cmd-screensaver
omarchy-cmd-screenshot
omarchy-cmd-share
omarchy-cmd-shutdown
omarchy-cmd-terminal-cwd

### debug (1)

omarchy-debug

### dev (1)

omarchy-dev-add-migration

### drive (3)

omarchy-drive-info
omarchy-drive-select
omarchy-drive-set-password

### font (3)

omarchy-font-current
omarchy-font-list
omarchy-font-set

### hibernation (3)

omarchy-hibernation-available
omarchy-hibernation-remove
omarchy-hibernation-setup

### hook (1)

omarchy-hook

### hyprland (3)

omarchy-hyprland-window-close-all
omarchy-hyprland-window-pop
omarchy-hyprland-workspace-toggle-gaps

### install (9)

omarchy-install-chromium-google-account
omarchy-install-dev-env
omarchy-install-docker-dbs
omarchy-install-dropbox
omarchy-install-steam
omarchy-install-tailscale
omarchy-install-terminal
omarchy-install-vscode
omarchy-install-xbox-controllers

### launch (14)

omarchy-launch-about
omarchy-launch-audio
omarchy-launch-bluetooth
omarchy-launch-browser
omarchy-launch-editor
omarchy-launch-floating-terminal-with-presentation
omarchy-launch-or-focus
omarchy-launch-or-focus-tui
omarchy-launch-or-focus-webapp
omarchy-launch-screensaver
omarchy-launch-tui
omarchy-launch-walker
omarchy-launch-webapp
omarchy-launch-wifi

### lock (1)

omarchy-lock-screen

### menu (2)

omarchy-menu
omarchy-menu-keybindings

### migrate (1)

omarchy-migrate

### notification (1)

omarchy-notification-dismiss

### pkg (9)

omarchy-pkg-add
omarchy-pkg-aur-accessible
omarchy-pkg-aur-add
omarchy-pkg-aur-install
omarchy-pkg-drop
omarchy-pkg-install
omarchy-pkg-missing
omarchy-pkg-present
omarchy-pkg-remove

### powerprofiles (1)

omarchy-powerprofiles-list

### refresh (14)

omarchy-refresh-applications
omarchy-refresh-chromium
omarchy-refresh-config
omarchy-refresh-fastfetch
omarchy-refresh-hypridle
omarchy-refresh-hyprland
omarchy-refresh-hyprlock
omarchy-refresh-hyprsunset
omarchy-refresh-limine
omarchy-refresh-pacman
omarchy-refresh-plymouth
omarchy-refresh-swayosd
omarchy-refresh-walker
omarchy-refresh-waybar

### reinstall (4)

omarchy-reinstall
omarchy-reinstall-configs
omarchy-reinstall-git
omarchy-reinstall-pkgs

### remove (1)

omarchy-remove-dev-env

### reset (1)

omarchy-reset-sudo

### restart (15)

omarchy-restart-app
omarchy-restart-bluetooth
omarchy-restart-btop
omarchy-restart-hyprctl
omarchy-restart-hypridle
omarchy-restart-hyprsunset
omarchy-restart-mako
omarchy-restart-opencode
omarchy-restart-pipewire
omarchy-restart-swayosd
omarchy-restart-terminal
omarchy-restart-walker
omarchy-restart-waybar
omarchy-restart-wifi
omarchy-restart-xcompose

### setup (3)

omarchy-setup-dns
omarchy-setup-fido2
omarchy-setup-fingerprint

### show (2)

omarchy-show-done
omarchy-show-logo

### snapshot (1)

omarchy-snapshot

### state (1)

omarchy-state

### theme (13)

omarchy-theme-bg-install
omarchy-theme-bg-next
omarchy-theme-current
omarchy-theme-install
omarchy-theme-list
omarchy-theme-remove
omarchy-theme-set
omarchy-theme-set-browser
omarchy-theme-set-gnome
omarchy-theme-set-obsidian
omarchy-theme-set-templates
omarchy-theme-set-vscode
omarchy-theme-update

### toggle (5)

omarchy-toggle-idle
omarchy-toggle-nightlight
omarchy-toggle-screensaver
omarchy-toggle-suspend
omarchy-toggle-waybar

### tui (2)

omarchy-tui-install
omarchy-tui-remove

### tz (1)

omarchy-tz-select

### update (14)

omarchy-update
omarchy-update-analyze-logs
omarchy-update-available
omarchy-update-available-reset
omarchy-update-branch
omarchy-update-confirm
omarchy-update-firmware
omarchy-update-git
omarchy-update-keyring
omarchy-update-perform
omarchy-update-restart
omarchy-update-system-pkgs
omarchy-update-time
omarchy-update-without-idle

### upload (1)

omarchy-upload-log

### version (4)

omarchy-version
omarchy-version-branch
omarchy-version-channel
omarchy-version-pkgs

### voxtype (5)

omarchy-voxtype-config
omarchy-voxtype-install
omarchy-voxtype-model
omarchy-voxtype-remove
omarchy-voxtype-status

### webapp (4)

omarchy-webapp-handler-hey
omarchy-webapp-handler-zoom
omarchy-webapp-install
omarchy-webapp-remove

### windows (1)

omarchy-windows-vm
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: AchalS-iglu
- Version: 0.1.1
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-29T20:00:44.656Z
- Expires at: 2026-05-06T20:00:44.656Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/omarchy)
- [Send to Agent page](https://openagent3.xyz/skills/omarchy/agent)
- [JSON manifest](https://openagent3.xyz/skills/omarchy/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/omarchy/agent.md)
- [Download page](https://openagent3.xyz/downloads/omarchy)