← Back to Skills Marketplace
ericlooi504

GitHub PR Manager

by ericlooi504 · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ⚠ suspicious
16
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install gh-pr-flow
Description
GitHub Pull Request lifecycle management — create, review, merge, changelog generation, CI checks, conflict resolution, and draft management via gh CLI. Use...
README (SKILL.md)

GitHub PR Manager

Overview

Streamline GitHub Pull Request workflows: create, review, merge, changelog generation, CI checks, and draft management via gh CLI. Use when Codex needs to manage PR lifecycle, check review status, handle merge conflicts, or generate changelogs.

Quick Start

Prerequisites

  • gh CLI installed and authenticated (gh auth status)
  • Git repository with remote on GitHub

Check your PR overview

bash scripts/gh-pr-review.sh --mine

Create a PR with auto-generated content

python3 scripts/gh-pr-create.py --draft --label review-needed

Generate changelog from merged PRs

python3 scripts/gh-pr-changelog.py --from v1.0 --to v2.0

Common Tasks

Creating & managing PRs

# Create draft PR
gh pr create --draft --title "WIP: Add login" --body "In progress"

# Create PR with labels
gh pr create --label enhancement --label needs-review

# View PR details
gh pr view \x3Cnumber>         # view in terminal
gh pr view \x3Cnumber> --web   # open in browser

# Update PR
gh pr edit \x3Cnumber> --title "New title" --add-label ready

Review workflow

# Check what needs my review
gh pr list --search "review-required:@me" --state open

# Approve
gh pr review \x3Cnumber> --approve --body "LGTM"

# Request changes
gh pr review \x3Cnumber> --request-changes --body "Please fix the tests"

# Add comment
gh pr review \x3Cnumber> --comment --body "Nice work!"

# Check review status on a PR
gh pr view \x3Cnumber> --json reviewDecision,reviews

CI & merge

# Check CI status
gh pr checks \x3Cnumber>            # detailed status
gh pr view \x3Cnumber> --json statusCheckRollup

# Merge when checks pass
gh pr merge \x3Cnumber> --squash    # squash and merge
gh pr merge \x3Cnumber> --rebase    # rebase and merge
gh pr merge \x3Cnumber> --merge     # merge commit
gh pr merge \x3Cnumber> --auto      # auto-merge after checks pass

# Check mergeability
gh pr view \x3Cnumber> --json mergeable,mergeStateStatus

Conflict resolution

# Check if PR has conflicts
gh pr view 42 --json mergeable
# → "CONFLICTING" if there are conflicts

# Fix locally
git checkout \x3Cpr-branch>
git fetch origin
git merge origin/main                # resolve conflicts
git push

# Alternative: rebase instead
git rebase origin/main               # resolve conflicts
git push --force-with-lease

Working with branches

# Checkout a PR locally for testing
gh pr checkout \x3Cnumber>

# List your branches with PR status
gh pr list --author "@me" --json headRefName,title,state,isDraft

# Compare branches
gh pr diff \x3Cnumber>              # view diff
gh pr diff \x3Cnumber> --name-only  # just filenames

Reference

  • scripts/gh-pr-create.py — PR creation with auto-generated title/body from commits
  • scripts/gh-pr-review.sh — Overview of pending reviews and CI status
  • scripts/gh-pr-changelog.py — Generate changelog from merged PRs between releases
  • See references/pr-templates.md for PR template examples
  • See references/label-conventions.md for label conventions
Usage Guidance
Install this only if you want the agent to help manage GitHub PRs. Before allowing use, confirm the active `gh` account, limit permissions to the intended repositories, and require explicit approval for PR approvals, merges, auto-merge, edits, label changes, and any force-push conflict-resolution steps.
Capability Analysis
Type: OpenClaw Skill Name: gh-pr-flow Version: 1.0.1 The gh-pr-flow skill bundle provides a legitimate set of tools for managing GitHub Pull Request workflows using the official GitHub CLI (gh). The included scripts (gh-pr-create.py, gh-pr-review.sh, and gh-pr-changelog.py) use safe subprocess execution patterns and perform actions strictly aligned with the stated purpose of PR creation, review, and changelog generation. No evidence of data exfiltration, malicious execution, or harmful prompt injection was found.
Capability Assessment
Purpose & Capability
The scripts and documentation match the stated PR-management purpose, including PR creation, review status, changelog generation, and CI checks; the noteworthy issue is that the purpose itself includes repository-mutating actions.
Instruction Scope
The skill documents approving, merging, auto-merging, editing PRs, and force-pushing during conflict resolution, but does not define when the agent must ask for explicit user approval or limit actions to specific repositories, branches, or PRs.
Install Mechanism
There is no install script and the included helper scripts are visible, but the registry metadata does not declare the required gh/git CLI dependency or GitHub authentication that the SKILL.md and scripts rely on.
Credentials
Using the authenticated gh CLI is proportionate for GitHub PR management, but it inherits the user's current GitHub account permissions and can affect any repository that account can access.
Persistence & Privilege
No background persistence, self-propagation, or stored memory is shown; the privilege concern is reliance on an existing authenticated GitHub CLI session.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install gh-pr-flow
  3. After installation, invoke the skill by name or use /gh-pr-flow
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Fix: gh-pr-review.sh now works without eval, uses proper bash arrays
v1.0.0
Initial release: PR creation with auto-title, review overview, changelog generation, PR templates, label conventions
Metadata
Slug gh-pr-flow
Version 1.0.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is GitHub PR Manager?

GitHub Pull Request lifecycle management — create, review, merge, changelog generation, CI checks, conflict resolution, and draft management via gh CLI. Use... It is an AI Agent Skill for Claude Code / OpenClaw, with 16 downloads so far.

How do I install GitHub PR Manager?

Run "/install gh-pr-flow" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is GitHub PR Manager free?

Yes, GitHub PR Manager is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does GitHub PR Manager support?

GitHub PR Manager is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created GitHub PR Manager?

It is built and maintained by ericlooi504 (@ericlooi504); the current version is v1.0.1.

💬 Comments