Github Scan Prs

Scan PRs

Overview

Dispatch the github-pr-scanner agent to find pull requests that need the user's attention across multiple GitHub repositories, fan out per-PR haiku scorers for every PR, and produce a prioritized triage report. Deep code reviews are not part of this skill — for a thorough review on any single PR in the report, the user runs /github-review-pr separately.

When to Use

Triggers: "scan PRs", "check PRs", "what PRs need attention", "PR inbox", "daily PR report".

When NOT to use

• The user already has a single PR in mind — use github-review-pr directly.
• The user wants to review their own local branch — use review-branch.
• No repositories are given and the current directory is not a git repo with a GitHub remote.

Arguments

$ARGUMENTS should be a list of GitHub repositories:

• One per line: owner/repo
• Comma-separated: owner/repo1, owner/repo2
• As URLs: https://github.com/owner/repo

If no argument is provided, detect the current repository from gh repo view --json nameWithOwner -q .nameWithOwner and use that.

Core Process

Phase 0: Setup

1. Parse $ARGUMENTS — list of GitHub repositories. If empty, resolve current repo via gh repo view --json nameWithOwner -q .nameWithOwner; if that fails, escalate via AskUserQuestion. Never guess.
2. task_name = _github_scan_prs_ where ` is today's date (underscores) and is a snake_case summary of the repo list (max 20 chars, e.g. ownerrepo or multirepo); on same-day collision append v2, v3`.
3. Create .mz/task//.
4. Write state.md with schema_version: 2, Status: running, Phase: 0, Started: , Repos: [], ScannedPRs: 0, ScoredPRs: 0.
5. Emit a visible setup block: task_name, repo list, report dir (.mz/reviews/).

1. Dispatch

1. Launch the github-pr-scanner agent with the repository list as the prompt.
2. The agent scans for PRs where the user is requested for review, mentioned, assigned, or has changes requested on their own PRs, then fans out one github-pr-info-scorer haiku agent per PR (in parallel waves of up to 6) to gather metadata, complexity signals, and unanswered-question state.
3. Every PR returned by the scan is scored into one of three tiers — Tier 1 (directly asked, unanswered), Tier 2 (review or action requested), or Tier 3 (informational) — and ranked within its tier by complexity and age.
4. After completion, display the path to the triage report at .mz/reviews/_github_scan_prs_.md (append _v2, _v3 etc. if a report with the same base name already exists).

Techniques

Techniques: delegated to the github-pr-scanner, github-pr-data-fetcher, and github-pr-info-scorer agents — see their agent definitions for bulk PR listing, per-PR haiku triage, and tier-based ranking.

Common Rationalizations

N/A — collaboration/reference skill, not discipline.

Red Flags

• You produced a triage report without scoring every PR the fetcher returned (top-N truncation is a bug here).
• You dispatched the github-pr-reviewer agent from this skill — deep reviews belong to /github-review-pr, not the triage flow.
• You let a Tier 2 or Tier 3 item outrank a Tier 1 item in the report (tier boundaries are absolute; complexity only orders within a tier).

Verification

Output the triage report path (.mz/reviews/_github_scan_prs_.md), confirm the file exists, and confirm Tier 1 items (if any) appear above Tier 2 and Tier 3 in the report. The report should end with a How to Deep-Review footer pointing users to /github-review-pr for any single PR that warrants a thorough read.

Error Handling

• Empty args with no detectable current repo → before escalating, try the fallback chain for gh repo view: (1) mcp__*github* MCP tools if exposed, (2) direct REST API (curl -fsSL -H "Authorization: Bearer $GITHUB_TOKEN" -H "Accept: application/vnd.github+json" "https://api.github.com/repos/{owner}/{repo}"). Only escalate via AskUserQuestion after all three tiers fail; never guess.
• gh unavailable (not installed, not authenticated, rate-limited) → delegate to the fallback chain before blocking. The github-pr-scanner agent has its own GitHub Access Fallback section that governs downstream calls. Only escalate via AskUserQuestion if MCP and REST tiers also fail.
• Missing tooling (Agent tool absent) → escalate via AskUserQuestion with the exact missing command.
• Empty scanner result (zero PRs returned or no priority-ranked list) → check the scanner's pr_data.md / report for ZERO RESULTS disclosure tokens before trusting:
• ZERO RESULTS VERIFIED (per-repo smoke test passed) → report "no PRs need attention" and exit cleanly.
• ZERO RESULTS UNVERIFIED or ZERO RESULTS GLOBAL → do NOT treat as a clean inbox; surface the warning in the final output and prompt the user to verify the GitHub username and repo list via AskUserQuestion before a silent "all clear" masks a real misconfiguration.
• No ZERO RESULTS token present with an empty list → retry the scan once with the same repo list; if still empty, escalate via AskUserQuestion. Malformed agent responses also retry once then escalate.
• Never guess — on any ambiguity (unresolvable repo, invalid URL, missing auth) escalate via AskUserQuestion rather than proceed silently.

State Management

State persists to .mz/task//state.md with schema_version: 2 as its first line. This is a single-dispatch skill (setup → dispatch → report in one turn), so the phase_complete / what_remains progress-ledger fields are not required. On reading a schema_version: 1 or unversioned file, add schema_version: 2 and log the upgrade.

After Phase 1 completes, update .mz/task//state.md with:

• Status: complete | complete_with_concerns | blocked | no_prs_found
• Phase: 1
• ScannedPRs: total PR count from the fetcher artifact
• ScoredPRs: count of PRs with valid github-pr-info-scorer artifacts (should equal ScannedPRs on a clean run)
• ReportPath: absolute path to the triage report

Never rely on conversation memory — the state file is the source of truth if the session is interrupted.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: DoctorMozg
• Source: DoctorMozg/claude-pipelines
• License: MIT

Install and usage instructions live in the source repository linked above.