omarchy

majiayu000's avatarfrom majiayu000

Expert guide for Omarchy Linux system management. Use when user asks about Omarchy commands, updates, migrations, configuration, or how Omarchy works. Inspects the local Omarchy installation at ~/.local/share/omarchy to provide accurate answers.

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 5, 2026
[IT Helpdesk and Runbooks]

When & Why to Use This Skill

The Omarchy skill serves as an advanced AI expert guide for Omarchy Linux system management and IT automation. It streamlines technical support by inspecting local installations, analyzing shell scripts, and providing precise guidance on system updates, migrations, and configuration. By bridging the gap between source code and user queries, it acts as an automated runbook for maintaining system integrity and optimizing Linux environments.

Use Cases

  • System Update & Maintenance: Guide users through the 'omarchy-update' process by analyzing local scripts to ensure safe and efficient system-wide package updates.
  • Migration Management: Inspect timestamped migration files in the local directory to help users understand their installation history and execute new system migrations correctly.
  • Command Discovery & Documentation: Automatically list and explain available 'omarchy-*' commands by reading source code directly from the local bin directory, providing real-time technical documentation.
  • Configuration & Customization: Analyze files within ~/.config/omarchy to provide tailored advice on modifying system themes, hooks, and environment settings.
  • Troubleshooting & Debugging: Use Grep and Bash tools to search through local system logs and scripts to identify and resolve configuration conflicts or execution errors.
nameomarchy
descriptionExpert guide for Omarchy Linux system management. Use when user asks about Omarchy commands, updates, migrations, configuration, or how Omarchy works. Inspects the local Omarchy installation at ~/.local/share/omarchy to provide accurate answers.

Omarchy Expert Guide

Purpose

This skill helps users understand and work with their Omarchy Linux installation by inspecting the actual Omarchy codebase installed at ~/.local/share/omarchy.

Instructions

When a user asks about Omarchy:

  1. Locate the Installation

    • Main installation: ~/.local/share/omarchy/
    • Configuration: ~/.config/omarchy/
    • State files: ~/.local/state/omarchy/

  2. Understand Their Question

    • Identify if they're asking about:
      • Commands/scripts (check ~/.local/share/omarchy/bin/)
      • Migrations (check ~/.local/share/omarchy/migrations/)
      • Configuration (check ~/.config/omarchy/)
      • Updates and system management
      • Themes, hooks, or customization

  3. Inspect the Source

    • Read relevant scripts in ~/.local/share/omarchy/bin/ to understand functionality
    • Check migration files to understand installation history
    • Look at configuration files to understand current setup
    • Examine the actual code to provide accurate, specific answers
    • Check the official Omarchy documentation:

  4. Provide Specific Guidance

    • Show actual commands from the Omarchy installation
    • Explain what the scripts do by reading their source
    • Reference specific file paths: ~/.local/share/omarchy/bin/command-name
    • Provide examples based on the user's actual setup

  5. Common Tasks to Help With

    • Updates: Explain omarchy-update and what it does
    • Migrations: Show how to create and run migrations
    • Commands: List and explain available omarchy-* commands
    • Package management: How Omarchy handles system packages
    • Customization: Themes, hooks, and configuration

Available Tools

Use these tools to inspect the Omarchy installation:

  • Read - Read Omarchy scripts and configuration files
  • Grep - Search for patterns in Omarchy code
  • Glob - Find Omarchy files matching patterns
  • Bash - List directories, check commands
  • WebFetch - Fetch official documentation from omarchy.org when needed

Examples

Example 1: User asks "How do I update with Omarchy?"

  1. Read ~/.local/share/omarchy/bin/omarchy-update
  2. Read ~/.local/share/omarchy/bin/omarchy-update-system-pkgs
  3. Explain the update process step-by-step
  4. Show the command: omarchy-update

Example 2: User asks "What Omarchy commands are available?"

  1. List files in ~/.local/share/omarchy/bin/
  2. Identify omarchy-* commands
  3. Group by category (update, install, theme, etc.)
  4. Offer to explain specific commands

Example 3: User asks "How do migrations work in Omarchy?"

  1. Check ~/.local/share/omarchy/migrations/ for migration files
  2. Read the migration runner script
  3. Explain the timestamp-based system
  4. Show user's existing migrations

Important Notes

  • Always inspect the actual installation - don't assume how Omarchy works
  • Omarchy is installed system-wide at ~/.local/share/omarchy/
  • Commands are in bin/, migrations are timestamped shell scripts
  • The system uses pacman/yay for package management
  • Read the source code to give accurate answers