actions-debug

Diagnose failing GitHub Actions workflows by analyzing logs and YAML configuration files.

3|Updated Jan 23, 2026
One-click install
npx skills add https://github.com/lucasilverentand/skills --skill actions-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: actions-debug
Source: https://github.com/lucasilverentand/skills/tree/main/skills/github-actions/debug
Command: npx skills add https://github.com/lucasilverentand/skills --skill actions-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps developers diagnose failing GitHub Actions workflows by analyzing logs and configuration files to surface root causes and actionable remediation steps.

Core Features & Use Cases

  • Analyze recent workflow runs to surface failures and provide actionable fixes
  • Cross-reference logs with workflow YAML to pinpoint misconfigurations
  • Identify common CI issues such as permission problems, missing secrets, timeouts, cache misses, and test failures
  • Use cases include troubleshooting flaky workflows, CI regressions, and workflow timeouts across repositories

Quick Start

Use the actions-debug skill to analyze the most recent workflow failure by running /actions-debug, /actions-debug 12345678, or /actions-debug ci.yml

Frequently Asked Questions about actions-debug

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug failing GitHub Actions workflows and CI runs?

To debug failing GitHub Actions workflows, you analyze CI logs and YAML configuration files to identify root causes. Cross-referencing run logs with workflow YAML helps pinpoint misconfigurations like permission problems, missing secrets, timeouts, and cache issues.

Why does my GitHub Actions workflow keep timing out or failing unexpectedly?

GitHub Actions workflow timeouts and unexpected failures often stem from permission issues, missing secrets, or cache problems. Analyzing the specific run logs alongside the workflow YAML configuration helps identify the exact pattern causing the failure.

What's the best way to find the root cause of flaky CI regressions in GitHub Actions?

The best way to find root causes of flaky CI regressions is to analyze recent workflow run logs using GitHub CLI commands like gh run list and gh run view. Cross-referencing these outputs with YAML configurations surfaces actionable remediation steps.

Can I use GitHub CLI to diagnose GitHub Actions test failures and permission issues?

Yes, GitHub CLI commands such as gh run list, gh run view, and log outputs can be used to diagnose GitHub Actions test failures and permission issues. These outputs are analyzed alongside YAML workflow files to pinpoint misconfigurations.

What types of GitHub Actions misconfigurations can log analysis detect in workflow YAML?

Log analysis cross-referenced with workflow YAML can detect common GitHub Actions misconfigurations including permission problems, missing secrets, cache misses, timeout triggers, and test failures, providing actionable fixes for each identified pattern.

How do I troubleshoot GitHub Actions errors when I only have a run ID or workflow file name?

To troubleshoot GitHub Actions errors with a run ID or workflow file name, use the actions-debug skill by running /actions-debug 12345678 or /actions-debug ci.yml to analyze the specific run logs and YAML configuration for that failure.