omc-setup

Install or refresh oh-my-claudecode across local, global, plugin, npm deployments.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, node, npm, gh, and includes scripts (resource) components.

What problem does it solve?

This Skill removes the friction of installing, refreshing, and repairing oh-my-claudecode across local, global, plugin, and npm-based setups. It centralizes the setup flow so users do not need to manually piece together CLAUDE.md, HUD, task tools, MCP servers, or team settings.

Core Features & Use Cases

  • Canonical CLAUDE.md installation: Downloads and verifies the correct project or global CLAUDE.md with backup and marker validation.
  • Environment and workflow configuration: Sets up HUD statusline, optional task tools, default execution mode, and optional agent teams while preserving existing settings.
  • Integration and recovery support: Handles plugin verification, MCP server setup, progress resume, update detection, and completion messaging for new users and upgrades.
  • Use Case: A user upgrades OMC and wants their project config refreshed without rerunning every step, while keeping existing preferences intact.

Quick Start

Use the omc-setup skill to install or refresh OMC for my current project and guide me through the safest recommended setup path.

Frequently Asked Questions about omc-setup

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

FAQPage Schema
How do I set up oh-my-claudecode for my project without losing existing settings?

To set up oh-my-claudecode without losing settings, use a guided setup flow that merges settings.json, configures HUD and MCP servers, and preserves existing preferences through backup handling and marker validation.

What does the CLAUDE.md configuration process involve for local and global deployments?

The CLAUDE.md configuration process involves downloading and verifying the correct project or global file, applying marker validation, and creating backups to ensure safe installation or refresh across local and global deployments.

Do I need jq and node installed to configure MCP servers and HUD with omc?

Yes, you need jq, node, npm, and gh installed as dependencies to execute the scripted setup phases that configure MCP servers, HUD statusline, and task tooling.

Can I refresh an upgraded oh-my-claudecode setup without rerunning every configuration step?

Yes, you can refresh an upgraded setup incrementally by using progress persistence and resume capabilities, which detect existing installed states and only apply the necessary update phases without rerunning the entire flow.

What is the best way to repair a broken oh-my-claudecode plugin and agent team setup?

The best way to repair a broken setup is to run an integrated recovery flow that handles plugin verification, MCP server setup, and agent team configuration while validating the installed state and restoring missing components.