---
name: watch-ci
description: Monitor GitHub Actions CI status for the current branch, waiting until checks pass or fail. Use when user says "/watch-ci", "watch ci", "wait for ci", or "monitor ci".
tools: Bash
---

# watch-ci

Monitor GitHub Actions CI status for the current branch, waiting until all checks pass or fail.

## Steps

### 1. Run the watch script

Run `${CLAUDE_PLUGIN_ROOT}/scripts/watch-ci.sh` and wait for it to exit. It auto-detects the current branch, checks for a PR first (using `gh pr checks --json`), and falls back to workflow runs if no PR exists. It polls every 10 seconds by default. To use a custom interval, pass it as the first argument (e.g., `watch-ci.sh 30`). Minimum is 5 seconds.

If `CLAUDE_PLUGIN_ROOT` is not set, find the script relative to this SKILL.md (`../../scripts/watch-ci.sh`).

### 2. Report the result

When the script exits:
- **Exit code 0** means all checks passed. Report success.
- **Non-zero exit** means checks failed. The script will have printed failure logs. Summarize the failures for the user.

If the user wants to investigate failures, offer to:
- Read the failure logs in detail
- Open the GitHub Actions run URL
- Help fix the failing code

## Important notes

- This skill just monitors — it does not push, commit, or modify code.
- If no CI runs are found, suggest the user push their branch first.
- The script exits automatically when checks complete. Do not kill it early unless the user asks.