address-pr-comments

Fetch, categorize, and resolve GitHub pull request review comments via gh api GraphQL.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/mattschwartz/systemos --skill address-pr-comments-mattschwartz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: address-pr-comments
Source: https://github.com/mattschwartz/systemos/tree/main/.claude/skills/address-pr-comments
Command: npx skills add https://github.com/mattschwartz/systemos --skill address-pr-comments-mattschwartz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a disciplined process for engineers to read, categorize, and resolve GitHub pull request review comments so PRs are handled cleanly, preventing partial fixes, missed feedback, and rework.

Core Features & Use Cases

  • Structured Triage: Fetches unresolved inline review threads and ensures every comment is assigned to Fix, Decision needed, Clarification, or Duplicate.
  • Blocker Surfacing: Identifies and reports design or ambiguous comments that require human decisions before any code changes are made.
  • Verification and Traceability: Verifies each fix addresses the original comment, stages only changed files, commits with a descriptive message, and leaves concise PR replies; ideal for engineers responding to review rounds in collaborative repositories.

Quick Start

Address PR number 9 by fetching unresolved review threads, categorizing each comment, surfacing blockers, implementing fixes, verifying them against the original comments, and committing only the files changed in response.

Frequently Asked Questions about address-pr-comments

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

FAQPage Schema
How do I resolve GitHub pull request review comments efficiently?

To resolve GitHub pull request review comments efficiently, fetch unresolved review threads via the gh api GraphQL query, categorize each comment into Fix, Decision needed, Clarification, or Duplicate, and implement targeted code changes. This structured triage prevents partial fixes and missed reviewer feedback during collaborative code review rounds.

What is the best way to triage inline PR review threads?

The best way to triage inline PR review threads is to fetch unresolved feedback and categorize each comment into Fix, Decision needed, Clarification, or Duplicate. This process surfaces design blockers requiring human decisions before any code edits are made, ensuring clean traceability and preventing rework.

How do I categorize GitHub PR comments before writing code?

You categorize GitHub PR comments before writing code by fetching unresolved inline review threads and sorting them into Fix, Decision needed, Clarification, or Duplicate buckets. This surfaces ambiguous design comments as blockers, ensuring all required human decisions are made before implementing any fixes.

How do I verify PR fixes against original reviewer feedback?

To verify PR fixes against original reviewer feedback, compare your staged code changes against the categorized review comments, ensure each fix directly addresses the feedback, and commit only the changed files with a descriptive message. Leave concise replies on the PR threads to close the loop.

Can I use gh api GraphQL to fetch unresolved review threads for comment triage?

Yes, you can use gh api GraphQL to fetch unresolved review threads for comment triage. This query retrieves inline review comments requiring fixes, clarifications, or design decisions, enabling a structured workflow that prevents missed feedback and partial fixes in collaborative repositories.

Why should I surface blocker comments before making code changes on a pull request?

You should surface blocker comments before making code changes on a pull request to identify design or ambiguous feedback requiring human decisions. Addressing these blockers first prevents unnecessary rework, ensures your fixes align with the intended architecture, and maintains a clean traceable commit history.