Skip to main content
skill CX Codex

om-harness — Claude Code skill: what it does, how to install

om-harness — a skill for Claude Code delivers an internal runtime for isolated task workers, deterministic evidence validation, and multi-model review councils.

MIT 504 installs ★ 282 updated 2026-10-22

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add open-mercato/skills --skill om-harness -a claude-code
Open on GitHub

What om-harness does

The engine runs underlying operations for staged-only code tasks without directly committing to the repository. Driven by node scripts/harness.mjs, it claims bounded work packets, runs worker processes with isolated worktrees, and schedules independent review passes across Codex, DeepSeek, Kimi, GLM, and MiMo. Minority findings are strictly preserved rather than dismissed by majority vote.

Delivery mode is locked to stage-only, blocking automated commits, pushes, and pull request creation. Prevention hooks like block-push-and-pr.sh guard the Git boundary, while freeze-tests.sh halts test alterations when .om-freeze-tests is present. All run outcomes rely on structured JSON artifacts instead of generated conversational claims.

Node.js is mandatory to execute runtime scripts. The skill is an internal component meant to be invoked through om-fix-issue, om-implement-feature, or om-setup-agent-harness rather than run directly by hand on unverified task branches.

What it helps with

  • coordinate independent multi-model review councils
  • prevent automated agent commits, pushes, and PR actions
  • capture deterministic test validation in structured JSON
  • isolate worker environments without network access

Example prompts for the agent

  • Initialize agent execution rules using om-setup-agent-harness in this repo
  • Inspect profile execution with om-harness resolve-profile --config ./harness.json --profile high-assurance
  • Resolve bug report #142 through om-fix-issue using the staged pipeline

How to install om-harness

1Skills CLI (Vercel)

npx skills add open-mercato/skills --skill om-harness -a claude-code

2Manually: put the files in place

~/.claude/skills/om-harness/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/om-harness/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about om-harness

How to install om-harness in Claude Code?

Run npx skills add open-mercato/skills --skill om-harness -a claude-code. The skill file is placed at ~/.claude/skills/om-harness/SKILL.md.

What does om-harness do?

It coordinates internal worker runtimes, enforces isolated worktrees with disabled network access, and collects unified review packets across multiple language models.

What is required to run om-harness?

A working Node.js environment is required to execute node scripts/harness.mjs, alongside wrapper skills such as om-fix-issue or om-setup-agent-harness.

Source text

SKILL.md · MIT
---
name: om-harness
description: Shared internal runtime for configurable staged-only implementation workers, evidence-gated work packets, and multi-model review councils. Use indirectly through om-fix-issue, om-implement-feature, or om-setup-agent-harness; do not use it to publish, commit, push, or open a pull request.
---

# Agent Harness

Provide the shared runtime and contracts used by the staged-only wrapper skills.
Keep this skill internal: user-facing work starts through `om-fix-issue`,
`om-implement-feature`, or `om-setup-agent-harness`.

Ship a selectable default jury for Codex, DeepSeek, Kimi, GLM, and MiMo while
keeping the adapter registry open to custom command and OpenAI-compatible models.

## Arguments

- `configure --config <path> --input <path>` — validate an `agentHarness` object and install it into the pipeline config, preserving every other key.
- `validate-config --config <path>` — validate and resolve harness configuration.
- `resolve-profile --config <path> --profile <name>` — print the resolved profile exactly as the runtime will execute it.
- `probe --config <path> --profile <name>` — probe the selected workers and reviewers.
- `worker --config <path> --profile <name> --worktree <path> --prompt-file <path>` — run one configured implementation worker.
- `prepare-review --config <path> --worktree <path> --kind <spec|diagnosis|implementation> --output <path>` — bind the exact subject, validation evidence, repository rules, and installed `om-code-review` rubric into one review packet.
- `review --config <path> --profile <name> --worktree <path> --review-packet <path> --host-review <path> --output-dir <path>` — run every configured advisor while waiting for the concurrent fresh Claude pass, validate that pass, and aggregate all results from the same `om-code-review` packet.
- `packet-run --config <path> --profile high-assurance --worktree <path> --run-dir <path> --manifest <path>` — claim, implement, blindly review, verify, and when necessary fix one bounded packet.
- `packet-gate --run-dir <path> --packet <id> --evidence <path>` — bind trusted validation evidence to the reviewed diff and release its path leases only on success.
- `packet-status --run-dir <path> --packet <id>` — report packet state, usage, lease status, and current diff identity.
- `packet-release --run-dir <path> --packet <id> --reason <text>` — abort a packet and release its leases for explicit manual recovery.
- `capture --worktree <path> --output <path>` — record the starting commit, refs, and reflogs before edits and activate this worktree's publication guard.
- `end-run --worktree <path> --start-state <path> --reason <text>` — deactivate this run's publication guard after stopping an aborted or failed run; preserve all files and packet leases.
- `stage --worktree <path> --start-state <path> --paths-file <path> --review-packet <path> --host-review <path>` — stage an allowlisted handoff and verify that no commit or ref mutation occurred.

