| name | gh-review-comments |
| description | 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. |
| argument-hint | <owner/repo> <pr-number> [--author <login>] [--reply <message>] [--resolve] [--unresolve] [--create-review] [--thread-id <id>] [--unresolved-only] |
| allowed-tools | AskUserQuestion, Bash, Read, Task |
| user-invocable | true |
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 commentside: 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
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
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
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
