mcpField
G
github-pr-workflow

github-pr-workflow

github.com/yparesDevelopment3069 installsUpdated 1d ago
Repository

About github-pr-workflow

A skill for inspecting GitHub pull requests and handling review feedback. Its `gh-pr-info` script gathers PR status, CI checks, and unresolved review comments, including inline threads.

Key features

  1. 01Summarize PR status and CI checks
  2. 02Find unresolved inline review comments
  3. 03Filter resolved, hidden, or dismissed feedback
  4. 04Detect repository from git remote
  5. 05Reference GitHub API endpoints

Use cases

  1. 01Reviewing outstanding feedback before merging
  2. 02Checking CI and review status for a PR
  3. 03Finding inline comments not shown by `gh pr view --comments`

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/ypares/agent-skills --skill github-pr-workflow

After installing, type/github-pr-workflowin Claude Code to confirm it loaded.

Bundled filesscripts/gh-pr-info

Details

From the project README

GitHub PR Workflow

Key Concepts

Comment Types

GitHub PRs have two different types of comments:

  1. PR-level comments - General discussion on the PR (shown via gh pr view --comments)
  2. Inline code review comments - Comments attached to specific lines of code (requires API)

Important: gh pr view --comments does NOT show inline code review comments!

Scripts

ScriptPurpose
gh-pr-info <PR> [REPO]Comprehensive PR info: summary, CI checks and unresolved review and inline comments

The script auto-detects the repo from git remote, or accepts [REPO] as second argument (format: owner/repo).

Key features:

  • Uses GitHub's GraphQL API to reliably filter out already resolved/addressed comments
  • Excludes collapsed/hidden review threads
  • Excludes minimized comments (marked as spam/off-topic/resolved)
  • Excludes dismissed reviews
  • Shows only what still needs attention

Common Commands

# Get complete PR info with UNRESOLVED comments only
gh-pr-info <PR> [REPO]             # ✅ Everything you need: summary, checks, reviews, unresolved comments

# Basic PR info (native gh commands)
gh pr view <PR>                    # Overview
gh pr view <PR> --comments         # PR-level comments only (NOT inline!)
gh pr diff <PR>                    # View the diff

# Reviews (approve/request changes)
gh pr review <PR> --approve
gh pr review <PR> --request-changes --body "Please fix X"
gh pr review <PR> --comment --body "Looks good overall"

# Checks
gh pr checks <PR>                  # CI status
gh run view <RUN_ID> --log-failed  # Failed job logs

API Endpoints Reference

When gh commands don't expose what you need, use the API:

# Inline review comments
gh api repos/OWNER/REPO/pulls/PR/comments

# PR-level comments (issue comments)
gh api repos/OWNER/REPO/issues/PR/comments

# Review submissions
gh api repos/OWNER/REPO/pulls/PR/reviews

# Commits in PR
gh api repos/OWNER/REPO/pulls/PR/commits

# Files changed
gh api repos/OWNER/REPO/pulls/PR/files

Workflow: Addressing Review Comments

  1. Get unresolved comments: gh-pr-info <PR>
  2. Make fixes in your local branch

Comments

Markdown supported