github-actions-failure-debugging
Provides a structured process to debug and fix failing GitHub Actions workflows in pull requests.
Install
mkdir -p .claude/skills/github-actions-failure-debugging && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/6065" && unzip -o skill.zip -d .claude/skills/github-actions-failure-debugging && rm skill.zipInstalls to .claude/skills/github-actions-failure-debugging
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Guide for debugging failing GitHub Actions workflows. Use this when asked to debug failing GitHub Actions workflows.Key capabilities
- →List recent workflow runs for pull requests
- →Summarize job log failures using AI
- →Retrieve full logs for failed jobs
- →Facilitate local reproduction of failures
How it works
It uses GitHub MCP tools to list runs, summarize log failures, and retrieve full logs to identify and fix CI/CD pipeline errors.
Inputs & outputs
When to use github-actions-failure-debugging
- →Debug CI/CD pipeline failures
- →Summarize GitHub Actions logs
- →Identify failing build steps
About this skill
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.
When not to use it
- →When debugging non-GitHub Actions workflows
- →When the issue is not related to CI/CD pipeline failures
Prerequisites
Limitations
- →Requires access to GitHub MCP Server
- →Limited to GitHub Actions workflows
How it compares
It provides an automated summary of failures to avoid manual log parsing, followed by a structured debugging process.
Compared to similar skills
github-actions-failure-debugging side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| github-actions-failure-debugging (this skill) | 1 | 6mo | No flags | Intermediate |
| gha | 1 | 6mo | No flags | Intermediate |
| github-actions-templates | 7 | 3mo | No flags | Intermediate |
| toolhive-release | 1 | 3mo | Review | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
You might also like
gha
ykdojo
Analyze GitHub Actions failures and identify root causes
github-actions-templates
wshobson
Create production-ready GitHub Actions workflows for automated testing, building, and deploying applications. Use when setting up CI/CD with GitHub Actions, automating development workflows, or creating reusable workflow templates.
toolhive-release
stacklok
Creates ToolHive release PRs by analyzing commits since the last release, categorizing changes, recommending semantic version bump type (major/minor/patch), and triggering the release workflow. Use when cutting a release, preparing a new version, checking what changed since last release, or when the user mentions "release", "version bump", or "cut a release".
ci-test-failures
dotnet
Guide for diagnosing and fixing CI test failures using the DownloadFailingJobLogs tool. Use this when asked to investigate GitHub Actions test failures, download failure logs, or debug CI issues.
ship
wilsonfaustino
Push current branch and create or update a GitHub PR with an intent-driven description. Use when the user says "ship", "ship it", "create PR", "push and PR", or wants to push their branch and open a pull request. Runs pre-flight safety checks, pushes to remote, and generates PR title/body from branc
upgrade-deps
obot-platform
Upgrade dependencies and runtimes safely, run CI, and report higher-risk options.