Agent Skills: Git-hex PR Workflow

Git-hex PR Workflow

When to use this Skill

This skill should be used when:

• The user wants to prepare a branch for PR submission with clean history
• The user is iterating on a PR after receiving review feedback
• The user asks about combining git-hex with GitHub/PR workflows

Trigger phrases include: "prepare a PR", "open a PR", "create a pull request", "address PR feedback", "update the PR", "force-push after rebase".

Workflow

1. Local craft (git-hex) - shape commits before pushing:

   • Use git-hex-getRebasePlan to inspect current history
   • Use git-hex-createFixup + git-hex-rebaseWithPlan to clean up
   • Use git-hex-splitCommit if commits need to be broken apart

2. Push to remote:

   • git push --force-with-lease (safe force push)

3. Remote collaboration - work with teammates:

   • If the GitHub Plugin is installed: use its tools to create/update PRs, add reviewers, respond to comments
   • Otherwise: use GitHub CLI (gh) commands:
     • gh pr create - create a pull request
     • gh pr view - view PR details
     • gh pr edit - update PR title/body/reviewers
     • gh pr comment - add comments

4. After review feedback:

   • Return to step 1 for more local craft
   • Use git-hex-undoLast if a cleanup went wrong

Tools to prefer

• Local craft: all git-hex tools (see branch-cleanup skill)
• Remote: GitHub plugin tools if installed, otherwise gh CLI

Key insight

git-hex handles the local craft of shaping commits. Remote collaboration (via the GitHub Plugin from the Official Claude Plugin Marketplace, or standard gh CLI) handles working with teammates. Together, they cover the complete pull request lifecycle.