Skill

gh-review-comments

List, reply to, resolve, and create GitHub PR review comment threads using gh CLI scripts. Use when managing code review feedback, replying to reviewer remarks, resolving review conversations, creating reviews with line-level comments, or bulk-processing threads by author.

Install

npx claudepluginhub smykla-skalski/sai --plugin gh-review-comments

Tool Access

This skill is limited to using the following tools:

AskUserQuestionBashReadTask

Preview

Supporting Assets

references/gh-api-guide.mdscripts/add-review-comment.shscripts/create-review.shscripts/list-threads.shscripts/reply-thread.shscripts/resolve-thread.shscripts/unresolve-thread.sh

SKILL.md

Similar Skills

cache-components

Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.

cache-components

139.0k

claude-opus-4-5-migration

2 files

Migrates code, prompts, and API calls from Claude Sonnet 4.0/4.5 or Opus 4.1 to Opus 4.5, updating model strings on Anthropic, AWS, GCP, Azure platforms.

claude-opus-4-5-migration

83.2k

bmad-help

Analyzes BMad project state from catalog CSV, configs, artifacts, and query to recommend next skills or answer questions. Useful for help requests, 'what next', or starting BMad.

bmad-pro-skills

43.8k

Stats

Parent Repo Stars2

Parent Repo Forks1

Last CommitApr 2, 2026

Actions

View Source View Plugin View on GitHub View README

GH Review Comments

Wraps gh api (REST and GraphQL) via bash scripts to operate on PR review threads. Each action maps to a script in scripts/.

Arguments

Parse from $ARGUMENTS:

First positional arg: owner/repo (e.g., smykla-skalski/sai) — required
Second positional arg: PR number — required
--author <login> — Filter threads by reviewer username
--thread-id <id> — Target a specific thread by GraphQL node ID (PRRT_...)
--reply <message> — Reply to matched threads with this message
--resolve — Resolve matched threads (after replying if --reply also set)
--unresolve — Unresolve (reopen) matched threads
--unresolved-only — Only show/act on unresolved threads (auto-enabled with --reply or --resolve)
--create-review — Enter review creation mode (see Phase 3 alternative)

Actions Overview

Mode	Flags	Behavior
List	(no action flags)	Display threads with IDs, author, body, resolution status
Reply	`--reply <msg>`	Reply to matched threads
Resolve	`--resolve`	Resolve matched threads
Reply + Resolve	`--reply <msg> --resolve`	Reply then resolve each thread
Unresolve	`--unresolve`	Reopen resolved threads
Create review	`--create-review`	Interactively create a review with line-level comments

Scripts

All scripts live in scripts/ relative to this skill's base directory. Run them directly so users can allow-list by path pattern:

"${CLAUDE_SKILL_DIR}/scripts/<script>.sh" [args...]

`scripts/list-threads.sh`

List review threads with metadata via GraphQL.

"${CLAUDE_SKILL_DIR}/scripts/list-threads.sh" <owner> <repo> <pr_number> [--author <login>] [--unresolved-only]

Output: one JSON line per thread with thread_id, comment_id, author, body, path, line, is_resolved, is_outdated, reply_count.

`scripts/reply-thread.sh`

Reply to a review thread via REST API.

"${CLAUDE_SKILL_DIR}/scripts/reply-thread.sh" <owner> <repo> <pr_number> <comment_id> <body>

comment_id: integer database ID of the top-level comment (from list-threads.sh comment_id field)
Handles special characters (apostrophes, backticks, newlines) via JSON encoding

`scripts/resolve-thread.sh`

Resolve a review thread via GraphQL.

"${CLAUDE_SKILL_DIR}/scripts/resolve-thread.sh" <thread_id>

thread_id: GraphQL node ID (PRRT_...) from list-threads.sh thread_id field

`scripts/unresolve-thread.sh`

Reopen a resolved review thread via GraphQL.

"${CLAUDE_SKILL_DIR}/scripts/unresolve-thread.sh" <thread_id>

`scripts/add-review-comment.sh`

Manage comments on a pending review via GraphQL. Supports adding (reply/new thread), editing, and deleting comments.

"${CLAUDE_SKILL_DIR}/scripts/add-review-comment.sh" <review_node_id> <body> --reply-to <comment_node_id>
"${CLAUDE_SKILL_DIR}/scripts/add-review-comment.sh" <review_node_id> <body> --new-thread <path> <line> [--start-line <start_line>] [<side>]
"${CLAUDE_SKILL_DIR}/scripts/add-review-comment.sh" --edit <comment_node_id> <body>
"${CLAUDE_SKILL_DIR}/scripts/add-review-comment.sh" --delete <comment_node_id>

review_node_id: GraphQL node ID of the pending review (PRR_...)
comment_node_id: GraphQL node ID of the comment (PRRC_...)
--reply-to: reply to an existing thread
--new-thread: create a new thread on a file/line (single-line or multi-line)
--start-line: (optional, with --new-thread) start line for multi-line comments. Required for suggestion blocks that span multiple lines.
--edit: edit an existing pending review comment body
--delete: delete an existing pending review comment
side: RIGHT (default) or LEFT

`scripts/create-review.sh`

Create a PR review with line-level comments via REST API.

"${CLAUDE_SKILL_DIR}/scripts/create-review.sh" <owner> <repo> <pr_number> <event> <body> [<comments_json>|-]

