Diagnose and fix GitHub Actions workflow failures, CI/CD pipeline issues, YAML syntax errors, and workflow configuration problems. Use when debugging failed CI runs, fixing workflow errors, or optimizing GitHub Actions. Keywords: github actions, CI, workflow, pipeline, yml, yaml, actions failure, CI failure, workflow error
Diagnoses and fixes GitHub Actions workflow failures and configuration issues.
When activated, follow this systematic troubleshooting approach:
Get workflow status:
gh run list --limit 5 # Recent runs
gh run view <run-id> # Specific run details
gh run view <run-id> --log-failed # Failed job logs only
Analyze the failure:
name, on, jobs)Fix approach:
Fix approach:
# Pin versions explicitly
- uses: actions/setup-node@v4
with:
node-version: "20"
cache: "pnpm"
Fix approach:
GITHUB_TOKEN insufficient permissionsFix approach: