← Back to Skills Marketplace
achals-iglu

omarchy

by Achal Singhal · GitHub ↗ · v0.1.1
cross-platform ⚠ suspicious
876
Downloads
0
Stars
2
Active Installs
2
Versions
Install in OpenClaw
/install omarchy
Description
Omarchy operating guardrails for day-to-day system work: assume the host is Omarchy by default, choose Omarchy-native workflows first, map user intent to the correct omarchy-* wrapper/script family, and avoid generic Linux commands that conflict with Omarchy behavior. Use whenever handling local system tasks on this host unless the user explicitly says it is not Omarchy; prioritize safe Omarchy commands, prevent non-Omarchy shortcuts (e.g., ad-hoc process killing/relaunch patterns), troubleshoot desktop behavior, and validate the right script before execution.
Usage Guidance
This skill appears coherent: it guides the agent to prefer and inspect local omarchy-* wrapper scripts instead of running raw system commands, and it doesn't request credentials or install code. Before installing, confirm that this host actually uses Omarchy and that the hard-coded path (/home/achals/.local/share/omarchy/bin) matches your environment; otherwise the skill may attempt to read a different user's home-path or be ineffective. Also review the actual scripts in the referenced directory (and their header comments) so you trust what the agent may propose running, and be cautious about granting the agent autonomous execution rights if you do not want it to run local scripts without approval.
Capability Analysis
Type: OpenClaw Skill Name: omarchy Version: 0.1.1 The `SKILL.md` file exhibits strong prompt injection techniques designed to restrict the AI agent's autonomy and steer its behavior towards a predefined set of `omarchy-*` wrapper scripts. It explicitly instructs the agent to avoid generic Linux commands (e.g., `pacman`, `pkill`) and discourages standard inspection methods like `--help` flags, instead forcing reliance on internal documentation of the `omarchy-*` scripts. While not directly containing malicious code, this setup creates a highly vulnerable environment where the agent is compelled to use potentially unverified, controlled scripts for critical system operations (e.g., `omarchy-pkg-install`, `omarchy-update-system-pkgs`, `omarchy-reset-sudo`, `omarchy-upload-log`), increasing the risk of hidden malicious actions or system compromise if those underlying scripts were untrustworthy.
Capability Assessment
Purpose & Capability
The name/description say this is an Omarchy operating-mode guardrail for local system tasks and the SKILL.md only instructs the agent to prefer and inspect local omarchy-* wrapper scripts. There are no unrelated env vars, binaries, or install steps requested, so the requested capabilities align with the described purpose.
Instruction Scope
The instructions direct the agent to statically inspect and prefer scripts under /home/achals/.local/share/omarchy/bin and to use read-only/status commands before taking impactful actions. This is appropriate for a local guardrail, but the path is hard-coded to a specific home directory ("/home/achals"), which may not match other hosts and could cause the agent to read a user's home files. The SKILL.md explicitly warns not to run scripts until sure, and discourages bulk probing, which reduces risk.
Install Mechanism
No install specification or code is included (instruction-only). That minimizes disk-write/execution risk and is proportional for a guidance/guardrail skill.
Credentials
The skill requests no environment variables, credentials, or config paths. Its instructions only reference a local script directory relevant to the stated purpose, so the level of access requested is proportionate.
Persistence & Privilege
The skill is not marked always:true and does not request persistent system changes or modify other skills. Autonomous invocation is allowed by platform default, but that is not excessive given the skill's benign, local-scope purpose.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install omarchy
  3. After installation, invoke the skill by name or use /omarchy
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.1
- Updated the description to clarify: assume the host is Omarchy by default unless the user states otherwise. - Strengthened guidance to use Omarchy-native workflows for all local system tasks, not just when explicitly told so. - No changes to commands, documentation structure, or operating rules. - No file or command modifications detected in this release.
v0.1.0
Omarchy Skill 0.1.0 – Initial Release - Introduces Omarchy operating guardrails to guide day-to-day system operations on Omarchy machines. - Guides users to prefer Omarchy-native workflows and wrapper scripts over generic Linux commands to maintain system integrity. - Provides detailed decision templates and worked examples contrasting good (Omarchy) vs. bad (generic/uncontrolled) approaches across common tasks. - Supplies a static catalog of 161 Omarchy commands/scripts grouped by function, with advice for safe discovery and use. - Emphasizes manual inspection of script docs/comments and avoidance of bulk execution or generic shortcuts.
Metadata
Slug omarchy
Version 0.1.1
License
All-time Installs 2
Active Installs 2
Total Versions 2
Frequently Asked Questions

What is omarchy?

Omarchy operating guardrails for day-to-day system work: assume the host is Omarchy by default, choose Omarchy-native workflows first, map user intent to the correct omarchy-* wrapper/script family, and avoid generic Linux commands that conflict with Omarchy behavior. Use whenever handling local system tasks on this host unless the user explicitly says it is not Omarchy; prioritize safe Omarchy commands, prevent non-Omarchy shortcuts (e.g., ad-hoc process killing/relaunch patterns), troubleshoot desktop behavior, and validate the right script before execution. It is an AI Agent Skill for Claude Code / OpenClaw, with 876 downloads so far.

How do I install omarchy?

Run "/install omarchy" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is omarchy free?

Yes, omarchy is completely free (open-source). You can download, install and use it at no cost.

Which platforms does omarchy support?

omarchy is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created omarchy?

It is built and maintained by Achal Singhal (@achals-iglu); the current version is v0.1.1.

💬 Comments