github-actions-failure-debugging

JohnnyVicious's avatarfrom JohnnyVicious

Guide for debugging failing GitHub Actions workflows. Use this when asked to debug failing GitHub Actions workflows.

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 3, 2026⬇️1downloads
[CI and CD]

When & Why to Use This Skill

This Claude skill provides a streamlined, AI-powered approach to debugging failing GitHub Actions workflows. By integrating with GitHub MCP tools, it automates the process of monitoring workflow statuses and summarizing complex job logs, allowing developers to quickly identify root causes and fix CI/CD pipeline issues without manually sifting through thousands of lines of logs.

Use Cases

  • Identifying the root cause of failed builds in Pull Requests by analyzing recent workflow runs and statuses.
  • Summarizing massive job logs into concise, actionable insights to pinpoint specific compilation or test errors.
  • Retrieving detailed failure logs for deep-dive technical analysis when high-level summaries require more context.
  • Accelerating the debugging cycle by providing structured steps to reproduce and verify fixes for CI/CD failures locally.
namegithub-actions-failure-debugging
descriptionGuide 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:

  1. Use the list_workflow_runs tool to look up recent workflow runs for the pull request and their status
  2. Use the summarize_job_log_failures tool 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
  3. If you still need more information, use the get_job_logs or get_workflow_run_logs tool to get the full, detailed failure logs
  4. Try to reproduce the failure yourself in your own environment.
  5. Fix the failing build. If you were able to reproduce the failure yourself, make sure it is fixed before committing your changes.