github-pr-workflow

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

115|9|Updated Aug 5, 2026
One-click install
npx skills add https://github.com/AtlasOmnia/donna-starter --skill github-pr-workflow-atlasomnia
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: github-pr-workflow
Source: https://github.com/AtlasOmnia/donna-starter/tree/main/skills/github/github-pr-workflow
Command: npx skills add https://github.com/AtlasOmnia/donna-starter --skill github-pr-workflow-atlasomnia

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing pull requests involves repetitive manual steps across branching, committing, PR creation, CI monitoring, failure diagnosis, and merging, often requiring different commands depending on whether the GitHub CLI is installed. ## Core Features & Use Cases - Full PR Lifecycle Automation: Covers branch creation with naming conventions, conventional commits, PR creation, CI status polling, and squash merging with branch cleanup. - Dual Auth Paths: Every operation shows the gh CLI command first, then a git + curl fallback using the GitHub REST and GraphQL APIs for machines without gh. - CI Auto-Fix Loop: Diagnoses failed workflow runs by downloading logs, applies fixes with file tools, pushes, and re-checks status in a bounded retry loop. - Use Case: After fixing a login redirect bug, create a fix/login-redirect-bug branch, commit with a conventional message, open a PR using the bugfix template, watch CI until green, and squash-merge with branch deletion. ## Quick Start Create a pull request for my current branch, monitor its CI checks, and merge it with squash once all 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 after pushing your branch with `git push -u origin HEAD`. Without the gh CLI, send a POST request with curl to the GitHub pulls API endpoint using your GITHUB_TOKEN, specifying head branch and base.

How to monitor GitHub CI checks for a pull request?

Run `gh pr checks --watch` to poll until all checks finish. Alternatively, query the commit status and check-runs API endpoints with curl using the latest commit SHA, polling every 30 seconds until the state is success or failure.

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 GITHUB_TOKEN environment variable. Auto-merge additionally requires the GraphQL API since REST does not support enabling it.

How do I automatically fix failing CI checks on a pull request?

List workflow runs with `gh run list` or the actions API, download failed job logs, identify the error, patch the code, commit and push the fix, then re-check CI status. Repeat up to three attempts before asking the user.

What merge methods does the GitHub API support for pull requests?

The GitHub API supports three merge methods: merge commit, squash, and rebase. Squash merging with branch deletion is recommended for feature branches, and auto-merge can be enabled via GraphQL when the repository allows it.