MCPInstall

omc-review

Evaluate finished work for defects, risk, and simplification before it ships

Installs
244
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/yeachan-heo/oh-my-claudecode --skill omc-review
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads omc-review automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Review

Use this skill to evaluate work that already exists. Review never authors the change it is judging.

This is the canonical review workflow. ai-slop-cleaner is an opt-in lane within it.

Goal

Find what is actually wrong, ranked by severity, with enough detail to act on.

Workflow

  1. Establish what changed and what it was meant to do.
  2. Read the change against that intent.
  3. Check correctness first, then risk, then simplification.
  4. Verify each candidate finding before reporting it.
  5. Report findings most-severe first.

What to check

  • Correctness — logic defects, edge cases, error paths, concurrency
  • Risk — security boundaries, destructive operations, data integrity
  • Reuse — existing utilities or patterns the change should have used
  • Simplification — code that could be deleted or collapsed
  • Coverage — behavior that ships untested

Two axes, run apart

A substantial diff is reviewed as two parallel sub-agent passes, reported separately — never merged or cross-ranked, because a change can pass one axis and fail the other (standards-conforming but wrong behavior; faithful but convention-breaking):

  • Standards axis — the diff against the repo's documented standards plus a judgement-call-only smell baseline; anything tooling already enforces is skipped. The standards set is discovered, not assumed: search the repo for standards documents (CLAUDE.md/AGENTS.md, docs/standards/ volumes, CONTRIBUTING.md, CODING_STANDARDS.md or equivalents) and review against whatever exists — a standards file you didn't look for is a standard you didn't apply.
  • Intent axis — the diff against what the work was meant to do — the task, spec, or ticket acceptance criteria: requirements missing or partial, behavior nobody asked for, each finding quoting its source line.

Keep each sub-agent brief under ~400 words and pointed at one axis. Aggregate without picking a single winner across axes — that reranking is what the separation exists to prevent; state each axis's verdict on its own. A small diff stays one pass.

Rules

  • Separate lanes: the reviewer must not be the author's same active context.
  • Verify before reporting. A plausible-sounding finding that does not reproduce is noise.
  • State severity honestly; do not pad the list to look thorough.
  • "No findings" is a valid result when the work is sound.
  • Advisory by default — review informs, it does not gate. Hard gates (release, security, destructive operations) stay separate and fail closed.

Output

  • Findings, most-severe first, each with file, line, and concrete failure scenario
  • What was checked and found clean
  • Anything that could not be assessed

FAQ

What does the omc-review skill do?

Evaluate finished work for defects, risk, and simplification before it ships

How do I install omc-review?

Run npx skills add https://github.com/yeachan-heo/oh-my-claudecode --skill omc-review in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/omc-review/ (personal) or .claude/skills/omc-review/ (project).

Which AI agents can use omc-review?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is omc-review safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains omc-review?

It is published by yeachan-heo in yeachan-heo/oh-my-claudecode. It has 244 recorded installs.

More from yeachan-heo/oh-my-claudecode

View all →

ai-slop-cleaner

yeachan-heo/oh-my-claudecode

Clean AI-generated code slop with a regression-safe, deletion-first workflow and optional reviewer-only mode

Testing & QA1.6K installs

ralplan

yeachan-heo/oh-my-claudecode

Consensus planning entrypoint that auto-gates vague ralph/autopilot/team requests before execution

hud

yeachan-heo/oh-my-claudecode

Configure HUD display options (layout, presets, display elements)

Frontend & Design1.1K installs

deepinit

yeachan-heo/oh-my-claudecode

Deep codebase initialization with hierarchical AGENTS.md documentation

autopilot

yeachan-heo/oh-my-claudecode

Full autonomous execution from idea to working code

1K installs

deep-interview

yeachan-heo/oh-my-claudecode

Socratic deep interview with mathematical ambiguity gating before explicit execution approval

1K installs

Popular code quality & workflow skills

View category →

grill-me

mattpocock/skills

A relentless interview to sharpen a plan or design.

Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.

handoff

mattpocock/skills

Compact the current conversation into a handoff document for another agent to pick up.

domain-modeling

mattpocock/skills

Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a GLOSSARY.md, or recording or editing an ADR.

codebase-design

mattpocock/skills

Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.

diagnosing-bugs

mattpocock/skills

Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.