watch-pr

# Watch a pull request Wait for the checks on a pull request to settle, then say what happened. This skill ends when the checks stop moving. Fixing what failed belongs to `fix-pr`, and merging belongs to `merge-pr`. A guard hook runs alongside and refuses the watching forms this skill wraps, so a hand-rolled poll can't quietly replace the watcher. A plain `gh pr checks` for a one-off look stays open. ## Which pull request `$ARGUMENTS` names the pull request number when the caller knows it. An empty value means whatever is open for the current branch. ## Step 1: watch Arm the watcher through the `Monitor` tool, which turns each line the script prints into a notification: ```text Monitor({ command: "bash .claude/skills/watch-pr/scripts/watch-checks.sh <number>", description: "checks on pull request <number>", timeout_ms: 1800000, persistent: false, }) ``` Omit the number to use the current branch's open pull request. `Monitor` is the right tool rather than a blocking call, because the script emits one line per check the moment that check settles. A failure arrives while the slower jobs are still going, so the diagnosis starts earlier and no turn goes to waiting. The script exits once nothing is pending, which ends the watch by itself. Never poll `gh pr checks` in a loop of your own. Each look costs a turn and reports a state that has already moved on. The lines to expect: - `WATCHING #<number>` once, at the start - `PASS <job>`, `SKIP <job>`, or `FAIL <job> ...