github-pr-workflow

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

5|2|Updated May 26, 2026
One-click install
npx skills add https://github.com/perasyudha/Nyxora --skill github-pr-workflow-perasyudha
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: github-pr-workflow
Source: https://github.com/perasyudha/Nyxora/tree/main/packages/core/playbooks/github/github-pr-workflow
Command: npx skills add https://github.com/perasyudha/Nyxora --skill github-pr-workflow-perasyudha

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Managing pull requests involves repetitive manual steps: creating branches, writing conventional commits, opening PRs, watching CI, diagnosing failures, and merging. This Skill guides an agent through the entire PR lifecycle with both gh CLI and git + curl fallback commands, so it works on any machine regardless of tooling. ## Core Features & Use Cases - Full PR Lifecycle: Branch creation with naming conventions, conventional commits, PR creation via gh or the GitHub REST API, and squash/merge/rebase with branch cleanup. - CI Monitoring & Auto-Fix: Poll check runs and commit statuses, download failed job logs, diagnose common failure patterns (tests, lint, types, build, permissions, timeouts), and loop through fix-push-verify cycles. - Dual Auth Modes: Automatically detects whether gh is authenticated or falls back to GITHUB_TOKEN from environment, .nyxora/.env, or git credentials for raw API calls. - Use Case: Ask the agent to fix a bug and ship it — it creates a fix/ branch, commits with a conventional message, opens a PR with a structured body template, watches CI, auto-fixes a failing lint check, and squash-merges when green. ## Quick Start Create a pull request for my current changes, monitor the CI checks, fix any failures, and merge it when everything passes.

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 --title "..." --body "..."` with the GitHub CLI, or POST to the GitHub REST API at /repos/{owner}/{repo}/pulls with a GITHUB_TOKEN. Both approaches support draft PRs, reviewers, and labels.

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 REST API endpoints with curl. A polling loop every 30 seconds works when gh is unavailable.

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

Yes, every gh operation has a curl equivalent using a GITHUB_TOKEN for authentication. 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 auto-fix failing CI checks on a pull request?

Download the failed job logs via `gh run view --log-failed` or the logs API endpoint, identify the failure pattern (test, lint, type, build, permission, or timeout), patch the code, then commit and push. Repeat 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`. Via API, auto-merge requires the GraphQL enablePullRequestAutoMerge mutation since the REST API does not support it, and the repository must have auto-merge enabled in settings.