github-pr-workflow

Drive a GitHub pull request from feature branch to merged PR with CI and Copilot fix loops.

Updated Jun 6, 2026
One-click install
npx skills add https://github.com/hacker-cb/claude-code-plugins --skill github-pr-workflow-hacker-cb
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: github-pr-workflow
Source: https://github.com/hacker-cb/claude-code-plugins/tree/main/plugins/hcb-dev/skills/github-pr-workflow
Command: npx skills add https://github.com/hacker-cb/claude-code-plugins --skill github-pr-workflow-hacker-cb

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Moving finished work through GitHub's review-and-merge lifecycle involves repetitive manual steps: renaming and publishing branches, rebasing onto a moving base, opening the PR, chasing red CI checks, answering Copilot review comments, and deciding when a merge is actually authorized. This Skill automates that entire drive while keeping the merge decision under explicit human authorization. ## Core Features & Use Cases - Branch preparation and publishing: Renames the branch to the required naming shape, rebases onto the current base, and pushes with --force-with-lease before opening a ready-for-review PR. - Autonomous fix loop: Reads merge gates, required checks, and Copilot review state via dedicated scripts, fixes Critical and Important findings, replies to and resolves review threads, and loops until the PR is mergeable. - Authorized merging and landing: Merges only under an explicit merge-auth value, watches the merge commit's checks on the base, closes linked issues, retires both refs, and produces a structured end-of-session report. - Use Case: You finished a feature branch and say "ship this". The Skill rebases, opens the PR, iterates on CI failures and Copilot comments, then stops at ready and asks for merge authorization before merging. ## Quick Start Ask the assistant to ship the current feature branch as a GitHub pull request and drive it through review to merge.

Frequently Asked Questions about github-pr-workflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate merging a GitHub pull request with CI checks?▼

Use this Skill to open the PR and run a fix loop that reads required checks and merge gates via scripts, fixes failing CI root causes, and re-polls until GitHub reports the PR mergeable. The actual merge only happens under an explicit authorization value.

How to handle GitHub Copilot review comments on a pull request?▼

The Skill reads Copilot's state and findings with dedicated scripts, classifies each finding by severity, fixes Critical and Important items, replies to every comment, and resolves threads once replies are confirmed posted. It waits for the review of the current head before merging.

Does this workflow merge pull requests automatically without approval?▼

No. Merging is the one action never taken on the Skill's own authority. A merge-auth value governs it: on-green merges immediately, queued waits for the addressee's go, and ask stops at ready and requests explicit approval first.

Can I use this with GitLab or Bitbucket pull requests?▼

No. This driver is GitHub-specific by design, built around the gh CLI, GitHub rulesets, branch protection APIs, and Copilot code review. Other forges route to their own drivers through the slice-completion reference.

What happens when a required CI check fails during the PR loop?▼

The Skill reads the failing job's logs and fixes the root cause rather than guessing. If the failure is caused by a GitHub platform outage, it parks the run, monitors the status feed from a detached job, and resumes once the component recovers.

When should I start from shipping-workflow instead of this skill?▼

Start from shipping-workflow when finished work has had no local review yet. It runs the reviewers and coverage gate first, then hands off here; entering github-pr-workflow directly skips both the local review and its gate.