Guide · Agent skill

How to use the OMC Setup Wizard agent skill (omc-setup)

Updated 2026-10-29 · written with AI from the project's own documentation and checked against our catalogue data

omc-setup is an agent skill that walks an AI coding agent through installing or refreshing oh-my-claudecode, an add-on toolkit for Claude Code. It is aimed at developers who already have Claude Code and the oh-my-claudecode plugin set up and need it configured or upgraded. After reading this guide you will know what the skill changes, how to install it, how to trigger it with plain requests, and what it needs to run safely.

OMC Setup WizardYeachan-Heo/oh-my-claudecode · MIT Download the skill

Quick start

1Confirm prerequisites. Make sure Claude Code, the oh-my-claudecode plugin, a bash shell and jq are available. Add npm if you installed via npm.
2Download and unzip the skill. Download the omc-setup ZIP from the directory page and unzip it to get the skill folder.
3Place the skill folder. Copy it to ~/.claude/skills/ for all projects, or to .claude/skills/ in one project. In the Claude apps, upload it under Settings → Capabilities → Skills.
4Pick a target. Decide whether to configure a single project (--local) or global settings (--global), and whether to overwrite or preserve your global CLAUDE.md.
5Run the setup request. Ask the agent in plain words or run /oh-my-claudecode:omc-setup with the flag you chose.
6Answer the prompts. Respond to the questions about CLAUDE.md, HUD statusline, update checks and team mode defaults as they appear.
7Repeat after upgrades. Run the skill again after upgrading oh-my-claudecode so CLAUDE.md is refreshed and retired settings are cleared.

What the omc-setup skill makes the agent do

An agent skill is a folder containing a SKILL.md instruction file and supporting files that an AI agent reads and follows when a task matches. The omc-setup skill guides the agent through setting up oh-my-claudecode for plugin, npm, and local-development installs.

The skill is meant to run once after you install the plugin and again after upgrades. Its workflow covers updating your CLAUDE.md instruction file, setting up a HUD statusline, checking for updates, clearing retired setup values, and configuring team mode defaults (agent count, type, and model).

Configures CLAUDE.md either for one project (.claude/CLAUDE.md) or globally (~/.claude/CLAUDE.md)
Sets up the HUD statusline
Checks for updates
Clears retired setup values and points MCP registration at Claude Code's native config
Configures team mode defaults

Install the omc-setup skill from the ZIP

Download the ZIP for this skill from the directory page and unzip it. Place the skill folder in one of two locations depending on how you want it available.

For all of your projects, put it in ~/.claude/skills/. For a single project, put it in that project's .claude/skills/ folder. If you use the Claude apps instead, upload the skill under Settings → Capabilities → Skills.

Personal (all projects): ~/.claude/skills/
Single project: .claude/skills/ inside the project folder
Claude apps: Settings → Capabilities → Skills, then upload

Know the requirements before you start

The skill assumes the plugin is already installed. It will not teach you the basics of Claude Code or oh-my-claudecode. Check these requirements first.

Claude Code with the oh-my-claudecode plugin installed
A bash shell
jq, which is required to read existing setup state
npm, only needed for npm-based installs

Trigger the skill with natural requests or flags

The skill's instructions say to run the workflow immediately when invoked. The source documents these slash-command forms, which you can use directly or describe in plain words to the agent.

Without flags, the skill runs a pre-setup check and then the full setup if needed. If setup is already complete, it offers to update CLAUDE.md and clear retired values, run the full setup again, or cancel.

/oh-my-claudecode:omc-setup: first-time setup, or update if already configured
/oh-my-claudecode:omc-setup --local: configure the current project (.claude/CLAUDE.md)
/oh-my-claudecode:omc-setup --global: configure global settings (~/.claude/CLAUDE.md)
/oh-my-claudecode:omc-setup --force: run the full wizard even if already configured
/oh-my-claudecode:omc-setup --help: show help and stop
Plain requests such as "refresh my oh-my-claudecode setup after upgrading" or "set up oh-my-claudecode for this project only"