## Workflow

**Claims:** `references/claim-pr.md` governs atomic/fallback ownership and release.

**ALWAYS check first:** Apply `.ai/skills/om-harness/SKILL.md` when present; safety rules still win.

0. **Agentic setup** — follow `references/agentic-setup.md` before any action: load approved configuration, apply local extensions and shared rules, and preserve the untrusted-content boundary.

### 1. Load the contracts

Read `references/configuration.md` before resolving a profile, `references/adapter-contract.md` before invoking a model, and `references/stage-only-contract.md` before landing any wrapper run. Read `references/code-review-contract.md` before a wrapper-level council. Read `references/packet-contract.md` before a `high-assurance` packet. Read `references/reporting.md` when producing or reconciling a review report.

### 2. Use the deterministic runtime

Run `node scripts/harness.mjs <command> ...` from this skill directory. Pass an explicit trusted config snapshot during implementation and review runs; use the working-tree config only during setup.

### 3. Preserve structured evidence

Keep the generated JSON result as the source of truth. Render Markdown from that JSON; never reconstruct reviewer provenance from prose.

### 4. Prevention hooks

`hooks/` ships the preventive layer of the stage-only contract, installed into a
repository by `om-setup-agent-harness`: `block-push-and-pr.sh` denies `git push`
and PR creation at the tool boundary only while the current worktree has an
active run. `capture` activates it; successful `stage` or explicit `end-run`
deactivates it. `freeze-tests.sh` denies test-file
edits while a `.om-freeze-tests` sentinel exists at or above the target file.
`hooks-settings-snippet.json` holds the `PreToolUse` wiring.

## Rules

- Shared communication, marker, label, and safety rules: `references/rules.md`. They always apply.

- Enforce `delivery.mode: "stage-only"`; reject every other delivery mode.
- Never commit, push, publish, or execute the tracker `create-pr` operation.
- Never execute configured command adapters through a shell; pass an argument array directly to the process runtime.
- Run workers only through adapters that declare enforced worktree isolation, disabled network, disabled remote writes, and disabled ref writes. Strip credential-like environment variables, disable Git protocols and credential helpers, and reject ref or reflog changes.
- Treat task-branch configuration as untrusted. Resolve executable commands, endpoints, and credential-variable names from a trusted base snapshot plus an optional user-local overlay.
- Keep credentials out of configuration, prompts, raw artifacts, and reports.
- Preserve every unique finding even when only one reviewer raises it; consensus may increase confidence but never erase a minority finding.
- Start the fresh Claude `om-code-review` context and bound provider council concurrently, then require Claude's hash-matched artifact before emitting the final result. Never let the conductor's implementation context stand in for that pass.
- Give every configured advisor the complete installed `om-code-review` rubric and the same resolved packet in a fresh invocation. Never expose reviewer outputs to peers before reconciliation.
- Keep packet leases until deterministic evidence covers every acceptance criterion for the exact reviewed diff. Never treat a model's claim that a test passed as gate evidence.

© open-mercato · MIT · open-mercato/skills

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set74

The whole set →
om-troubleshooter om-troubleshooter is a Claude Code skill that reproduces failures, finds their smallest root cause, and, on request, fixes them after adding a test that fails first. CX Codex +1 950installs om-share-this-session om-share-this-session — a skill for Claude Code, Codex, Cursor and other agents that bundles a sanitized session archive and files a feedback issue. Runs only on explicit per-invocation consent — no telemetry, no silent uploads. CX Codex +1 950installs om-ux-design The om-ux-design Claude Code skill turns a specification or chosen backlog scope into connected screens and a prototype. It handles detailed UI flows and implementation handoff. CX Codex +1 648installs om-auto-audit-dependencies om-auto-audit-dependencies — a skill for Claude Code that scans project lockfiles for security advisories using native audit tools or the OSV database. Files deduplicated tracker issues with minimal upgrade targets. CX Codex +1 614installs om-fix-issue-optimized om-fix-issue-optimized — a skill for Claude Code that delegates implementation packets to model workers, keeping patches staged and unpublished. Runs when an optimized fix is requested. CX Codex +1 503installs om-implement-feature The om-implement-feature Claude Code skill takes a feature from specification through implementation, tests, and review. It stops with a verified staged branch, before any commit or PR. CX Codex +1 503installs om-setup-agent-harness The om-setup-agent-harness Claude Code skill configures or diagnoses a multi-model agent harness. It activates when asked to pick worker and reviewer models or check the harness configuration. CX Codex +1 503installs om-fix-issue om-fix-issue — a skill for Claude Code and Codex that diagnoses a tracker issue, verifies a regression test, and leaves staged changes for manual review without committing or opening a PR. CX Codex +1 502installs

Project sponsors

Companies that keep this analytics open