# Performance Goal

Run an evaluator-gated performance optimization workflow over Codex goal mode with...

- Repository: https://github.com/Yeachan-Heo/oh-my-codex (33693 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add Yeachan-Heo/oh-my-codex --skill performance-goal -g -a claude-code -y`
Codex: `npx skills add Yeachan-Heo/oh-my-codex --skill performance-goal -g -a codex -y`
Cursor: `npx skills add Yeachan-Heo/oh-my-codex --skill performance-goal -g -a cursor -y`
Gemini CLI: `npx skills add Yeachan-Heo/oh-my-codex --skill performance-goal -g -a gemini-cli -y`

## Description

Run an evaluator-gated performance optimization workflow over Codex goal mode with durable OMX artifacts and safe goal handoffs.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Performance Goal Workflow

Use this skill when a user asks OMX to optimize performance and wants a goal-oriented loop rather than a one-off review.

## Contract

- OMX owns durable workflow state under `.omx/goals/performance/<slug>/`.
- Codex goal mode owns only the active-thread focus/accounting primitive.
- Shell commands do **not** mutate hidden Codex goal state. They write artifacts and emit model-facing handoff text.
- No optimization work may start until an evaluator command and pass/fail contract exist.
- Do not call `update_goal({status: "complete"})` until the evaluator has a passing checkpoint and a completion audit proves the objective is done; then call `get_goal` again and pass that fresh snapshot to `omx performance-goal complete --codex-goal-json`.

## CLI

Create the workflow and evaluator contract:

```sh
omx performance-goal create \
  --objective "Reduce CLI startup latency by 20%" \
  --evaluator-command "npm run perf:startup" \
  --evaluator-contract "PASS when p95 latency improves by 20% and regression tests pass" \
  --slug startup-latency
```

Emit the Codex goal handoff:

```sh
omx performance-goal start --slug startup-latency
```

Record evaluator evidence:

```sh
omx performance-goal checkpoint --slug startup-latency --status pass --evidence "benchmark + tests passed"
omx performance-goal checkpoint --slug startup-latency --status fail --evidence "benchmark regressed"
omx performance-goal checkpoint --slug startup-latency --status blocked --evidence "missing fixture"
```

Complete only after a passing checkpoint:

```sh
omx performance-goal complete --slug startup-latency --evidence "final evaluator evidence" --codex-goal-json <get_goal-json-or-path>
```

## Agent Loop

The rest: https://github.com/Yeachan-Heo/oh-my-codex/blob/HEAD/plugins/oh-my-codex/skills/performance-goal/SKILL.md