# Watch Uat Github Pr

> Watch UAT PR (GitHub)

- Skill: `oocx/watch-uat-github-pr` (Agent Skill)
- Install (CLI): `npx skillmds@latest add oocx/watch-uat-github-pr`
- Raw SKILL.md: https://api.skillmd.com/api/skills/oocx/watch-uat-github-pr/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: oocx (https://skillmd.com/u/oocx)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/oocx/watch-uat-github-pr

---


# Watch UAT PR (GitHub)

## Purpose

UAT comment polling is historically brittle. This skill standardizes the watch loop so the agent can reliably wait for Maintainer feedback/approval.

Preferred: use GitHub chat tools to poll PR state + comments (avoids terminal output/pager issues).
Fallback: use the stable wrapper command.

Fallback path uses the repo wrapper script `scripts/uat-watch-github.sh`, which repeatedly calls `scripts/uat-github.sh poll` until:

- approval keywords are detected, or
- the PR is closed/merged, or
- a timeout is reached.

## Hard Rules

### Must

- Use `scripts/uat-watch-github.sh` (single stable command).
- Treat any detected approval (`approved|passed|accept|lgtm`) as UAT passed.
- Stop watching and report when the PR is closed.

### Must Not

- Spam comments or post follow-ups while waiting.
- Run many ad-hoc `gh` commands; prefer the wrapper.

## Actions

### Preferred: Poll using GitHub chat tools

Repeatedly:

- Fetch PR details (state)
- Fetch PR conversation comments
- Stop and report if the PR is closed/merged
- Treat any detected approval (`approved|passed|accept|lgtm`) as UAT passed

### Fallback: One-command wrapper

### 1. Watch the PR

```bash
scripts/uat-watch-github.sh <pr-number>
```

### 2. Optional: Tune polling interval / timeout

```bash
scripts/uat-watch-github.sh <pr-number> --interval-seconds 60 --timeout-seconds 3600
```

## Output

- Exit code `0`: approval detected or PR closed (treat as pass)
- Exit code `1`: timed out (treat as incomplete; ask Maintainer)