/oh-my-claudecode:omc-setup --local

Choose overwrite or preserve mode for global setup

The default global mode explicitly overwrites ~/.claude/CLAUDE.md so that plain claude also uses OMC. If you want to keep your own base CLAUDE.md, choose preserve mode. It keeps your base file and installs OMC into CLAUDE-omc.md, which is used when you launch with omc.

Global configuration applies to all Claude Code sessions. Local mode only changes the project you run it in, so it is the safer choice if you do not want your global file replaced.

Default global: overwrites ~/.claude/CLAUDE.md
Preserve mode: keeps your CLAUDE.md and writes CLAUDE-omc.md
Local mode: writes .claude/CLAUDE.md in the current project

Safety notes: scripts and network access

This skill runs scripts and uses the network. Its CLAUDE.md changes are made through scripts/setup-claude-md.sh, which the source describes as the only coordinator allowed to change CLAUDE.md. The script validates the coordinator's response and exit status, and reports byte-identical backups only for files it had to change.

The skill also preserves same-named legacy hook files unless their exact historical contents are independently verified. If the jq check fails, the source says existing config is not modified. Read the flags above before running the skill against your global file.

Runs scripts: yes (including scripts/setup-claude-md.sh)
Uses network: yes
Global overwrite replaces ~/.claude/CLAUDE.md by default; use preserve or local mode to avoid that

Tips for a clean setup and upgrade

Run the skill once after installing the plugin, and again after each oh-my-claudecode upgrade, so your CLAUDE.md stays current. For a project that needs its own settings, use --local rather than changing your global file.

If you have a previous setup session in progress, the skill will ask whether to resume or start fresh. Starting fresh clears saved setup state.

Use --local to update one project after an upgrade
Use --global only when you want the change everywhere, and prefer preserve mode if you have a custom base CLAUDE.md
Use --force only when you want to reconfigure preferences from scratch
Read the help text with --help before running an unfamiliar flag

What people use it for

Setting up oh-my-claudecode for the first time after installing the plugin from the marketplace
Refreshing CLAUDE.md in one project after upgrading oh-my-claudecode
Updating global config for all Claude Code sessions while keeping a custom base CLAUDE.md in preserve mode
Reconfiguring team mode defaults for agent count, type and model with --force
Repairing an install from a local checkout after updating the repo and rerunning setup

Frequently asked questions

What is the omc-setup skill?

It is an agent skill that guides an AI coding agent through installing or refreshing oh-my-claudecode, an add-on toolkit for Claude Code. It updates CLAUDE.md, sets up a HUD statusline, checks for updates and configures team mode defaults.

What do I need to run omc-setup?

You need Claude Code with the oh-my-claudecode plugin installed, a bash shell and jq. npm is only needed for npm-based installs. The skill assumes the plugin is already installed.

Is omc-setup free?

The source material for this listing does not state pricing or licence terms beyond the MIT licence shown on the item. Check the repository at the project's GitHub page for its licence details.

Where do I install the skill?

Unzip the downloaded ZIP into ~/.claude/skills/ to use it across projects, or into a project's .claude/skills/ folder for one project. In the Claude apps, upload it under Settings → Capabilities → Skills.

Will omc-setup overwrite my CLAUDE.md?

By default, global mode explicitly overwrites ~/.claude/CLAUDE.md. To keep your base file, choose preserve mode, which installs OMC into CLAUDE-omc.md, or use local mode, which only changes the current project.

What should I do if the skill says jq is missing?

Install jq so the skill can read existing setup state. The source says that without jq the skill stops and does not modify your existing config.

How does omc-setup compare to running the plugin install alone?

The plugin install adds oh-my-claudecode itself. This skill is the configuration step that follows, setting up CLAUDE.md, the HUD statusline and team defaults, and repeating that work after upgrades.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

Use omc-setup if you already run Claude Code with oh-my-claudecode and want it configured for a project or globally, or refreshed after an upgrade. Skip it if you are new to Claude Code or do not want your global CLAUDE.md replaced, and choose local or preserve mode instead.

Download the skill