gh-review-requests

The 'gh-review-requests' skill is designed to streamline the process of monitoring GitHub pull requests that require attention from a user or their team. It fetches unread notifications for open PRs where a review has been requested either from a specified team or authored by a team member. By focusing on 'review_requested' notifications, it eliminates the need to manually scan through all GitHub activity, helping users quickly identify which PRs need their input and ensuring timely code reviews across their organization.

This skill leverages the GitHub CLI ('gh') and the 'uv' CLI for Python package management to run a script that filters notifications by organization and team. Users can specify a single team or multiple teams to narrow down results. The script outputs structured JSON containing the total number of relevant PRs and detailed information for each, including PR title, URL, repository, author, and reason for inclusion. Reasons indicate whether the PR was opened by a team member or if a team review was requested. Results are then presented as a markdown table for easy readability. If the automated script fails, a manual fallback using 'gh api' commands is available to perform the same filtering process.

Ideal use cases include developers, team leads, or code reviewers who need a consolidated view of pending PRs that require attention. It is especially useful in large organizations with multiple teams, ensuring that review requests do not go unnoticed. Target users are those familiar with GitHub and CLI operations, seeking efficiency in code review management, team collaboration, and workflow organization.