skills.rest
oliver-kriska
oliver-kriskaCOMMUNITY
Explore all skills by this author →
Website𝕏@quatermain32GitHub

phx-watch-pr

Watches GitHub pull requests for new reviews, comments, and CI results via a background event watcher.

537|38|Updated Feb 12, 2026
Search Tags:#gh CLI#gitHub#CODEX#ci monitoring#background watcher#Code review#Pull request
One-click install
npx skills add https://github.com/oliver-kriska/claude-elixir-phoenix --skill phx-watch-pr
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: phx-watch-pr
Source: https://github.com/oliver-kriska/claude-elixir-phoenix/tree/main/targets/codex/skills/phx-watch-pr
Command: npx skills add https://github.com/oliver-kriska/claude-elixir-phoenix --skill phx-watch-pr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Waiting on pull request feedback normally means either manually refreshing GitHub or running foreground polling loops that flood the AI session with raw API output and burn context. This Skill runs a quiet background watcher that only surfaces genuinely new events — reviews, comments, CI conclusions, and Codex bot signals — so nothing enters context until something actually changed.

Core Features & Use Cases

  • Background PR watching: Polls reviews, comments, and check status in a separate process, emitting one-line events only for new activity since a baseline timestamp.
  • CI-only mode: Delegates to gh pr checks --watch when you only need to know whether checks pass or fail after a push.
  • Codex review loop: Optionally posts @codex review triggers, detects bot acknowledgements and clean passes via reactions, and manages bounded re-review rounds.
  • Use Case: After opening a PR on an Elixir/Phoenix project, start the watcher and keep working; when a reviewer comments or CI fails, the event arrives and routes to the appropriate fix or investigation workflow.

Quick Start

Ask the AI to watch pull request number 42 for new reviews, comments, and CI results using the phx-watch-pr skill.

Frequently Asked Questions about phx-watch-pr

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I watch a GitHub PR for new review comments?▼

Run the watcher with the PR number, for example `phx-watch-pr 42`, and it polls reviews, comments, and checks in a background process. Only genuinely new events since the baseline timestamp are emitted as one-line events, so nothing floods your context while waiting.

How to wait for GitHub CI checks to finish after pushing?▼

Use the `--checks-only` flag, which delegates to `gh pr checks --watch --fail-fast`. The command blocks until all checks finish and exits with 0 for pass, 1 for fail, or 8 for pending, and the exit code itself is the signal.

Does the PR watcher work with the Codex GitHub connector?▼

Yes, the `--codex` flag posts an `@codex review` trigger comment and polls the connector bot's reactions: eyes means the review is in flight and +1 means a clean pass. Rounds are capped by `--codex-rounds` (default 3) and the watch duration extends to 7200 seconds.

Why avoid foreground sleep loops when polling GitHub?▼

Foreground polling dumps full gh JSON into the conversation on every cycle and straddles the 5-minute prompt cache TTL, forcing expensive context reloads. A background watcher keeps the session idle with near-zero token cost until a real event arrives.

What happens if the PR watcher loses access or the PR closes?▼

The watcher always emits a terminal event: `merged` or `pr_closed` when the PR leaves the open state, `watchdog` at the maximum duration, and `watch_error` after five consecutive gh failures. Silence is never treated as success.

Related Skills

Explore More Software Engineering Skills→
assertchrisassertchris
2

custom-submit-pr

Create a GitHub pull request with the gh CLI and assign it to assertchris.

Community
Intermediate
herren-officialherren-official

b2b-backend-reply

Generate draft replies to unaddressed GitHub PR review comments.

Official
Advanced
citypaulcitypaul
723

ci-debugging

Diagnose CI pipeline failures using hypothesis-first investigation and environment delta analysis.

Community
Intermediate
gmliaogmliao
1

reply-pr-comment

Reply to GitHub PR comment threads using the GitHub CLI.

Community
Basic