Filter GitHub PR Review Requests by Team

This skill retrieves unread GitHub notifications for open pull requests where review is requested from a specified team or opened by a team member. It filters your notification stream to surface only the PRs that need your attention, eliminating manual browsing through GitHub's notification interface.

Use this skill when you need to find unread GitHub PR review requests for a specific team, check which open PRs currently need your review or a teammate's review, or need a filtered review queue instead of manually browsing GitHub notifications. Trigger phrases include "find PRs I need to review", "show my review requests", "what needs my review", "fetch GitHub review requests", or "check team review queue".

Do NOT use this skill for tasks outside this scope - it is not a substitute for environment-specific validation, testing, or expert review. Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.

You provide a GitHub team slug (e.g. streaming-platform) or display name. The skill accepts either format and converts display names to lowercase-hyphenated slugs. You can filter by multiple teams using a comma-separated list.

The script returns JSON output with the total count and an array of PRs:

{
  "total": 3,
  "prs": [
    {
      "notification_id": "12345",
      "title": "feat(kafka): add workflow to restart a broker",
      "url": "https://github.com/getsentry/ops/pull/19144",
      "repo": "getsentry/ops",
      "pr_number": 19144,
      "author": "bmckerry",
      "reasons": ["opened by: bmckerry"]
    }
  ]
}

Each PR includes the notification ID, title, URL, repository, PR number, author, and reasons. The reasons array may contain one or both of: "review requested from: <Team Name>" (when the team is a requested reviewer) or "opened by: <login>" (when the PR author is a team member). Results are presented as a markdown table with full URLs.

Requires GitHub CLI (gh) authenticated. The skill uses the Bash tool to execute the Python script via uv run. The script calls GitHub's API to fetch notifications, check PR state, retrieve requested reviewers, and verify team membership.

Example usage:

uv run ${CLAUDE_SKILL_ROOT}/scripts/fetch_review_requests.py --org getsentry --teams streaming-platform

For multiple teams:

uv run ${CLAUDE_SKILL_ROOT}/scripts/fetch_review_requests.py --org getsentry --teams team-one,team-two

If the script fails, a manual fallback using gh api notifications --paginate is available, followed by individual API calls to check PR state, requested reviewers, and team membership.

This skill serves engineering teams using GitHub for code review workflows, particularly those organized into teams with shared review responsibilities. It benefits developers who need to triage review requests quickly, team leads monitoring their team's review queue, and anyone overwhelmed by GitHub notification volume who needs a focused view of actionable review requests.