gh-healthcheck

SkillDev tools

Lets your agent check the health of GitHub Actions workflows and explain why they fail.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the gh-healthcheck skill

About this capability

Run health check on GitHub Actions workflow with root cause analysis and recommendations. Use for quick CI status overview and pattern analysis.

What this skill tells your AI

The instructions your AI receives, as published by fastled/fastled in .claude/skills/gh-healthcheck/SKILL.md and read by ahel’s review.

Analyze GitHub Actions workflow health and provide a comprehensive diagnostic report.

Arguments: $ARGUMENTS

Run the health check tool:

uv run ci/tools/gh/gh_healthcheck.py $ARGUMENTS

Features

Root Cause Analysis: Groups errors by category (Missing Headers, Linker Errors, Platform Issues, etc.)

Detail Levels:

  • low: Summary only, no log fetching (fast)
  • medium: Fetches logs and categorizes errors (default)
  • high: Full error details with context

Usage Examples

  • Check latest: uv run ci/tools/gh/gh_healthcheck.py
  • Specific run: uv run ci/tools/gh/gh_healthcheck.py --run-id 18399875461
  • High detail: uv run ci/tools/gh/gh_healthcheck.py --detail high

Comparison with /gh-debug

  • gh-healthcheck: Overview and analysis of entire workflow
  • gh-debug: Deep dive into specific run with full error context

Signals

GitHub stars
7k
Forks
2k
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
gh-healthcheck
Source
github.com/fastled/fastled