| name | monitor-pr |
| description | Monitor a pull request until CI status or Copilot review is available. Use when: monitor PR, watch PR, land PR, wait for CI, wait for checks, wait for review, check PR status. Starts two async terminal tasks (CI + Copilot review) and reacts when either completes. |
Monitor PR
Monitor a pull request by running two scripts in async terminals: one that waits for a Copilot code review, and one that waits for CI to finish. When either terminal exits, the host's async-terminal runtime notifies the agent on its next turn, so the agent can react without polling.
Host requirement: this skill assumes the agent host can run long-lived background terminals and notify the agent when they exit — for example, VS Code Chat's run_in_terminal with mode=async plus get_terminal_output / kill_terminal. Hosts without that capability will need to adapt the procedure (e.g. foreground the scripts and block on them).
When to Use
- After creating a PR and you want to wait for CI and Copilot's review
- When the user says "land this PR", "watch this PR", "monitor CI", or "wait for checks"
Prerequisites
gh CLI installed and authenticated.- An active PR — created earlier in the conversation, or supplied by the user as a number or URL.
Procedure
1. Identify the PR
Extract the PR number from the conversation context. Determine the repo with:
gh repo view --json nameWithOwner -q .nameWithOwner
2. Start Two Async Terminals
Run BOTH of these scripts in separate async terminals (mode=async on run_in_terminal, or your host's equivalent). Use a small timeout, such as , so the tool returns quickly after the monitor process starts. Do NOT await them and do NOT poll or sleep; the runtime will notify you on a later turn when each script exits.
