codex-result-handling — Claude Code skill: handle Codex output
A skill that ensures Codex results are presented to you properly. Preserves findings, inferences, file paths, line numbers, and severity order. Blocks automatic code fixes after review—you must approve changes first.
npx skills add openai/codex-plugin-cc --skill codex-result-handling -a claude-codeWhat codex-result-handling does
codex-result-handling manages how Codex output reaches you in the IDE. It keeps the structure intact: verdict, summary, findings ordered by severity, inferences, open questions, and affected files. If Codex made edits, the skill lists them; if no issues were found, it says so explicitly.
The skill enforces a hard stop after review. Once Codex reports findings, no file changes happen until you choose which issues to fix. This prevents accidental modifications based on incomplete analysis or inferences marked as uncertain.
If Codex fails or returns an error, the skill shows the most useful stderr output and stops—no guessing, no workarounds. For setup or auth issues, it directs you to /codex:setup.
What it helps with
- Preserve Codex output structure when sending results to the user
- Display findings in severity order with exact line numbers
- Prevent automatic code fixes after review without explicit approval
- Distinguish facts from inferences and open questions in Codex output
- Report Codex errors with actionable context instead of attempting workarounds
Example prompts for the agent
- Run `/codex:review src/auth.ts` and the skill shows findings in the right order with file paths
- After Codex returns issues, the skill asks which ones you want fixed instead of auto-applying patches
- If Codex fails to run, the skill prints the error and suggests `/codex:setup`
How to install codex-result-handling
1Skills CLI (Vercel)
npx skills add openai/codex-plugin-cc --skill codex-result-handling -a claude-code2Manually: put the files in place
~/.claude/skills/codex-result-handling/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/codex-result-handling/
1Skills CLI (Vercel)
npx skills add openai/codex-plugin-cc --skill codex-result-handling -a codex2Manually: put the files in place
.agents/skills/codex-result-handling/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add openai/codex-plugin-cc --skill codex-result-handling -a cursor2Manually: put the files in place
.cursor/skills/codex-result-handling/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install openai/codex-plugin-cc codex-result-handling2Manually: put the files in place
.github/skills/codex-result-handling/SKILL.md1Skills CLI (Vercel)
npx skills add openai/codex-plugin-cc --skill codex-result-handling -a gemini-cli2Platform CLI
gemini skills install https://github.com/openai/codex-plugin-cc --path plugins/codex/skills/codex-result-handlingManually: put the files in place
.devin/skills/codex-result-handling/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add openai/codex-plugin-cc --skill codex-result-handling -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set3
The whole set →Similar
Questions about codex-result-handling
How do I install codex-result-handling in Claude Code?
Run npx skills add openai/codex-plugin-cc --skill codex-result-handling -a claude-code, then check ~/.claude/skills/codex-result-handling/SKILL.md.
What does codex-result-handling do?
It ensures Codex results reach you with the right structure: findings ordered by severity, file paths and line numbers preserved, and a clear distinction between facts and uncertain inferences. Most important—it stops automatic fixes and asks for your approval first.
Why doesn't the skill fix issues automatically?
Because Codex output may contain inferences or incomplete analysis. The skill shows you the findings, asks which ones to fix, and only then touches files. You stay in control.
Source text
SKILL.md · Apache-2.0
--- name: codex-result-handling description: Internal guidance for presenting Codex helper output back to the user user-invocable: false --- # Codex Result Handling When the helper returns Codex output: - Preserve the helper's verdict, summary, findings, and next steps structure. - For review output, present findings first and keep them ordered by severity. - Use the file paths and line numbers exactly as the helper reports them. - Preserve evidence boundaries. If Codex marked something as an inference, uncertainty, or follow-up question, keep that distinction. - Preserve output sections when the prompt asked for them, such as observed facts, inferences, open questions, touched files, or next steps. - If there are no findings, say that explicitly and keep the residual-risk note brief. - If Codex made edits, say so explicitly and list the touched files when the helper provides them. - For `codex:codex-rescue`, do not turn a failed or incomplete Codex run into a Claude-side implementation attempt. Report the failure and stop. - For `codex:codex-rescue`, if Codex was never successfully invoked, do not generate a substitute answer at all. - CRITICAL: After presenting review findings, STOP. Do not make any code changes. Do not fix any issues. You MUST explicitly ask the user which issues, if any, they want fixed before touching a single file. Auto-applying fixes from a review is strictly forbidden, even if the fix is obvious. - If the helper reports malformed output or a failed Codex run, include the most actionable stderr lines and stop there instead of guessing. - If the helper reports that setup or authentication is required, direct the user to `/codex:setup` and do not improvise alternate auth flows.
© openai · Apache-2.0 · openai/codex-plugin-cc