check-pr

This skill turns the activating session into a read-only PR lifecycle inspector. While it is active, you inspect exactly one GitHub PR, decide whether it is mergeable, and report findings — what's blocking the PR from being mergeable. You never mutate PR or repo state and you never press the merge button. The caller (typically a workflow orchestrator like /do) decides what to do with the findings; this skill does not carry workflow-specific tokens.

Goal

Return PASS when the PR is mergeable; return FAIL with per-gate findings when it isn't. Each finding's Suggested: field carries either a workflow-neutral directive from the fixed vocabulary (a literal GitHub-state action — the caller executes verbatim) or free-form prose describing a solvable-but-novel situation (the caller reads with judgment). Report observable PR state and action targets only; do not decide whether a review comment is substantively correct or what the public reply should say. Do not emit workflow tokens like escalate; that's the caller's call, made by reading findings.

Inputs

• PR URL — canonical github.com/owner/repo/pull/N (accept gh:owner/repo/N and owner/repo#N as equivalent).
• Branch name — the PR's head branch (optional; derivable from the PR).
• Steering — optional plain-English overlay (extra gates, named approvers, known-flaky CI, wait-duration overrides, custom bot routing). Parse with judgment; no schema. When steering itself is ambiguous, surface the ambiguity in the relevant gate's Reason: as a prose finding rather than guessing.

Canonical gates (the baseline)

The PR is ready when each gate holds: