performance-goal
Run an evaluator-gated performance optimization workflow over Codex goal mode with durable OMX artifacts and safe goal handoffs.
Best for Goal-oriented performance t…Works with GitHub
⌘source
- author
@Yeachan-Heo- language
- TypeScript
★28kstars
2.2kforks
May 6, 2026
✦overview.md
Key Features
- ·Evaluator-gated optimization loop
- ·Durable artifact storage
- ·Safe goal handoffs
- ·Checkpoint-based progress tracking
Use Cases
- →Optimizing CLI startup latency with a concrete evaluator contract
- →Running iterative performance improvements with pass/fail gates
- →Tracking optimization progress across multiple attempts
Best for
- ✓Goal-oriented performance tuning
- ✓Iterative optimization workflows
Not ideal for
- !One-off performance audits
- !Non-performant ad-hoc scripts
FAQs
name
performance-goal
description
Run an evaluator-gated performance optimization workflow over Codex goal mode with durable OMX artifacts and safe goal handoffs.
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 callget_goalagain and pass that fresh snapshot toomx performance-goal complete --codex-goal-json.
CLI
Create the workflow and evaluator contract:
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:
omx performance-goal start --slug startup-latency
$install
1-click copynpx skills add Yeachan-Heo/oh-my-codex --skill performance-goalSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
4/ 5
very goodClear and well structured, with only minor parts that might need a second read.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
4/ 5
highMostly actionable with clear steps; only a few small gaps remain.