Run health check on GitHub Actions workflow with root cause analysis and recommendations. Use for quick CI status overview and pattern analysis.
Install with the open skills CLI (global, non-interactive — available in every Claude Code session):
npx skills add FastLED/FastLED --skill "gh-healthcheck" -g -a claude-code -yOr manually — copy the SKILL.md below into:
~/.claude/skills/gh-healthcheck-fastled-2/SKILL.md---
name: gh-healthcheck
description: Run health check on GitHub Actions workflow with root cause analysis and recommendations. Use for quick CI status overview and pattern analysis.
argument-hint: [--workflow build.yml] [--run-id <id>] [--detail low|medium|high]
context: fork
---
Analyze GitHub Actions workflow health and provide a comprehensive diagnostic report.
Arguments: $ARGUMENTS
Run the health check tool:
```bash
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
Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies
Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes
Use when implementing any feature or bugfix, before writing implementation code