github-pr-workflow

Automates the GitHub pull request lifecycle from branch creation through CI monitoring and merge.

Updated Jun 17, 2026
One-click install
npx skills add https://github.com/i-bebsi/hermes-agent --skill github-pr-workflow-i-bebsi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: github-pr-workflow
Source: https://github.com/i-bebsi/hermes-agent/tree/main/hermes-config/skills/github/github-pr-workflow
Command: npx skills add https://github.com/i-bebsi/hermes-agent --skill github-pr-workflow-i-bebsi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Managing pull requests involves many repetitive steps—creating branches, writing conventional commits, opening PRs, watching CI, diagnosing failures, and merging—and doing them manually or inconsistently slows down development and introduces errors. ## Core Features & Use Cases - Full PR Lifecycle Automation: Covers branch creation, conventional commits, pushing, PR creation, CI monitoring, auto-fixing CI failures, and merging with squash or auto-merge. - Dual Auth Support: Every operation works with the gh CLI or falls back to git + curl against the GitHub REST/GraphQL API when gh is unavailable. - CI Failure Diagnosis: Includes a troubleshooting reference for common failure patterns (tests, lint, type checks, builds, permissions, timeouts, Docker) plus an auto-fix loop. - Use Case: Ask the agent to fix a bug on a new branch, open a PR with a structured body, watch CI, automatically fix a failing lint check, and squash-merge once green. ## Quick Start Create a pull request for the current changes, monitor its CI checks, fix any failures, and merge it when green.

Frequently Asked Questions about github-pr-workflow

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

FAQPage Schema
How do I create a GitHub pull request from the command line?▼

Use `gh pr create` with a title and body if the GitHub CLI is installed, or send a POST request to the GitHub REST API pulls endpoint with curl and a GITHUB_TOKEN. Both approaches are covered, including draft PRs, reviewers, and labels.

How to monitor GitHub CI checks for a pull request?▼

Run `gh pr checks --watch` to poll until checks finish, or query the commit status and check-runs API endpoints with curl using the branch HEAD SHA. A polling loop example checks status every 30 seconds until success or failure.

Can I use GitHub API without the gh CLI installed?▼

Yes, every operation has a git plus curl fallback using the GitHub REST API with a GITHUB_TOKEN. The token can come from the environment, a .env file, or git-credentials, and owner/repo is extracted from the git remote URL.

How do I automatically fix failing CI checks on a PR?▼

Download the failed run logs with `gh run view --log-failed` or the logs API, identify the failure pattern (test, lint, type, build, permission, timeout), fix the code, commit, and push. The auto-fix loop repeats up to three attempts before asking the user.

How to enable auto-merge on a GitHub pull request?▼

With gh, run `gh pr merge --auto --squash --delete-branch`. With curl, auto-merge requires the GraphQL API enablePullRequestAutoMerge mutation using the PR node_id, and the repository must have auto-merge enabled in settings.