vigillisted
Install: claude install-skill Udhay-Adithya/skills
# Vigil
Keep watch over a pull request until it is ready. Many repositories have AI review
bots. They are helpful, even when they are not right.
## Waiting
Never write a watcher, a polling loop or a `sleep` loop. Use one watcher per PR, and
never two on the same PR. Every watcher on a GitHub account shares one rate limit.
### In the Claude Code desktop app
The app watches PRs itself. Handle the existing checks and comments first, then bind
the PR with the PR tools and turn on Auto-fix. The app wakes the session when a check
fails, the branch conflicts, or a review comment arrives, so do not also start
`pr-wait`, and never schedule or poll checks by hand.
Auto-fix covers CI failures, conflicts and review comments. It does not decide whether
to merge. Check the gate yourself.
### Everywhere else: `pr-wait`
Wait with `scripts/pr-wait` from this skill's directory, by its absolute path.
```bash
pr-wait <pr> [--repo owner/name] [--until ready|green|any-change]
```
It prints one line per real event. It exits 0 when the `--until` condition is met or
the PR merges, 1 when it needs attention (a required check failed, conflicts,
unresolved threads, PR closed), and 2 on bad input.
- `ready` (default): required checks green, a review bot has reviewed the head, and no
unresolved threads. Use this to keep watch.
- `green`: required checks only. Use it where the repository has no review bot.
- `any-change`: exit on the first event.
In Claude Code, run it with the Monitor tool (