gh-healthcheck

Diagnose GitHub Actions workflow health and identify root causes from runs, logs, and configuration.

7.5k|1.8k|Updated Nov 10, 2013
One-click install
npx skills add https://github.com/FastLED/FastLED --skill gh-healthcheck
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gh-healthcheck
Source: https://github.com/FastLED/FastLED/tree/main/.claude/skills/gh-healthcheck
Command: npx skills add https://github.com/FastLED/FastLED --skill gh-healthcheck

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identify and report root-cause issues in GitHub Actions workflow health to shorten incident response and improve CI reliability.

Core Features & Use Cases

  • Root Cause Analysis: Groups failures by category (e.g., Missing Headers, Linker Errors, Platform Issues) to prioritize fixes.
  • Detail Levels: Supports low, medium, and high detail levels to balance speed and insight.
  • Recommendations: Provides actionable remediation steps and prevention guidance for future runs.
  • Integration: Works with standard GitHub Actions workflows to analyze recent runs and configurations.

Quick Start

Run the health check tool against your workflow by executing uv run ci/tools/gh/gh_healthcheck.py with the appropriate arguments.

Frequently Asked Questions about gh-healthcheck

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

FAQPage Schema
How do I diagnose root causes of GitHub Actions workflow failures?

GitHub Actions workflow health is diagnosed by analyzing recent runs, logs, and configuration to surface failures and misconfigurations. It groups errors by category to prioritize fixes and shorten incident response times.

Can I adjust the detail level when analyzing CI pipeline health?

Yes, you can configure low, medium, or high detail levels when analyzing CI pipeline health. This balances processing speed against the depth of insight provided for your workflow runs and performance regressions.

What is the best way to identify performance regressions in GitHub Actions?

Identifying performance regressions in GitHub Actions involves analyzing recent workflow runs and configurations. A health check surfaces these regressions and provides actionable remediation steps to improve CI reliability.

Does the GitHub Actions health check provide recommendations for preventing future CI failures?

Yes, the GitHub Actions health check provides actionable remediation steps and prevention guidance for future runs. It analyzes workflow configurations to surface misconfigurations and recommends fixes to improve CI reliability.

How do I run a GitHub Actions health check from the command line?

To run a GitHub Actions health check from the command line, execute the Python-based tool using uv run ci/tools/gh/gh_healthcheck.py with the appropriate arguments for your workflow analysis.