git-hex-pr-workflow
Complete pull request workflow combining git-hex (local craft) with remote collaboration (GitHub plugin or CLI). This skill should be used when the user wants to prepare, submit, and iterate on a PR with clean commit history. Trigger phrases include: "prepare a PR", "open a pull request", "address review feedback", "update my PR", "clean up commits for PR".
When & Why to Use This Skill
The git-hex-pr-workflow is a comprehensive Claude skill designed to streamline the entire Pull Request lifecycle. It seamlessly integrates local commit crafting using git-hex with remote GitHub collaboration via the GitHub plugin or CLI. This skill ensures a clean, professional commit history by allowing users to prepare, submit, and iterate on PRs efficiently, making it an essential tool for developers aiming for high-quality code contributions and organized version control management.
Use Cases
- Preparing a professional Pull Request: Use git-hex to squash, split, or reorder local commits into a logical sequence before pushing to a remote repository to ensure a readable history.
- Addressing code review feedback: Efficiently update an existing PR by creating fixup commits and rebasing to maintain a clean history based on reviewer suggestions without cluttering the log.
- End-to-end PR management: Create, view, and comment on GitHub pull requests directly through Claude using integrated GitHub CLI or plugin tools, bridging the gap between local development and remote collaboration.
| name | git-hex-pr-workflow |
|---|---|
| description | > |
| Trigger phrases include | "prepare a PR", "open a pull request", "address review |
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
Local craft (git-hex) - shape commits before pushing:
- Use
git-hex-getRebasePlanto inspect current history - Use
git-hex-createFixup+git-hex-rebaseWithPlanto clean up - Use
git-hex-splitCommitif commits need to be broken apart
- Use
Push to remote:
git push --force-with-lease(safe force push)
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 requestgh pr view- view PR detailsgh pr edit- update PR title/body/reviewersgh pr comment- add comments
After review feedback:
- Return to step 1 for more local craft
- Use
git-hex-undoLastif a cleanup went wrong
Tools to prefer
- Local craft: all git-hex tools (see branch-cleanup skill)
- Remote: GitHub plugin tools if installed, otherwise
ghCLI
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.