skills.rest
fedify-dev
fedify-devOFFICIAL
Explore all skills by this author →
WebsiteGitHub

get-reviews

Fetch, organize, and help resolve GitHub pull request reviews via the gh CLI.

1.0k|132|Updated Mar 2, 2024
Search Tags:#Automation#gh CLI#gitHub#graphqL#review resolution#Code review#Pull request
One-click install
npx skills add https://github.com/fedify-dev/fedify --skill get-reviews
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: get-reviews
Source: https://github.com/fedify-dev/fedify/tree/main/.agents/skills/get-reviews
Command: npx skills add https://github.com/fedify-dev/fedify --skill get-reviews

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Managing feedback on GitHub pull requests is tedious: reviews, review threads, and PR-level comments are scattered across the GitHub UI, making it hard to track what needs fixing, decide on each item, and respond systematically. This Skill fetches all review data via the GitHub GraphQL API, organizes it into structured local files, and guides the contributor through judging and resolving each review.

Core Features & Use Cases

  • Review Fetching: Uses the gh CLI and a GraphQL script to pull PR comments, reviews, and review threads (with pagination support) into JSON files.
  • Structured Organization: Stores each unresolved review as a Markdown file under plans/{PR_NUMBER}/reviews/ using a consistent template with Summary, Judgement, Plans, and Comments sections.
  • Guided Resolution Workflow: Helps the contributor judge each review (CORRECT, WRONG, PARTIAL, NEEDS EVALUATION, NEEDS DISCUSSION), apply changes, commit with review links and AI-attribution trailers, and post polite English reply comments.
  • Use Case: A maintainer receives ten review threads on a pull request. The Skill fetches them all, creates one file per review, helps draft responses and code changes, and tracks each item through to resolution.

Quick Start

Fetch and organize the reviews for pull request number 123, then help me work through resolving each one.

Frequently Asked Questions about get-reviews

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fetch all reviews from a GitHub pull request?▼

Use the gh CLI with the GitHub GraphQL API to query PR comments, reviews, and review threads in one request. The fetch_reviews.sh script wraps this query, paginates with a cursor, and saves the results as timestamped JSON files.

How to organize GitHub pull request review comments for resolution?▼

Create one Markdown file per unresolved review under plans/{PR_NUMBER}/reviews/, using the review thread, PR comment, or review node ID as the filename. Each file follows a template with Summary, Judgement, Plans, and Comments sections.

Does this workflow require the GitHub CLI to be installed?▼

Yes, the gh CLI must be installed and authenticated before fetching reviews. Run gh auth status to verify authentication, and gh auth login if credentials are missing.

Can I fetch only new review threads incrementally?▼

Yes, save the pageInfo.endCursor from a previous fetch and pass it as the LAST_CURSOR variable. The GraphQL query then returns only review threads after that cursor instead of re-fetching everything.

What are the limitations of automated pull request review resolution?▼

The agent only prepares information and suggestions; the contributor makes every judgement and verifies all changes with tests before commits, comments, or resolutions. Nothing is applied, pushed, or marked resolved without human confirmation.

Related Skills

Explore More Software Engineering Skills→
abhiroopbabhiroopb

gh-pr-read

Read and summarize GitHub pull requests using the gh CLI tool.

Community
Intermediate
tobihagemanntobihagemann
399

resolve-pr-comments

Fetch, evaluate, fix, and reply to unresolved GitHub pull request review comments.

Community
Advanced
ElliotJLTElliotJLT
60

prove-it

Run test suites and validate results before declaring completion.

Community
Intermediate
nanozukinanozuki
15

review-github-pr

Review GitHub pull requests and submit APPROVE or REQUEST_CHANGES decisions.

Community
Advanced