github-pr-workflow

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

Updated Aug 21, 2026
One-click install
npx skills add https://github.com/TylerSimons1127/vibe --skill github-pr-workflow-tylersimons1127
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: github-pr-workflow
Source: https://github.com/TylerSimons1127/vibe/tree/main/skills/github/github-pr-workflow
Command: npx skills add https://github.com/TylerSimons1127/vibe --skill github-pr-workflow-tylersimons1127

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Managing pull requests involves repetitive manual steps across branching, committing, PR creation, CI monitoring, failure diagnosis, and merging, often on machines where the GitHub CLI is unavailable. ## Core Features & Use Cases - Full PR Lifecycle: Create branches with naming conventions, write conventional commits, push, and open PRs using either gh CLI or git plus curl against the GitHub REST and GraphQL APIs. - CI Monitoring and Auto-Fix: Poll check runs and commit statuses, download failed job logs, diagnose failures with a troubleshooting reference, and loop through fix-commit-push cycles up to three attempts. - Merge Automation: Squash, merge, or rebase via API, enable auto-merge through GraphQL, and clean up local and remote branches after merging. - Use Case: After fixing a login redirect bug, the agent creates a fix/login-redirect-bug branch, commits with a conventional message, opens a PR from a template, watches CI, auto-fixes a lint failure, and squash-merges once checks pass. ## Quick Start Create a branch, commit my current changes with a conventional commit message, open a pull request, monitor CI, and merge it when the checks pass.

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 when the GitHub CLI is installed, or send a POST request with curl to the GitHub REST API pulls endpoint using your token, branch name as head, and main as base.

How to monitor GitHub Actions CI status 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 every 30 seconds works for machines without gh.

Can I use GitHub PR workflows without the gh CLI installed?▼

Yes, every operation has a git plus curl fallback using the GitHub REST API with a token from the environment, a .env file, or git credentials. Auto-merge additionally requires the GraphQL API since REST does not support it.

Why does my GitHub Actions CI check keep failing?▼

Common causes include test assertion mismatches, lint or formatting violations, type errors, missing dependencies, permission issues, and timeouts. Download the failed run logs and match error signatures against the troubleshooting reference to identify the fix.

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

With gh, run `gh pr merge --auto --squash --delete-branch`. With curl, fetch the PR node_id from the REST API, then call the GraphQL enablePullRequestAutoMerge mutation. The repository must have auto-merge enabled in settings.