Filters and ranks GitHub PRs based on project boards, milestones, and priority labels.
Install
mkdir -p .claude/skills/find-reviewable-pr && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/2138" && unzip -o skill.zip -d .claude/skills/find-reviewable-pr && rm skill.zipInstalls to .claude/skills/find-reviewable-pr
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Finds open PRs in the dotnet/maui and dotnet/docs-maui repositories that are good candidates for review, prioritizing by milestone, priority labels, partner/community status.Key capabilities
- →Filter open pull requests
- →Prioritize PRs by milestone
- →Identify community contributions
- →List partner PRs
How it works
It uses a PowerShell script to query GitHub and apply custom prioritization logic based on milestones, labels, and project board status.
Inputs & outputs
When to use find-reviewable-pr
- →Finding high-priority PRs needing review
- →Identifying community contributions to review
- →Reviewing milestoned PRs for the current release
- →Finding documentation PRs in docs-maui
About this skill
Find Reviewable PR
This skill searches the dotnet/maui and dotnet/docs-maui repositories for open pull requests that are good candidates for review, prioritized by importance.
When to Use
- "Find a PR to review"
- "Find PRs that need review"
- "Show me milestoned PRs"
- "Find partner PRs to review"
- "What community PRs are open?"
- "Find docs-maui PRs to review"
Priority Categories (in order)
- Priority (P/0) - Critical priority PRs that need immediate attention (always on top)
- Approved (Not Merged) - PRs with human approval that haven't been merged yet
- Ready To Review (Project Board) - PRs in "Ready To Review" column of the MAUI SDK Ongoing project board (requires
read:projectscope) - Milestoned - PRs assigned to current milestone(s), sorted by lowest SR number first (e.g., SR5 before SR6), then Servicing
- Agent Reviewed - PRs reviewed by AI agent workflow (detected via labels)
- Partner - PRs from Syncfusion and other partners
- Community - External contributions needing review
- Recent Waiting for Review - PRs created in last 2 weeks that need review (minimum 5)
- docs-maui Waiting for Review - Documentation PRs needing review (minimum 5)
Quick Start
# Find P/0 and milestoned PRs (default behavior, excludes changes-requested)
pwsh .github/skills/find-reviewable-pr/scripts/query-reviewable-prs.ps1
# Find all reviewable PRs across all categories
pwsh .github/skills/find-reviewable-pr/scripts/query-reviewable-prs.ps1 -Category all
# Find only milestoned PRs
pwsh .github/skills/find-reviewable-pr/scripts/query-reviewable-prs.ps1 -Category milestoned
# Find only docs-maui PRs waiting for review
pwsh .github/skills/find-reviewable-pr/scripts/query-reviewable-prs.ps1 -Category docs-maui
# Find approved PRs waiting to be merged
pwsh .github/skills/find-reviewable-pr/scripts/query-reviewable-prs.ps1 -Category approved
# Find PRs in "Ready To Review" on the project board
pwsh .github/skills/find-reviewable-pr/scripts/query-reviewable-prs.ps1 -Category ready-to-review
# Find agent-reviewed PRs with merge summaries
pwsh .github/skills/find-reviewable-pr/scripts/query-reviewable-prs.ps1 -Category agent-reviewed
# Find recent PRs waiting for review
pwsh .github/skills/find-reviewable-pr/scripts/query-reviewable-prs.ps1 -Category recent
# Find Android PRs only
pwsh .github/skills/find-reviewable-pr/scripts/query-reviewable-prs.ps1 -Platform android
# Limit results per category
pwsh .github/skills/find-reviewable-pr/scripts/query-reviewable-prs.ps1 -Limit 5
# Adjust docs-maui limit (default is 5, minimum enforced)
pwsh .github/skills/find-reviewable-pr/scripts/query-reviewable-prs.ps1 -DocsLimit 10
Script Parameters
| Parameter | Values | Default | Description |
|---|---|---|---|
-Category | default, milestoned, priority, recent, partner, community, docs-maui, approved, ready-to-review, agent-reviewed, all | default | Filter by category. default shows only P/0 + milestoned, excluding changes-requested PRs. |
-Platform | android, ios, windows, maccatalyst, all | all | Filter by platform |
-Limit | 1-100 | 100 | Max PRs per category (maui repo) |
-RecentLimit | 1-100 | 5 | Max recent PRs waiting for review from maui repo (minimum 5 enforced) |
-DocsLimit | 1-100 | 5 | Max PRs for docs-maui waiting for review (minimum 5 enforced) |
-ExcludeAuthors | string[] | (none) | Exclude PRs from specific authors (e.g., -ExcludeAuthors PureWeen,rmarinho) |
-IncludeAuthors | string[] | (none) | Only include PRs from specific authors |
-OutputFormat | review, table, json | review | Output format |
Workflow for Reviewing PRs
Step 1: Find PRs to Review
CRITICAL: You MUST use the PowerShell script below. Do NOT attempt to query GitHub directly with gh commands or jq if the script fails. The script contains important prioritization logic (SR5 before SR6, P/0 first, etc.) that cannot be replicated with ad-hoc queries.
pwsh .github/skills/find-reviewable-pr/scripts/query-reviewable-prs.ps1
If the script fails (e.g., HTTP 502, network error, authentication issue):
- STOP - Do not attempt fallback queries
- Report the error to the user
- Suggest retry - Ask user to try again in a few minutes (GitHub API may be temporarily unavailable)
Why no fallbacks? Ad-hoc queries bypass the milestone prioritization logic and will return incorrectly ordered results (e.g., later SR milestones before earlier ones).
Step 2: Check for Warnings
IMPORTANT: If the script output contains a warning about missing read:project scope, you MUST include this warning at the TOP of your response to the user:
⚠️ **Note**: Your GitHub token is missing the `read:project` scope. Project board data is not available.
To enable: `gh auth refresh -s read:project`
Step 3: Present Results from ALL Categories
CRITICAL: When presenting PR results, you MUST include PRs from ALL categories returned by the script:
- 🔴 Priority (P/0) - Always include if present (always first)
- 🟢 Approved (Not Merged) - Always include if present
- 📋 Ready To Review (Board) - Always include if present
- 📅 Milestoned - Always include if present
- 🤖 Agent Reviewed - Always include if present
- 🤝 Partner - Always include if present
- ✨ Community - Always include if present
- 🕐 Recent - Always include if present
- 📖 docs-maui - Always include if present
DO NOT omit any category. Each category table should include columns for: PR, Title, Author, Assignees, Platform/Repo, Status, Agent Review, Age, Updated.
Complexity Levels
| Complexity | Criteria |
|---|---|
| Easy | ≤5 files, ≤200 additions |
| Medium | 6-15 files, or 200-500 additions |
| Complex | >15 files, or >500 additions |
Tips
- P/0 PRs should always be reviewed first - they're blocking releases
- Approved PRs are ready to merge - verify CI is green and merge
- Ready To Review PRs are in the project board pipeline and need timely review
- Agent Reviewed PRs have been analyzed by the AI agent workflow - check their labels for status
- Milestoned PRs have deadlines and should be prioritized
- Partner PRs often have business priority
- Community PRs may need more guidance and thorough review
- Recent PRs - quick turnaround keeps contributors engaged
When not to use it
- →Querying GitHub without the script
- →Non-dotnet repositories
Prerequisites
Limitations
- →Requires read:project scope for board data
- →Script failure requires manual retry
How it compares
It enforces specific milestone prioritization logic that cannot be replicated by standard GitHub CLI queries.
Compared to similar skills
find-reviewable-pr side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| find-reviewable-pr (this skill) | 2 | 2mo | Review | Intermediate |
| nuget-manager | 5 | 7mo | No flags | Beginner |
| dependency-update | 1 | 2mo | Review | Intermediate |
| dotnet-dev | 1 | 6mo | Review | Beginner |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by dotnet
View all by dotnet →You might also like
nuget-manager
github
Manage NuGet packages in .NET projects/solutions. Use this skill when adding, removing, or updating NuGet package versions. It enforces using `dotnet` CLI for package management and provides strict procedures for direct file edits only when updating versions.
dependency-update
dotnet
Guides dependency version updates by checking nuget.org for latest versions, triggering the dotnet-migrate-package Azure DevOps pipeline, and monitoring runs. Use this when asked to update external NuGet dependencies.
dotnet-dev
GitTools
Expert guidance for .NET development in this repository. Use this skill for building, testing, debugging, and understanding project structure, coding conventions, dependency injection patterns, and testing practices.
write-ui-tests
dotnet
Creates UI tests for a GitHub issue and verifies they reproduce the bug. Iterates until tests actually fail (proving they catch the issue). Use when PR lacks tests or tests need to be created for an issue.
agui-dotnet-feature-workflow
ag-ui-protocol
>
dotnet-inspect
joslat
Query .NET APIs across NuGet packages, platform libraries, and local files. Search for types, list API surfaces, compare and diff versions, find extension methods and implementors. Use whenever you need to answer questions about .NET library contents. As of v0.7.8, [Obsolete] members are surfaced in