wmasfoe/md-editor / .agents/skills/performance-goal
performance-goal
Verified[OMX] 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
Record evaluator evidence:
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:
omx performance-goal complete --slug startup-latency --evidence "final evaluator evidence" --codex-goal-json <get_goal-json-or-path>
Agent Loop
- Run
omx performance-goal createif no workflow exists. - Run
omx performance-goal startand follow the handoff:- call
get_goal; - call
create_goalonly when no active goal exists and the objective is explicit; - work only against the evaluator contract;
- after evaluator pass and completion audit, call
update_goal({status: "complete"}), callget_goalagain, and pass that snapshot toomx performance-goal complete --codex-goal-json;
- call
- Optimize in small reversible patches.
- Run the evaluator and related regression tests.
- Record each pass/fail/blocker with
checkpoint. - Complete only when the pass artifact exists and no required work remains.
Completion Gate
A performance goal is incomplete unless .omx/goals/performance/<slug>/state.json contains a lastValidation.status of pass and omx performance-goal complete receives a matching complete Codex get_goal snapshot via --codex-goal-json. Passing ordinary tests alone is not sufficient unless they are the declared evaluator contract.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 467k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |