Monitor CI
UTILITY SKILL. INVOKES: gh; fix-pr-until-green only when repair is authorized and the caller did not require gated-trigger/Codex-before-CI behavior.
Read monitoring policy before polling, cancelling, rerunning, or classifying failures.
USE FOR:
- Watching Actions on an existing PR.
- Monitoring an already-pushed branch.
- Reporting CI as
passing, pending, not_ready, or blocked.
DO NOT USE FOR:
- Opening or refreshing a PR.
- Fixing CI without repair authorization.
- Cancelling or rerunning Actions without authorization.
Workflow
- Resolve the PR or pushed branch. Prefer a provided PR; otherwise use the current branch PR, then branch runs.
- Capture remote head SHA and report unpushed commits.
- Inspect checks with
gh pr checks, gh pr view, gh run list, and gh run view.
- Poll bounded sleeps. Pending stays pending; unchanged red required checks, including unrelated or locally reproducible failures outside the watched branch, stay
not_ready while watching can continue.
- With repair authorization and no gated-trigger requirement, delegate actionable branch-caused failures to
fix-pr-until-green. In monitor gated-trigger mode, return the failing check, logs, URLs, and actionable files instead of committing repairs.
- If repair changes the head, capture the new SHA and restart.
Troubleshooting
- Missing tools, auth, status, logs, permissions, or required judgment is
blocked.
- Shards running 30 minutes follow the reference policy.
Examples
- PR or branch watch -> monitor checks.
- "Commit and monitor" -> top-level
monitor passes repair context.
Output
Return target, monitored head SHA, CI state, failing checks and URLs, repair status, and latest head SHA if changed.
1---2name: monitor-ci3description: Monitor GitHub Actions for an existing PR or pushed branch until CI is passing, pending/not_ready, or blocked. Use for "watch CI", "monitor GitHub Actions", "watch checks", "monitor this PR's Actions", or CI handoff from monitor. Do not use to open PRs or independently repair CI; in monitor gated-trigger mode, return actionable failure evidence so monitor can repair before another empty `#CI` trigger commit.4---56# Monitor CI78**UTILITY SKILL. INVOKES:** `gh`; `fix-pr-until-green` only when repair is authorized and the caller did not require gated-trigger/Codex-before-CI behavior.910Read [monitoring policy](references/monitoring-policy.md) before polling, cancelling, rerunning, or classifying failures.1112## USE FOR:1314- Watching Actions on an existing PR.15- Monitoring an already-pushed branch.16- Reporting CI as `passing`, `pending`, `not_ready`, or `blocked`.1718## DO NOT USE FOR:1920- Opening or refreshing a PR.21- Fixing CI without repair authorization.22- Cancelling or rerunning Actions without authorization.2324## Workflow25261. Resolve the PR or pushed branch. Prefer a provided PR; otherwise use the current branch PR, then branch runs.272. Capture remote head SHA and report unpushed commits.283. Inspect checks with `gh pr checks`, `gh pr view`, `gh run list`, and `gh run view`.294. Poll bounded sleeps. Pending stays pending; unchanged red required checks, including unrelated or locally reproducible failures outside the watched branch, stay `not_ready` while watching can continue.305. With repair authorization and no gated-trigger requirement, delegate actionable branch-caused failures to `fix-pr-until-green`. In monitor gated-trigger mode, return the failing check, logs, URLs, and actionable files instead of committing repairs.316. If repair changes the head, capture the new SHA and restart.3233## Troubleshooting3435- Missing tools, auth, status, logs, permissions, or required judgment is `blocked`.36- Shards running 30 minutes follow the reference policy.3738## Examples3940- PR or branch watch -> monitor checks.41- "Commit and monitor" -> top-level `monitor` passes repair context.4243## Output4445Return target, monitored head SHA, CI state, failing checks and URLs, repair status, and latest head SHA if changed.
willakins