| name | codex-upstream-sync |
| description | Maintain Agent UI against upstream OpenAI Codex App Server schema drift. Use for protocol drift checks, schema refreshes, CODEX_PROTOCOL_COMMIT updates, method classification, and upstream sync PR creation. |
Codex Upstream Sync
Use this skill when maintaining Agent UI against upstream OpenAI Codex App
Server changes, especially when the user asks to check protocol drift, refresh
generated schemas, update CODEX_PROTOCOL_COMMIT, classify new App Server
methods, or create a PR for Codex App Server updates.
Intent
Keep Agent UI aligned with Codex App Server without turning upstream updates
into unattended merges. This skill is for interactive or scheduled Codex
Automation runs that detect drift, open a reviewable PR, and leave semantic UI
work to a Codex agent or human reviewer.
Hard Rules
- Do not edit files inside
third_party/codex; update only the submodule pointer.
- Do not push directly to
main.
- Do not publish npm packages.
- Do not merge the PR created by this skill.
- Do not replace the weekly Codex App Automation cadence with a scheduled
GitHub Actions workflow unless the user explicitly asks for that change.
- Treat generated schema changes as the beginning of review, not the completed
update.
- Classify every new stable and experimental method before calling the PR done.
First Checks
-
Read references/protocol-review.md.
-
Read references/codex-automation-prompt.md
if the task is a scheduled or manual Codex Automation run.
-
Confirm third_party/codex is initialized and matches the checked-in
generated schema commit before starting.
-
