| name | gh-commit-pr-review |
| description | Commit and publish local GitHub work with review requests. Use when the user wants Codex to commit staged changes, stage all changes only when nothing is staged, push the current branch, and open a GitHub pull request that tags @codex and @copilot for review. |
GitHub Commit PR Review
Use this skill to turn current repository changes into a pushed branch and PR review request.
Prefer delegating the publish operation to the gh-commit-pr-review-worker subagent. That worker is configured in $CODEX_HOME/agents/gh-commit-pr-review-worker.toml to mirror the local cheap profile. If that named subagent is unavailable in the current Codex session, run the same workflow inline.
Workflow
-
Inspect the repository state in the parent agent:
- Run
git status --short.
- Run
git diff --cached --stat.
- Run
git branch --show-current.
- Do not proceed on
main or master unless the user explicitly says to publish that branch.
-
Delegate to the cheap worker when available:
- Spawn
gh-commit-pr-review-worker.
- Pass the current repository path, branch, status summary, staged diff stat, any verification commands that were actually run, and this script path.
- Ask the worker to perform the commit, push, and PR creation using the helper script.
- Wait for the worker result and report the commit hash and PR URL.
-
If the worker is unavailable, decide the commit message, PR title, and PR body inline:
- Base them on the staged diff, or on the full working tree if no files are staged yet.
- Keep the commit message concise and descriptive.