| name | github-actions-debugging |
| description | Guide for debugging failing GitHub Actions workflows. Use this when asked to debug failing GitHub Actions workflows. |
GitHub Actions Debugging
This skill helps you debug failing GitHub Actions workflows in pull requests.
Process
- Use the
list_workflow_runs tool to look up recent workflow runs for the pull request and their status
- Use the
summarize_job_log_failures tool to get an AI summary of the logs for failed jobs
- If you need more information, use the
get_job_logs or get_workflow_run_logs tool to get the full failure logs
- Try to reproduce the failure locally in your environment
- Fix the failing build and verify the fix before committing changes
Common issues
- Missing environment variables: Check that all required secrets are configured
- Version mismatches: Verify action versions and dependencies are compatible
- Permission issues: Ensure the workflow has the necessary permissions
- Timeout issues: Consider splitting long-running jobs or increasing timeout values