ci-pr-monitorlisted
Install: claude install-skill IgorGanapolsky/mac-yolo-safeguards
# CI-PR Monitor Skill
Use this skill whenever you need to verify GitHub Actions CI check status,
track PR merge-readiness, or confirm auto-merge success.
## Quick Commands
| Action | Command |
|--------|---------|
| List all checks for a PR | `gh pr checks <PR_NUM>` |
| JSON status of a PR | `gh pr view <PR_NUM> --json state,mergeable,mergeStateStatus` |
| Get required status contexts | `gh api repos/<owner>/<repo>/branches/<branch>/protection --jq '.required_status_checks.contexts[]'` |
| Enable auto-merge (squash) | `gh pr merge <PR_NUM> --auto --squash` |
| Wait for a specific check | `gh pr checks <PR_NUM> --watch` |
| Get workflow runs for a branch | `gh api repos/<owner>/<repo>/actions/workflows/<workflow>/runs --jq '[.workflow_runs[] \| select(.head_branch=="<branch>")]'` |
## Decision Flow
1. **Check current status:** `gh pr checks <PR> --json name,state,conclusion`
2. **Classify results:**
- `pass` / `SUCCESS` → check is green
- `pending` → still running, wait
- `fail` / `FAILURE` → investigate the failing step
- `skipping` → not applicable to this change
3. **Required checks only:** Compare against the protected-branch required contexts.
Non-required checks (e.g., macOS runners, mobile E2E) that remain pending
should NOT block merge if all required checks are green.
4. **Auto-merge:** If `mergeable: MERGEABLE` and `mergeStateStatus: CLEAN`,
run `gh pr merge <PR> --auto --squash`. GitHub will queue the merge for
when all required checks c