codex-fix-pr

Installation
SKILL.md

Fix a failing pull request

Use update_plan for diagnosis, reproduction, fix, commit, description refresh, and push. The argument may name a pull request and the chosen commit strategy.

Diagnose and reproduce

Run once:

bash .agents/skills/codex-fix-pr/scripts/diagnose.sh <number>

Stop if the checkout differs from the commit CI tested. For each failure, run the mapped local task before editing. If it passes, inspect the workflow for an environment mismatch, flake, incomplete task mapping, or stale base. Use codex-rebase when the failing combined tree doesn't exist locally.

Fix only the cause. Don't weaken a rule, exclusion, or threshold without user approval. Re-run the reproducer until it passes.

Choose and commit the fix

Honor a strategy supplied by codex-pr. Otherwise, in Default mode ask in the final response whether to create a separate commit or amend and force-push. Don't commit in that turn. After confirmation, invoke codex-commit. For an amendment, ensure its independent message review sees the complete amended commit.

Installs
1
GitHub Stars
122
First Seen
Oct 11, 2026