github-actions-ci

name	github-actions-ci
description	Check GitHub Actions CI status after pushing changes. Triggers after `git push` in projects with a `.github/workflows` directory. For Xcode Cloud builds (iOS/macOS projects without .github/workflows), use the xcode-cloud-ci skill instead.

GitHub Actions CI Watcher

After performing a git push in a project with .github/workflows, check CI status.

Note: This skill is for GitHub Actions only. For Xcode Cloud builds, use the xcode-cloud-ci skill.

Workflow

1. After pushing, wait before checking (CI needs time to start)
2. Determine polling strategy based on project:
   • Small projects / fast CI: wait 30-60s initially, poll every 15-30s
   • Large projects / slow CI: wait 2-5min initially, poll every 30-60s
   • Consider workflow file complexity, project size, and any prior knowledge
3. Check status using the check_ci.sh script or gh run list
4. On success: Report and continue
5. On failure: Fetch logs, analyze the error, propose a fix, and ask user if they want it implemented

Checking Status

Use the bundled script:

scripts/check_ci.sh              # Check once
scripts/check_ci.sh --wait 300   # Poll for up to 5 minutes

Or directly with gh CLI:

# List recent runs for current branch
gh run list --branch $(git branch --show-current) --limit 1

# View failed logs
gh run view <run-id> --log-failed

On Failure

1. Fetch failure logs: gh run view <run-id> --log-failed
2. Analyze the error and identify root cause
3. Propose a specific fix with code changes
4. Ask: "CI failed due to [reason]. I can fix this by [solution]. Should I implement this fix?"