ef285b5c97
* fix: stabilize validation and tests on Windows * test: add Windows smoke coverage for skill activation * refactor: make setup_web script CommonJS * fix: repair aegisops-ai frontmatter * docs: add when-to-use guidance to core skills * docs: add when-to-use guidance to Apify skills * docs: add when-to-use guidance to Google and Expo skills * docs: add when-to-use guidance to Makepad skills * docs: add when-to-use guidance to git workflow skills * docs: add when-to-use guidance to fp-ts skills * docs: add when-to-use guidance to Three.js skills * docs: add when-to-use guidance to n8n skills * docs: add when-to-use guidance to health analysis skills * docs: add when-to-use guidance to writing and review skills * meta: sync generated catalog metadata * docs: add when-to-use guidance to Robius skills * docs: add when-to-use guidance to review and workflow skills * docs: add when-to-use guidance to science and data skills * docs: add when-to-use guidance to tooling and automation skills * docs: add when-to-use guidance to remaining skills * fix: gate bundle helper execution in Windows activation * chore: drop generated artifacts from contributor PR * docs(maintenance): Record PR 457 sweep Document the open issue triage, PR supersedence decision, local verification, and source-only cleanup that prepared PR #457 for re-running CI. --------- Co-authored-by: sickn33 <sickn33@users.noreply.github.com>
86 lines
2.6 KiB
Markdown
86 lines
2.6 KiB
Markdown
---
|
|
name: gh-review-requests
|
|
description: Fetch unread GitHub notifications for open PRs where review is requested from a specified team or opened by a team member. Use when asked to "find PRs I need to review", "show my review requests", "what needs my review", "fetch GitHub review requests", or "check team review queue".
|
|
allowed-tools: Bash
|
|
risk: safe
|
|
source: community
|
|
---
|
|
|
|
# GitHub Review Requests
|
|
|
|
Fetch unread `review_requested` notifications for open (unmerged) PRs, filtered by a GitHub team.
|
|
|
|
**Requires**: GitHub CLI (`gh`) authenticated.
|
|
|
|
## When to Use
|
|
|
|
- You need to find unread GitHub PR review requests for a specific team.
|
|
- You want to check which open PRs currently need your review or a teammate's review.
|
|
- You need a filtered review queue instead of manually browsing GitHub notifications.
|
|
|
|
## Step 1: Identify the Team
|
|
|
|
If the user has not specified a team, ask:
|
|
|
|
> Which GitHub team should I filter by? (e.g. `streaming-platform`)
|
|
|
|
Accept either a team slug (`streaming-platform`) or a display name ("Streaming Platform") — convert to lowercase-hyphenated slug before passing to the script.
|
|
|
|
## Step 2: Run the Script
|
|
|
|
```bash
|
|
uv run ${CLAUDE_SKILL_ROOT}/scripts/fetch_review_requests.py --org getsentry --teams <team-slug>
|
|
```
|
|
|
|
To filter by multiple teams, pass a comma-separated list:
|
|
|
|
```bash
|
|
uv run ${CLAUDE_SKILL_ROOT}/scripts/fetch_review_requests.py --org getsentry --teams <team slugs>
|
|
```
|
|
|
|
### Script output
|
|
|
|
```json
|
|
{
|
|
"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"]
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
`reasons` will contain one or both of:
|
|
- `"review requested from: <Team Name>"` — the team is a requested reviewer
|
|
- `"opened by: <login>"` — the PR author is a team member
|
|
|
|
## Step 3: Present Results
|
|
|
|
Display results as a markdown table with full URLs:
|
|
|
|
| # | Title | URL | Reason |
|
|
|---|-------|-----|--------|
|
|
| 1 | feat(kafka): add workflow to restart a broker | https://github.com/getsentry/ops/pull/19144 | opened by: evanh |
|
|
|
|
If `total` is 0, say: "No unread review requests found for that team."
|
|
|
|
## Fallback
|
|
|
|
If the script fails, run manually:
|
|
|
|
```bash
|
|
gh api notifications --paginate
|
|
```
|
|
|
|
Then for each `review_requested` notification, check:
|
|
- `gh api repos/{repo}/pulls/{number}` — skip if `state == "closed"` or `merged_at` is set
|
|
- `gh api repos/{repo}/pulls/{number}/requested_reviewers` — check `teams[].name`
|
|
- `gh api orgs/{org}/teams/{slug}/members` — check if author is a member
|