skills/posit-dev/skills/pr-threads-resolve

pr-threads-resolve

SKILL.md

/pr-threads-resolve

Usage: /pr-threads-resolve [PR_NUMBER]

Description: Bulk resolve unresolved PR review threads. Useful after manually addressing threads or after using /pr-threads-address.

Note: If PR_NUMBER is omitted, the command will automatically detect and use the PR associated with the current branch.

Workflow

  1. Fetch and display all unresolved PR review threads
  2. Show thread details (file, line, comment text)
  3. Ask for confirmation or allow selective resolution
  4. Resolve the confirmed threads
  5. Report back with a summary of resolved threads

When to use

Use this command when you have already addressed PR review threads and want to bulk resolve them, or when you need to clean up threads that are no longer relevant.

Example

/pr-threads-resolve 42

This will:

  • List all unresolved threads on PR #42
  • Show what each thread is about
  • Ask which threads to resolve (all or specific ones)
  • Resolve the selected threads
  • Provide a summary of resolved items

Prerequisites

Before using this command, check if the gh pr-review extension is installed:

gh extension list | grep -q pr-review || gh extension install agynio/gh-pr-review

CLI Reference

List Review Threads

Enumerate all review threads with filtering:

gh pr-review threads list --pr <number> --repo <owner/repo>

Common filters:

  • --unresolved — Show only unresolved threads
  • --resolved — Show only resolved threads

View PR Reviews and Comments

Display reviews, inline comments, and replies with full context:

gh pr-review review view --pr <number> --repo <owner/repo>

Common filters:

  • --reviewer <login> — Filter by specific reviewer
  • --states <list> — Filter by review state (APPROVED, CHANGES_REQUESTED, COMMENTED, DISMISSED)
  • --unresolved — Show only unresolved threads
  • --not_outdated — Exclude outdated threads
  • --tail <n> — Show only the last n replies per thread
  • --include-comment-node-id — Include GraphQL node IDs for replies

Resolve / Unresolve Threads

Toggle thread resolution status:

# Resolve a thread
gh pr-review threads resolve --thread-id <PRRT_...> --pr <number> --repo <owner/repo>

# Unresolve a thread
gh pr-review threads unresolve --thread-id <PRRT_...> --pr <number> --repo <owner/repo>

Bulk Resolve Example

# Get all unresolved thread IDs and resolve them
gh pr-review threads list --pr 42 --unresolved --repo owner/repo | \
  jq -r '.threads[].id' | \
  xargs -I {} gh pr-review threads resolve --thread-id {} --pr 42 --repo owner/repo

Usage Notes

  1. Repository Context: Always include --repo owner/repo to ensure correct repository context, or run commands from within a local clone of the repository.

  2. Thread IDs: Thread IDs (format PRRT_...) can be obtained from review view --include-comment-node-id or threads list commands.

  3. State Filters: When using --states, provide a comma-separated list: --states APPROVED,CHANGES_REQUESTED

  4. Unresolved Focus: Use --unresolved --not_outdated together to focus on actionable comments that need attention.

Weekly Installs
34
GitHub Stars
178
First Seen
10 days ago
Installed on
opencode33
claude-code33
github-copilot33
codex33
kimi-cli33
gemini-cli33