Add Review Comment
Adds a review comment to a specific line in a GitHub pull request.
Step 1: Locate the line to comment on
Use the fetch-diff skill (optionally piped through grep ) to locate the line to comment on.
Step 2: Post the comment
Single-line comment:
gh api repos/<owner>/<repo>/pulls/<pr_number>/comments \
Body must end with "🤖 Generated with Claude" on a separate line
-f body=<comment>
-f path=<file_path>
-F line=<line_number>
-f side=<side>
-f commit_id="$(gh pr view <pr_number> --repo <owner>/<repo> --json headRefOid -q .headRefOid)"
--jq '.html_url'
Multi-line comment:
gh api repos/<owner>/<repo>/pulls/<pr_number>/comments \
Body must end with "🤖 Generated with Claude" on a separate line
-f body=<comment>
-f path=<file_path>
-F start_line=<first_line>
-f start_side=<side>
-F line=<last_line>
-f side=<side>
-f commit_id="$(gh pr view <pr_number> --repo <owner>/<repo> --json headRefOid -q .headRefOid)"
--jq '.html_url'
Parameters
-
line : Line number in the file (for multi-line, the last line)
-
side : RIGHT for added/modified lines (+), LEFT for deleted lines (-)
-
start_line /start_side : For multi-line comments, the first line of the range
Best Practices
Use suggestion blocks (three backticks + "suggestion") for simple fixes that maintainers can apply with one click
<suggested code here>
Note: Preserve original indentation exactly in suggestion blocks
For repetitive issues, leave one representative comment instead of flagging every instance
For bugs, explain the potential problem and suggested fix clearly