event: PENDING, COMMENT, APPROVE, or REQUEST_CHANGES. PENDING omits the event field from the API payload, creating a draft review that is not yet submitted.
comments_json: JSON array of comment objects, each with path, line, body (and optional side, defaults to RIGHT)
Pass - as last arg to read comments from stdin

Workflow

Phase 1: Parse Arguments

Parse $ARGUMENTS for owner/repo, PR number, and flags
Split owner/repo into separate OWNER and REPO variables
Validate: both owner/repo and PR number are required
When --reply or --resolve is set, auto-enable --unresolved-only

Phase 2: List Threads

Run "${CLAUDE_SKILL_DIR}/scripts/list-threads.sh" with owner, repo, PR number, and filters (--author, --unresolved-only)
If --thread-id is specified, filter output to only that thread
Display results to the user in a readable format:
- Thread ID
- Author
- File path and line number
- Resolution status
- Body preview (first 80 chars)
- Reply count

If no action flags are set, stop here.

Phase 3: Execute Action

Read references/gh-api-guide.md for ID type mapping (REST integer IDs vs GraphQL node IDs), reply endpoint constraints, and shell quoting patterns.

For each matched thread, execute the requested action:

Reply (--reply):

Extract comment_id from the thread data
Run "${CLAUDE_SKILL_DIR}/scripts/reply-thread.sh" with owner, repo, PR number, comment_id, and the reply message
Report the created reply URL

Resolve (--resolve):

Extract thread_id from the thread data
Run "${CLAUDE_SKILL_DIR}/scripts/resolve-thread.sh" with thread_id
Report success

Reply + Resolve (--reply and --resolve together):

Reply first (as above)
Resolve second (as above)
Report both results

Unresolve (--unresolve):

Extract thread_id from the thread data
Run "${CLAUDE_SKILL_DIR}/scripts/unresolve-thread.sh" with thread_id
Report success

Phase 3 (alternative): Create Review

When --create-review is specified, skip Phase 2 actions and instead:

Use AskUserQuestion for the review event type (PENDING, COMMENT, APPROVE, or REQUEST_CHANGES)
Use AskUserQuestion for the review body text
Use AskUserQuestion for inline comments - for each comment, collect:
- File path (validate it exists in the PR diff)
- Line number
- Comment body
Build the comments JSON array
Run "${CLAUDE_SKILL_DIR}/scripts/create-review.sh" exactly once with the collected data
The script returns comment_count from the submitted payload (not from the API response). If the script exits 0, the review and all comments were submitted atomically - treat it as fully successful
Report the created review URL and comment count

NEVER re-run create-review.sh after it exits 0. The GitHub review creation API is atomic: if the call succeeds, the review body and all inline comments were attached. Running it again creates a duplicate review. There is no partial success - it either all works or the script fails with a non-zero exit.

Phase 4: Verify and Summarize

For reply/resolve/unresolve actions: spawn a general-purpose verification agent via Task. Pass it:

The PR identifier (owner/repo#number)
The action performed (reply, resolve, unresolve, or combination)
The before-state thread data captured in Phase 2 (thread IDs with their resolution status and reply counts)
The path to the list-threads script: "${CLAUDE_SKILL_DIR}/scripts/list-threads.sh"

The agent must:

Re-run list-threads.sh with the same owner, repo, PR number, and filters used in Phase 2
Compare before/after state for each acted-on thread (resolution status for resolve/unresolve, reply count for reply)
Return ONLY: verification result (success, partial, or failed), count of successful operations, count of failed operations, and a list of any failed thread IDs with the reason

Display the agent's verification summary to the user along with:

Total threads matched/acted on
Actions taken (replies sent, threads resolved/unresolved)
Link to the PR on GitHub

For create-review: do NOT spawn a verification agent. Do NOT re-list threads. The create-review.sh script output is the sole source of truth. If it exited 0 and returned a comment_count and html_url, the review was created with all comments attached. Report the review URL and comment count directly.

Error Handling

If a thread operation fails, log the error and continue with remaining threads
If --thread-id matches no thread, report "No matching thread found"
If create-review.sh fails (non-zero exit), report the error to the user. Do not retry automatically - the most common cause is invalid file paths or line numbers not present in the PR diff. Ask the user to verify the comment targets before re-attempting

Example Invocations

<example> List threads (read-only):

/gh-review-comments smykla-skalski/sai 4
/gh-review-comments smykla-skalski/sai 4 --unresolved-only
/gh-review-comments smykla-skalski/sai 4 --author Automaat

</example> <example> Reply and resolve:

/gh-review-comments smykla-skalski/sai 4 --author Automaat --reply "Fixed in latest push"
/gh-review-comments smykla-skalski/sai 4 --author bartsmykla --reply "Done" --resolve
/gh-review-comments smykla-skalski/sai 4 --thread-id PRRT_kwDOCnTGG85tgSD3 --resolve
/gh-review-comments smykla-skalski/sai 4 --thread-id PRRT_kwDOCnTGG85tgSD3 --reply "Done, thanks!" --resolve

</example> <example> Unresolve or create a new review:

/gh-review-comments smykla-skalski/sai 4 --thread-id PRRT_kwDOCnTGG85tgSD3 --unresolve
/gh-review-comments smykla-skalski/sai 4 --create-review

</example>