nerf-gh

name	nerf-gh
description	GitHub CLI tools for pull requests, issues, and workflow runs
targets	["*"]

nerf-gh

These tools are available as scripts within this skill. Call them using the paths shown in each usage line.

These tools wrap the GitHub CLI (gh) for safe interaction with pull requests, issues, and workflow runs. The repository is auto-detected from the current git remote.

A pull request has four distinct comment surfaces, each with its own tool:

• "thread comments" -- top-level conversation in the main PR view. Read via gh-pr-thread-comments, written via gh-pr-thread-comment.
• "reviews" -- the high-level Approved / Changes requested / Commented wrappers, each with a body summary. List the latest via gh-pr-reviews.
• "review comments" -- inline comments scoped to one review. Fetch with gh-pr-review-comments using a review id from gh-pr-reviews.
• "inline comments" -- all inline review comments across every review on the PR. Use gh-pr-inline-comments when you want a flat list of all line-level comments without iterating reviews.

Note: inline-comment thread resolution state (resolved / unresolved, set via the "Resolve conversation" button in the UI) is a GraphQL-only field on the GitHub API and is not exposed by this manifest. Use the GitHub UI to verify resolution state.

nerf-gh-pr-list

List open pull requests in the current repository.

Usage: scripts/nerf-gh-pr-list [--web|-w] [--state|-s <state>] [--author <author>] [--base|-B <base>] [--limit|-L <limit>] Maps to: gh pr list <web> <state> <author> <base> <limit>

Switches:

• --web, -w: Open the list in the browser

Options:

• --state|-s (optional): Filter by state (default: open). one of open, closed, merged, all
• --author (optional): Filter by author (GitHub username or @me)
• --base|-B (optional): Filter by base branch
• --limit|-L (optional): Maximum number of PRs to list (default 30). must match ^[0-9]+$

---

nerf-gh-pr-view

View full details of a pull request as JSON, including metadata, comments, reviews, and file list.

Usage: scripts/nerf-gh-pr-view <pr> Maps to: gh pr view <pr> --json title,body,state,author,baseRefName,headRefName,comments,reviews,reviewDecision,labels,isDraft,additions,deletions,files,mergedAt,mergedBy

Arguments:

• <pr> (required): PR number, URL, or branch name

---

nerf-gh-pr-diff

Show the diff for a pull request.

Usage: scripts/nerf-gh-pr-diff <pr> Maps to: gh pr diff <pr>

Arguments:

• <pr> (required): PR number, URL, or branch name

---

nerf-gh-pr-thread-comments

List top-level conversation comments on a pull request (the issue-style comments shown in the main PR thread, NOT inline review comments). Returns the raw GitHub API response; pipe through jq to project the fields you want.

Usage: scripts/nerf-gh-pr-thread-comments <pr> Maps to: gh api --paginate --slurp repos/{owner}/{repo}/issues/<pr>/comments

Arguments:

• <pr> (required): PR number. must match ^[0-9]+$

---

nerf-gh-pr-reviews

