Codex Pre-Push Review

Use this skill when instructed by the user, typically when finished with implementing an issue.

Purpose

Run OpenAI Codex locally to review changes related to a GitHub issue. Codex will inspect the issue, run git status / git diff as needed, and return a structured review.

When to use

When instructed by the user, e.g.:

• “review changes for issue #42”
• “prepush review 42”
• “codex review #15”

How to invoke

Run the script at ~/.claude/skills/codex-prepush-review/run.sh with the issue number as the sole argument:

bash ~/.claude/skills/codex-prepush-review/run.sh <issue-number>

The script:

• Takes a GitHub issue number as input
• Executes Codex CLI with a structured review prompt
• Writes raw JSON output to a temporary file
• Prints only the filtered review text (agent message output)

Expected output

1. Blockers (must-fix before push)
2. Important (should-fix)
3. Nits (another-projectnal)
4. Missing tests (specific test cases)
5. Questions for the author (only if truly needed)

After review

Do not modify the script behavior. Address blockers before continuing. Present the full review output to the user for decision-making.