# Watch Uat Github Pr

> Watch a GitHub UAT PR for maintainer feedback or approval by polling comments until approved/passed. Use when this capability is needed.

- Skill: `tomevault-io/watch-uat-github-pr` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/watch-uat-github-pr`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/watch-uat-github-pr/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/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)

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/oocx) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->