gh-pr-comment-audit

Audit GitHub pull request review comments against branch purpose and resolve threads.

Updated Feb 11, 2026
One-click install
npx skills add https://github.com/mcmurrym/coding-agent-skills --skill gh-pr-comment-audit-mcmurrym
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gh-pr-comment-audit
Source: https://github.com/mcmurrym/coding-agent-skills/tree/main/agent-skills/gh-pr-comment-audit
Command: npx skills add https://github.com/mcmurrym/coding-agent-skills --skill gh-pr-comment-audit-mcmurrym

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Review-driven fixes often expand a pull request beyond its intended scope, causing speculative scope creep and endless fix-the-fix chains. This Skill audits unresolved PR review comments against the branch's stated purpose so only justified, in-scope changes are made. ## Core Features & Use Cases - Purpose-gated triage: Establishes a branch contract from PR metadata and diffs, then classifies every finding as core-purpose, necessary supporting change, or adjacent improvement. - Evidence-based bucketing: Sorts threads into not-real, not-actionable-in-practice, trivial in-scope fix, or non-trivial/out-of-scope, with capacity and pagination reality checks before adding defensive machinery. - Targeted mode and interactive actions: Process a single discussion, thread, or the next unresolved item, and render per-issue Codex HTML buttons for research, resolution, implementation, and shipping. - Use Case: A reviewer flags a missing pagination limit on a query. The Skill verifies the realistic collection bound against service thresholds, finds it safely bounded, documents the evidence, and resolves the thread without adding speculative code. ## Quick Start Use $gh-pr-comment-audit to audit the unresolved review comments on my current pull request and fix only the small in-scope issues.

Frequently Asked Questions about gh-pr-comment-audit

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

FAQPage Schema
How do I audit unresolved GitHub PR review comments automatically?▼

Run the bundled script with fetch and a PR URL to download all unresolved review threads via the GitHub GraphQL API. The Skill then classifies each finding against the branch purpose, fixes trivial in-scope issues, and resolves justified threads.

How to process a single PR review comment instead of the whole audit?▼

Use targeted mode with a discussion anchor, thread ID, or the next-unresolved selector, for example fetch with --discussion discussion_r123456789. Only the selected comment is analyzed, and the parent thread is resolved only when it contains no other actionable issues.

Does this Skill auto-fix every reviewer suggestion?▼

No. It only auto-fixes small, verified in-scope issues whose upstream and downstream impact is understood. Valid but adjacent improvements are reported as out of scope, and non-trivial issues are presented with suggested fixes for user approval.

How does it handle pagination or capacity concerns from reviewers?▼

It performs a capacity reality check by establishing the reachable collection size from business rules and comparing it to relevant service or query limits. Theoretical worst cases with safe headroom are resolved as not actionable in practice without adding pagination machinery.

What permissions are needed to resolve GitHub review threads?▼

You need gh CLI authentication with repository access and permission to resolve review threads. All GitHub API calls go through the bundled script, which uses gh api graphql for fetching and resolving threads.