omc-setup

Automate oh-my-claudecode configuration installation and refresh for Claude Code.

Updated May 20, 2026
One-click install
npx skills add https://github.com/xdkp/oh-my-claudecode --skill omc-setup-xdkp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: omc-setup
Source: https://github.com/xdkp/oh-my-claudecode/tree/main/skills/omc-setup
Command: npx skills add https://github.com/xdkp/oh-my-claudecode --skill omc-setup-xdkp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the hassle of installing and keeping oh-my-claudecode (OMC) correctly configured across plugin, npm, and local-dev environments, especially when users need to recover from partial or outdated setup.

Core Features & Use Cases

  • Single entrypoint setup wizard: Runs a multi-phase, end-to-end installation that prepares Claude Code configs for OMC.
  • Local and global configuration modes: Supports project-scoped (.claude) and all-project (~/.claude) configuration targets with backups and safe marker validation.
  • Environment readiness tasks: Configures HUD/statusline via the dedicated hud skill, clears stale plugin cache, sets default execution mode preferences, and optionally installs the standalone OMC CLI.
  • Optional integrations: Offers MCP server configuration and can enable experimental agent teams with safe merging of settings.json.
  • Resumable and interruption-tolerant: Persists setup progress after each phase and supports resuming or starting fresh.

Quick Start

Run the OMC setup wizard by invoking: /oh-my-claudecode:omc-setup

Frequently Asked Questions about omc-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure oh-my-claudecode for Claude Code across different environments?

You can configure oh-my-claudecode (OMC) across plugin, npm, and local-dev environments by running a single setup wizard. This guided flow automates multi-phase installation, applying configurations to both project-scoped and global targets.

Can I resume Claude Code configuration setup if the terminal crashes midway?

Yes, the Claude Code configuration setup is resumable and interruption-tolerant. It persists your progress after each phase via a dedicated script, allowing you to resume from where you left off or start fresh.

How does safe CLAUDE.md marker validation work during MCP server setup?

Safe CLAUDE.md marker validation checks existing configuration files before applying new settings, preventing overwrites. It ensures MCP server setup and agent team defaults merge safely into your existing settings.json without losing data.

Does the oh-my-claudecode setup wizard support project-scoped and global configurations?

Yes, the oh-my-claudecode setup wizard supports both project-scoped (.claude) and global (~/.claude) configuration modes. It applies settings to your chosen target while creating backups and validating safe markers.

What is the best way to install OMC CLI and configure the HUD statusline?

The best way to install the OMC CLI and configure the HUD statusline is through the integrated setup wizard. It handles environment readiness tasks like clearing stale plugin cache and delegates HUD configuration to a dedicated skill.

Why is my oh-my-claudecode plugin configuration outdated after an update?

Your oh-my-claudecode plugin configuration may be outdated due to stale plugin cache or partial setup failures. Running the setup wizard refreshes configurations, clears caches, and safely updates your CLAUDE.md files.