name: github-actions-failure-debugging description: Guide for debugging failing GitHub Actions workflows. Use this when asked to debug failing GitHub Actions workflows.
To debug failing GitHub Actions workflows in a pull request, follow this process, using tools provided from the GitHub MCP Server:
- Use the
list_workflow_runstool to look up recent workflow runs for the pull request and their status - Use the
summarize_job_log_failurestool to get an AI summary of the logs for failed jobs, to understand what went wrong without filling your context windows with thousands of lines of logs - If you still need more information, use the
get_job_logsorget_workflow_run_logstool to get the full, detailed failure logs - Try to reproduce the failure yourself in your own environment.
- Fix the failing build. If you were able to reproduce the failure yourself, make sure it is fixed before committing your changes.