| name | wait-for-ci |
| description | Block until CI passes or fails on the current PR. Use this skill every time you push a commit and intend to tell the user the work is done — never present a pushed commit as complete without first confirming CI is green. Also use it when waiting on CI before merging, deploying, or moving on to the next task in a multi-step plan.
|
| user-invocable | true |
Wait for CI
Sequencing Checklist
Block until all GitHub Actions CI checks pass or fail on the current PR.
Prerequisites
IMPORTANT: Check every prerequisite below BEFORE doing any work. If any check fails, stop immediately, tell the user which prerequisite is not met, and ask them to fix it. Do NOT proceed, improvise, or attempt workarounds.
- The
gh CLI must be installed and authenticated (gh auth status must succeed)
- You must be on a branch with an open PR (
gh pr view must succeed)
Usage
Run this single blocking command:
gh pr checks --watch --fail-fast
- Blocks until all checks complete
- Exits 0 if all checks pass
- Exits non-zero and stops early (
--fail-fast) if any check fails
When no checks are reported
If gh pr checks returns immediately with "no checks reported", CI hasn't started yet. Wait briefly and retry:
sleep 30 && gh pr checks --watch --fail-fast
If after 2 retries (~1 minute) there are still no checks, diagnose:
- Merge conflicts — resolve them, push, then retry the wait.
- No matching workflow triggers — confirm the repo's
.github/workflows/ files actually trigger on this PR's conditions (push, pull_request, path filters, etc.). If nothing should trigger, CI can be considered green.
- GitHub outage — check https://www.githubstatus.com. If GitHub Actions is degraded, let the user know and bail out.
Integrating into your workflow
This skill is designed to be invoked after pushing commits to a PR, so that Claude can block and wait for the result before proceeding. Typical sequence:
- Make changes and commit
- Push to the PR branch
- Invoke
/wait-for-ci
- If CI passes, continue with next steps (e.g. merge, deploy)
- If CI fails, read the failing check logs with
gh run view <run-id> --log-failed and fix