dbmrq/agent-skills/ci-watcher

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

1. Check status using the check_ci.sh script or gh run list
2. On success: Report and continue
3. 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?"

Prerequisites

• GitHub CLI (gh) installed, authenticated, and able to read the repo's workflow runs
• jq for the bundled scripts/check_ci.sh