List reviews on a pull request, latest first. Each entry includes id (numeric), author, state, commit (short SHA), submitted_at, and body (the reviewer's summary text). Pass an entry's id to gh-pr-review-comments to fetch the inline comments for that specific review.

Usage: scripts/nerf-gh-pr-reviews [--limit|-L <limit>] <pr>

Options:

• --limit|-L (optional): Maximum number of reviews to return (default 10, latest first). must match ^[1-9][0-9]*$

Arguments:

• <pr> (required): PR number. must match ^[0-9]+$

---

nerf-gh-pr-copilot-review-status

Report the status of Copilot's review on a PR. Returns JSON with requested (true if Copilot is currently in the pending-reviewers list, i.e. a review is in flight) and latest_review (the most recent submitted Copilot review with id/state/submitted_at/body, or null if Copilot has never submitted one). The combinations are: requested=true + latest_review=null -> freshly requested, waiting; requested=true + latest_review= -> re-requested after a prior review; requested=false + latest_review= -> the latest review has landed; requested=false + latest_review=null -> Copilot was never requested. Use gh-pr-request-copilot-review to request, and gh-pr-review-comments <pr> <review_id> with the returned id to fetch inline comments.

Usage: scripts/nerf-gh-pr-copilot-review-status <pr>

Arguments:

• <pr> (required): PR number. must match ^[0-9]+$

---

nerf-gh-pr-review-comments

List inline review comments for a single review (by numeric review ID). Use gh-pr-reviews to find review IDs. Returns the raw GitHub API response; pipe through jq to project the fields you want.

Usage: scripts/nerf-gh-pr-review-comments <pr> <review_id> Maps to: gh api --paginate --slurp repos/{owner}/{repo}/pulls/<pr>/reviews/<review_id>/comments

Arguments:

• <pr> (required): PR number. must match ^[0-9]+$
• <review_id> (required): Numeric review ID (from gh-pr-reviews). must match ^[0-9]+$

---

nerf-gh-pr-inline-comments

List ALL inline review comments on a pull request, across all reviews. Each comment is tied to a specific line of code. Use gh-pr-review-comments instead when you have a specific review ID and only want that review's comments. Returns the raw GitHub API response; pipe through jq to project the fields you want.

Usage: scripts/nerf-gh-pr-inline-comments <pr> Maps to: gh api --paginate --slurp repos/{owner}/{repo}/pulls/<pr>/comments

Arguments:

• <pr> (required): PR number. must match ^[0-9]+$

---

nerf-gh-pr-create

Create a pull request from the current branch. Pushes the branch if needed.

Usage: scripts/nerf-gh-pr-create [--draft|-d] [--body|-b <body>] [--base|-B <base>] [--reviewer|-r <reviewer>] <title> Maps to: gh pr create <draft> --title <title> <body> <base> <reviewer>

Switches:

• --draft, -d: Create as a draft PR

Options:

• --body|-b (optional): PR body/description
• --base|-B (optional): Base branch (default is the repo default branch)
• --reviewer|-r (optional): Request review from this user

Arguments:

• <title> (required): PR title

---

nerf-gh-pr-edit

Edit an existing pull request's title, body, or base branch. Replaces the listed fields wholesale (not patch-style) -- if you're updating the body, pass the full new body, not a diff. To change other fields (reviewers, labels, milestone) use the bypass sentinel.

Usage: scripts/nerf-gh-pr-edit [--title|-t <title>] [--body|-b <body>] [--base|-B <base>] <pr> Maps to: gh pr edit <pr> <title> <body> <base>

Options:

• --title|-t (optional): New PR title (replaces the existing title)
• --body|-b (optional): New PR body/description (replaces the existing body wholesale)
• --base|-B (optional): New base branch. Retargets which commits this PR is proposing -- the head branch is not modified, but in-flight reviews and CI runs may be reset.

Arguments:

• <pr> (required): PR number, URL, or branch name

---

nerf-gh-pr-ready

Mark a draft pull request as ready for review. Pass --undo to convert a non-draft PR back to a draft. Does nothing (and reports success) if the PR is already in the requested state.

Usage: scripts/nerf-gh-pr-ready [--undo] <pr> Maps to: gh pr ready <pr> <undo>

Switches:

• --undo: Convert the PR back to a draft instead of marking it ready

Arguments:

• <pr> (required): PR number, URL, or branch name

---

nerf-gh-pr-request-copilot-review

Request a Copilot review on a pull request. Requires the Copilot code review feature to be enabled on the repo or org (otherwise gh returns an "unprocessable entity" error). The review request appears in the PR's requested reviewers list until Copilot submits, at which point the review shows up via gh-pr-reviews.

Usage: scripts/nerf-gh-pr-request-copilot-review <pr> Maps to: gh pr edit <pr> --add-reviewer copilot-pull-request-reviewer

Arguments:

• <pr> (required): PR number, URL, or branch name

---

nerf-gh-pr-thread-comment

Add a top-level conversation comment to a pull request (the issue-style comments shown in the main PR thread). For inline review comments, see gh-pr-review-comments (one review) or gh-pr-inline-comments (across all reviews).

Usage: scripts/nerf-gh-pr-thread-comment <pr> <body> Maps to: gh pr comment <pr> --body <body>

Arguments:

• <pr> (required): PR number, URL, or branch name
• <body> (required): Comment text

---

nerf-gh-issue-list

List open issues in the current repository.

Usage: scripts/nerf-gh-issue-list [--state|-s <state>] [--assignee|-a <assignee>] [--label|-l <label>] [--limit|-L <limit>] Maps to: gh issue list <state> <assignee> <label> <limit>

Options:

• --state|-s (optional): Filter by state (default: open). one of open, closed, all
• --assignee|-a (optional): Filter by assignee (GitHub username or @me)
• --label|-l (optional): Filter by label
• --limit|-L (optional): Maximum number of issues to list (default 30). must match ^[0-9]+$

---

nerf-gh-issue-view

View full details of an issue as JSON, including metadata, comments, and labels.

Usage: scripts/nerf-gh-issue-view <issue> Maps to: gh issue view <issue> --json title,body,state,author,comments,labels,assignees,milestone,createdAt,updatedAt,closedAt

Arguments:

• <issue> (required): Issue number or URL

---

nerf-gh-issue-create

Create a new issue.

Usage: scripts/nerf-gh-issue-create [--body|-b <body>] [--label|-l <label>] [--assignee|-a <assignee>] <title> Maps to: gh issue create --title <title> <body> <label> <assignee>

Options:

• --body|-b (optional): Issue body/description
• --label|-l (optional): Label to add
• --assignee|-a (optional): User to assign

Arguments:

• <title> (required): Issue title

---

nerf-gh-issue-edit

Edit an existing issue's title or body. Replaces the listed fields wholesale (not patch-style) -- if you're updating the body, pass the full new body. To change other fields (labels, assignees, milestone) use the bypass sentinel.

Usage: scripts/nerf-gh-issue-edit [--title|-t <title>] [--body|-b <body>] <issue> Maps to: gh issue edit <issue> <title> <body>

Options:

• --title|-t (optional): New issue title (replaces the existing title)
• --body|-b (optional): New issue body (replaces the existing body wholesale)

Arguments:

• <issue> (required): Issue number or URL

---

nerf-gh-issue-comment

Add a comment to an issue.

Usage: scripts/nerf-gh-issue-comment <issue> <body> Maps to: gh issue comment <issue> --body <body>

Arguments:

• <issue> (required): Issue number or URL
• <body> (required): Comment text

---

nerf-gh-run-list

List recent workflow runs.

Usage: scripts/nerf-gh-run-list [--workflow|-w <workflow>] [--branch|-b <branch>] [--status|-s <status>] [--limit|-L <limit>] Maps to: gh run list <workflow> <branch> <status> <limit>

Options:

• --workflow|-w (optional): Filter by workflow name or filename
• --branch|-b (optional): Filter by branch
• --status|-s (optional): Filter by status. one of queued, in_progress, completed, waiting, requested, action_required, cancelled, failure, neutral, skipped, stale, startup_failure, success, timed_out
• --limit|-L (optional): Maximum number of runs to list (default 20). must match ^[0-9]+$

---

nerf-gh-run-view

View details of a workflow run. Defaults to the summary view; pass --log-failed to show logs from just the failed jobs/steps (useful for triaging a CI failure without dumping the entire log stream).

Usage: scripts/nerf-gh-run-view [--log-failed] <run_id> Maps to: gh run view <run_id> <failed>

Switches:

• --log-failed: Show logs from failed jobs/steps instead of the summary

Arguments:

• <run_id> (required): Workflow run ID. must match ^[0-9]+$

---

Hit a bug, complaint, bypass-worthy guardrail, or want a feature? Use the nerf-report skill.