| name | omc-tips |
| description | This skill should be used when the user asks about "omc", "oh-my-claudecode", "omc 사용법", "omc 활용", "omc guide", "omc tips", "omc cheatsheet", "omc reference", "omc 모드", "omc 에이전트", "omc 스킬", "which omc mode", "how to use omc", "omc keyword", "omc 매직 키워드", "omc commands", "omc modes comparison", "autopilot vs ralph", "autopilot vs team", "ralph vs ultrawork", "team mode", "omc agent", "omc tool", "omc 설정", "omc setup", "omc doctor", "omc pipeline", "omc architecture", or needs guidance on choosing OMC execution modes, agents, skills, or strategies. Provides a comprehensive quick-reference for oh-my-claudecode v4.10+ plugin.
|
| version | 0.2.0 |
OMC Tips — oh-my-claudecode Quick Reference
oh-my-claudecode (OMC) is a multi-agent orchestration plugin for Claude Code.
It turns Claude Code into a platform of dozens of specialized agents, skills,
and lifecycle hooks — all driven by natural-language magic keywords.
Counts move with OMC versions. Don't rely on hard numbers in this guide;
run omc list-agents, omc list-skills, and omc list-hooks (or omc inventory
if available) to see the live registry for your installed version.
Reference shape last reviewed against OMC v4.12.x — verify any specifics
against your version before quoting them.
Architecture at a Glance
autopilot (5-stage pipeline: idea → working code)
└── ralph (persistence loop — keeps going until verified)
└── ultrawork (parallel agent execution engine)
└── agents (specialists across 3 model tiers — see `omc list-agents`)
Core flow: User Input → Hooks (event detection) → Skills (behavior injection) → Agents (task execution) → State (progress tracking)
Planning pipeline: deep-interview → ralplan/plan → autopilot
Investigation pipeline: deep-dive → trace + deep-interview → plan → autopilot
Mode Selection — Decision Tree
Is the task vague/unclear?
├─ Yes → deep-interview (then autopilot)
└─ No → Complex multi-step project?
├─ Yes → Multiple independent components?
│ ├─ Yes → team (coordinated pipeline)
│ └─ No → autopilot (single-lead autonomous)
└─ No → Is it a bug?
├─ Yes → Cause unclear?
│ ├─ Yes → deep-dive or trace
│ └─ No → ralph (persist until fixed)
└─ No → Parallelizable?
├─ Yes → ulw (ultrawork)
└─ No → Just describe the task normally
| Mode | What It Does | When To Use |
|---|
| autopilot | 5-stage pipeline (Expansion→Planning→Execution→QA→Validation) | Single coherent deliverable |
| team | 3-5 parallel agents with file ownership | 3+ independent subtasks |
| ralph | Verification loop — repeats until done | Completion guarantee needed |
| ultrawork (ulw) | Maximum parallelism + manual oversight | Speed with control |
| ccg | Claude+Codex+Gemini tri-model synthesis | Multi-perspective validation |
| ralplan | Planner→Architect→Critic consensus loop | Unclear requirements |
| deep-interview | Socratic requirements clarification | Vague starting point |
Invalid combos: Two standalone modes together (e.g., autopilot team) — the second keyword is silently ignored. eco is a modifier only — pair it with autopilot/ralph/ultrawork.
Magic Keywords — Natural Language Triggers
Include these anywhere in a prompt to activate the corresponding mode:
| Keyword | Activates | Example |
|---|
autopilot, build me | Full autonomous pipeline | "autopilot: build a REST API" |
ralph, must complete | Persistence loop | "ralph: fix the auth bug completely" |
ulw, ultrawork | Parallel execution | "ulw refactor the API layer" |
team | Coordinated agents | /team 3:executor fix errors |
ccg | Tri-model synthesis | "ccg: GraphQL vs REST?" |
ralplan | Consensus planning | "ralplan this feature" |
deep-interview | Socratic questioning | "deep-interview: build a dashboard" |
deslop | AI slop cleaner | "deslop the recent changes" |
deepsearch | Codebase search | "deepsearch: where is auth?" |
ultrathink | Deep reasoning | "ultrathink: why is this deadlocking?" |
cancelomc | Stop active mode | "cancelomc" |
Priority: cancel (exclusive) → ralph → autopilot → ultrawork → others
Agents — 19 Specialists in 3 Tiers
| Tier | Model | Agents |
|---|
| Opus (deep) | opus | analyst, planner, architect, critic, code-reviewer, code-simplifier |
| Sonnet (standard) | sonnet | executor, debugger, verifier, tracer, test-engineer, designer, qa-tester, scientist, document-specialist, git-master, security-reviewer |
| Haiku (fast) | haiku | explore, writer |
Typical sequence: explore → analyst → planner → critic → executor → verifier
Some agents have tier variants (e.g., architect-low, executor-high, security-reviewer-low). Override model via model parameter in Agent tool calls: model: "opus" on executor for complex tasks. See references/detailed-reference.md for full tier variant list.
For detailed agent capabilities, tool assignments, and lane descriptions, consult references/detailed-reference.md.
Key Skills Quick Reference
Execution & Orchestration
| Skill | Command | Notes |
|---|
| autopilot | /oh-my-claudecode:autopilot | 5-stage autonomous pipeline |
| ralph | /oh-my-claudecode:ralph | Loop until verified. Includes ultrawork. |
| ultrawork | /oh-my-claudecode:ultrawork | Max parallel agents |
| team | /oh-my-claudecode:team N:type "task" | N agents, types: executor/debugger/designer/codex/gemini |
| ultraqa | /oh-my-claudecode:ultraqa | QA cycle: test→verify→fix→repeat |
| cancel | /oh-my-claudecode:cancel | Stop any active mode |
Planning & Analysis
| Skill | Command |
|---|
| plan | /oh-my-claudecode:plan |
| ralplan | /oh-my-claudecode:ralplan |
| deep-interview | /oh-my-claudecode:deep-interview |
| deep-dive | /oh-my-claudecode:deep-dive |
| trace | /oh-my-claudecode:trace |
Multi-Model & Research
| Skill | Command |
|---|
| ccg | /oh-my-claudecode:ccg |
| ask | /oh-my-claudecode:ask — route to claude/codex/gemini |
| omc-teams | /oh-my-claudecode:omc-teams — tmux CLI workers |
| sciomc | /oh-my-claudecode:sciomc — parallel scientist agents |
| external-context | /oh-my-claudecode:external-context — web doc lookup |
Code Quality & Knowledge
| Skill | Command |
|---|
| ai-slop-cleaner | /oh-my-claudecode:ai-slop-cleaner |
| visual-verdict | /oh-my-claudecode:visual-verdict |
| deepinit | /oh-my-claudecode:deepinit — generate AGENTS.md across codebase |
| verify | /oh-my-claudecode:verify |
| self-improve | /oh-my-claudecode:self-improve |
Setup & Admin
| Skill | Command |
|---|
| omc-setup | /oh-my-claudecode:omc-setup |
| omc-doctor | /oh-my-claudecode:omc-doctor |
| hud | /oh-my-claudecode:hud — statusline: minimal/focused/full |
| mcp-setup | /oh-my-claudecode:mcp-setup |
Practical Examples
| Scenario | Command |
|---|
| Vague idea → code | deep-interview "real-time dashboard for metrics" |
| Fix all errors | /team 3:executor "fix all TS errors in src/" |
| Large refactoring | ulw refactor user API into service/controller/repo |
| Mystery bug | deep-dive "intermittent 403 on /api/orders" |
| Must-complete task | ralph: migrate raw SQL to repository pattern |
| Multi-AI opinion | ccg: should we use GraphQL or REST? |
| Security review | review payment module for security issues |
| Clean AI slop | deslop the recently modified files |
| Feature planning | ralplan: implement OAuth2 with PKCE |
| Map new codebase | /oh-my-claudecode:deepinit |
State & Memory
| Path | Purpose | Survives Compaction? |
|---|
.omc/state/ | Per-mode state | Yes |
.omc/notepad.md | Working memory | Yes |
.omc/project-memory.json | Project knowledge | Yes (permanent) |
.omc/plans/ | Execution plans | Yes |
.omc/skills/ | Project-level custom skills | N/A |
Memory tags: <remember> (7 days), <remember priority> (permanent)
Environment Variables
| Variable | Purpose | Default |
|---|
DISABLE_OMC | Disable all hooks | — |
OMC_SKIP_HOOKS | Skip specific hooks (comma-separated) | — |
OMC_STATE_DIR | Centralized state directory | .omc/state/ |
OMC_PARALLEL_EXECUTION | Toggle parallel execution | true |
OMC_LSP_TIMEOUT_MS | LSP request timeout | 15000 |
CLI Helpers
omc ask claude/codex/gemini "prompt"
omc team N:type "task"
omc team status
omc team shutdown <name> --force
omc hud
omc wait --start
omc session search "query" --since 7d
Additional Resources
For in-depth details on architecture, hooks, MCP tools, verification tiers, team pipelines, and cost optimization strategies, consult:
references/detailed-reference.md — Complete architecture, hooks system, MCP tools, verification protocol, team mode details, and advanced strategies
