not-matthias/github

<!-- Source: https://github.com/mitsuhiko/agent-stuff/blob/main/skills/github/SKILL.md -->

GitHub Skill

Use the gh CLI to interact with GitHub. Always specify --repo owner/repo when not in a git directory, or use URLs directly.

Pull Requests

Check CI status on a PR:

gh pr checks 55 --repo owner/repo

List recent workflow runs:

gh run list --repo owner/repo --limit 10

View a run and see which steps failed:

gh run view <run-id> --repo owner/repo

View logs for failed steps only:

gh run view <run-id> --repo owner/repo --log-failed

PR Review Comments

All comments (REST)

Fetch every review comment on a PR:

gh api repos/owner/repo/pulls/55/comments

Limitation: The REST API returns a flat list with no isResolved field. You cannot distinguish resolved from unresolved threads using REST alone.

Unresolved comments only (GraphQL)

The GraphQL API models reviews as threads, each with isResolved and isOutdated flags. Use this to get only actionable, unresolved threads:

gh api graphql \
  -f owner="OWNER" -f repo="REPO" -F pr=55 \
  -f query='
query FetchReviewComments($owner: String!, $repo: String!, $pr: Int!) {
  repository(owner: $owner, name: $repo) {
    pullRequest(number: $pr) {
      reviewThreads(first: 100) {
        nodes {
          id
          isResolved
          isOutdated
          comments(first: 50) {
            nodes {
              author { login }
              body
            }
          }
        }
      }
    }
  }
}' | jq '.data.repository.pullRequest.reviewThreads.nodes[] | select(.isResolved == false and .isOutdated == false)'

Key fields on each reviewThread:

• isResolved — user clicked "Resolve conversation" in the GitHub UI
• isOutdated — the diff line no longer exists (code moved/deleted)

Both must be false for a comment to be genuinely actionable.

To exclude bot comments, add: | select(.comments.nodes[0].author.login | endswith("[bot]") | not)

Script: scripts/unresolved-pr-comments.py

For a complete solution with pagination and formatted output, use the bundled script:

uv run scripts/unresolved-pr-comments.py <owner> <repo> <pr-number>         # exclude bots (default)
uv run scripts/unresolved-pr-comments.py <owner> <repo> <pr-number> --bots  # include bot comments

Handles pagination, bot filtering, and prints a numbered list of actionable threads with file path, line number, author, and comment body.

API for Advanced Queries

The gh api command is useful for accessing data not available through other subcommands.

Get PR with specific fields:

gh api repos/owner/repo/pulls/55 --jq '.title, .state, .user.login'

JSON Output

Most commands support --json for structured output. You can use --jq to filter:

gh issue list --repo owner/repo --json number,title --jq '.[] | "\(.number): \(.title)"'

Resources

• [scripts/unresolved-pr-comments.py] - Fetch unresolved PR review threads with pagination and bot filtering