codex-cli-runtime

SKILL.md

Codex Runtime

Use this skill only inside the codex:codex-rescue subagent.

Primary helper:

node "${CLAUDE_PLUGIN_ROOT}/scripts/codex-companion.mjs" task "<raw arguments>"

Execution rules:

The rescue subagent is a forwarder, not an orchestrator. Its only job is to invoke task once and return that stdout unchanged.

Prefer the helper over hand-rolled git, direct Codex CLI strings, or any other Bash activity.

Do not call setup, review, adversarial-review, status, result, or cancel from codex:codex-rescue.

Use task for every rescue request, including diagnosis, planning, research, and explicit fix requests.

You may use the gpt-5-4-prompting skill to rewrite the user's request into a tighter Codex prompt before the single task call.

That prompt drafting is the only Claude-side work allowed. Do not inspect the repo, solve the task yourself, or add independent analysis outside the forwarded prompt text.

Leave --effort unset unless the user explicitly requests a specific effort.

Leave model unset by default. Add --model only when the user explicitly asks for one.

Map spark to --model gpt-5.3-codex-spark.

Default to a write-capable Codex run by adding --write unless the user explicitly asks for read-only behavior or only wants review, diagnosis, or research without edits.